文档

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

更新时间:

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

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
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 存储对象列表。

object

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>

规则列表。

object
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,
  "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-06-03OpenAPI 返回结构发生变更查看变更详情
2023-09-25OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情