全部产品
Search

搜索本产品

    数据安全中心：DescribeOssObjects - 查询OSS的存储对象列表

    文档中心

    数据安全中心：DescribeOssObjects - 查询OSS的存储对象列表

    更新时间：Feb 27, 2024

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

    调试

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

    授权信息

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

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

    请求参数

    名称类型必填描述示例值
    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
    Itemsobject []

    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
    RuleListobject []

    规则列表。

    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

    示例

    正常返回示例

    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"
    }
  ]
}

    错误码

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

    变更历史

    变更时间变更内容概要操作
    2023-09-25OpenAPI 入参发生变更、OpenAPI 返回结构发生变更看变更集
    变更项变更内容
    入参OpenAPI 入参发生变更。
      新增入参：FileCategoryCode
    出参OpenAPI 返回结构发生变更。