DescribeOssObjects - 查询OSS的存储对象列表

调用本接口查询连接授权的OSS的存储对象列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sddp:DescribeOssObjectsget
  • 全部资源
    *

请求参数

名称类型必填描述示例值
Langstring

请求和接收消息的语言类型。取值:

  • zh:中文。
  • en:英文。
zh
Namestring

搜索的关键词,支持模糊匹配。

test
RiskLevelIdinteger

OSS 存储对象的风险等级 ID。取值:

  • 1:N/A:未识别到敏感数据。
  • 2:S1:1 级敏感数据。
  • 3:S2:2 级敏感数据。
  • 4:S3:3 级敏感数据。
  • 5:S4:4 级敏感数据。
2
RuleIdlong

OSS 存储对象命中的敏感数据识别规则 ID。

说明 如果根据 OSS 存储对象命中的敏感数据识别规则的 ID 查询 DSC 连接授权的 OSS 的存储对象列表,敏感数据识别规则 ID 可调用 DescribeRules 接口获取。
1222
InstanceIdstring

OSS 对象所属资产实例 ID。

说明 如果根据 OSS 对象所属资产实例的 ID 查询 DSC 连接授权的 OSS 的存储对象列表,资产实例 ID 可调用 DescribeInstances 接口获取。
ins-2222
PageSizeinteger

列表每页显示的数据最大条数。

12
CurrentPageinteger

分页查询时的页码。

1
ServiceRegionIdstring

资产所在的地域。

cn-hangzhou
LastScanTimeStartlong

最后一次扫描开始时间。格式:时间戳。单位:毫秒。

1536751124000
LastScanTimeEndlong

最后一次扫描结束时间。格式:时间戳。单位:毫秒。

1536751124000
TemplateIdlong

行业模版 ID

1
FileCategoryCodelong

文件分类编码。

1

返回参数

名称类型描述示例值
object
CurrentPageinteger

结果中当前页的页码。

1
RequestIdstring

结果的请求 ID。

769FB3C1-F4C9-42DF-9B72-7077A8989C13
PageSizeinteger

结果中每页显示的数据条数。

12
TotalCountinteger

结果中数据的总条数。

1
Itemsarray<object>

OSS 存储对象列表。

Columnobject

OSS 存储对象列表。

InstanceIdlong

OSS 存储对象所属资产实例 ID。

1232122
CategoryNamestring

文件类型名称。

MP4视频文件
RiskLevelIdlong

OSS 存储对象的风险等级 ID。取值:

  • 1:N/A:未识别到敏感数据。
  • 2:S1:1 级敏感数据。
  • 3:S2:2 级敏感数据。
  • 4:S3:3 级敏感数据。
  • 5:S4:4 级敏感数据。
2
RegionIdstring

OSS 存储对象所有者所属区域 ID。

cn-***
FileIdstring

OSS 存储文件 ID。

file-22***
Sizelong

文件大小。单位:字节。

20
BucketNamestring

Bucket 名称。

oss-duplicate-***
RiskLevelNamestring

OSS 存储对象的风险等级名称。

中等风险等级
Categorylong

OSS 存储对象类型。取值:900001(MP4 视频文件)、800015(PDF 文档)、800005(OSS 配置文件)等。

900001
Namestring

OSS 存储对象名称。

obj_id
RuleCountinteger

命中规则数量。

100
SensitiveCountinteger

命中字段数量。

50
Idstring

OSS 存储对象的唯一标识 ID。

17383
RuleListarray<object>

规则列表。

Ruleobject
Namestring

搜索的关键词,支持模糊匹配。

身份证
RiskLevelIdlong

OSS 存储对象的风险等级 ID。取值:

  • 1:N/A:未识别到敏感数据。
  • 2:S1:1 级敏感数据。
  • 3:S2:2 级敏感数据。
  • 4:S3:3 级敏感数据。
  • 5:S4:4 级敏感数据。
2
Countlong

规则的命中次数。

100
FileCategoryCodelong

文件分类编码。

1
FileCategoryNamestring

文件分类名称。

text file
LastModifiedTimelong

上一次修改文件的时间。

1536751124000

示例

正常返回示例

JSON格式

{
  "CurrentPage": 1,
  "RequestId": "769FB3C1-F4C9-42DF-9B72-7077A8989C13",
  "PageSize": 12,
  "TotalCount": 1,
  "Marker": "",
  "NextMarker": "",
  "Truncated": true,
  "Items": [
    {
      "InstanceId": 1232122,
      "CategoryName": "MP4视频文件",
      "RiskLevelId": 2,
      "RegionId": "cn-***",
      "FileId": "file-22***",
      "Size": 20,
      "BucketName": "oss-duplicate-***",
      "RiskLevelName": "中等风险等级",
      "Category": 900001,
      "Name": "obj_id",
      "RuleCount": 100,
      "SensitiveCount": 50,
      "Id": "17383",
      "RuleList": [
        {
          "Name": "身份证",
          "RiskLevelId": 2,
          "Count": 100
        }
      ],
      "FileCategoryCode": 1,
      "FileCategoryName": "text file",
      "LastModifiedTime": 1536751124000
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-08-13OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情
2024-06-03OpenAPI 返回结构发生变更查看变更详情
2023-09-25OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情