调用ListOssBucketScanInfo接口查询OSS Bucket风险信息列表-云安全中心-阿里云-云安全中心(Security Center)-阿里云帮助中心

查询Bucket的风险信息列表。

调试

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

授权信息

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

请求参数

名称	类型	必填	描述	示例值
CurrentPage	integer	是	指定分页查询时，当前页的页码。	1
PageSize	integer	是	指定分页查询时，每页显示的数据最大条数。	20
BucketName	string	否	Bucket 名称。	iboxpublic****
Status	integer	否	检测状态。取值： 1：未检测过。 2：全量检测中。 3：增量检测中。 4：检测过。	1
HasRisk	integer	否	是否检测出风险文件。取值： 0：未检测出风险。 1：有风险文件。	1
FuzzBucketName	string	否	模糊匹配的 Bucket 名称。	test
Lang	string	否	指定请求和接收消息的语言类型，默认为 zh。取值： zh：中文 en：英文	zh

返回参数

名称	类型	描述	示例值
	object
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	6C578F36-92D2-552C-8AA0-86EB1AC2****
PageInfo	object	分页查询时的页面信息。
CurrentPage	integer	分页查询时，显示的当前页的页码。	1
PageSize	integer	分页查询时，每页最多显示的数据条数。	20
TotalCount	integer	数据的总条数。	165
Data	array<object>	数据详情。
BucketList	object	数据详情。
BucketName	string	Bucket 名称。	hz-new02****
RegionId	string	地域 ID。	cn-hangzhou
LastScanTime	long	最新扫描的时间戳，单位为毫秒。	1698388233883
LastScanEndTime	long	最新一次扫描的结束时间戳，单位为毫秒。	1698388233883
Scanned	boolean	是否已检测过。取值： true：已检测 false：未检测	false
ScanObject	long	检测过的文件数。	100
TotalObject	long	Bucket 内总文件数。说明该参数通过 OSS 接口 GetBucketStat 获取。	100
HighRisk	long	高风险文件数。	0
MediumRisk	long	中风险文件数。	0
LowRisk	long	低风险文件数。	0
Status	integer	检测状态。取值： 1：未检测过。 2：全量检测中。 3：增量检测中。 4：检测过。	1
Support	boolean	是否支持检测。取值： true：支持。 false：不支持。	true
Message	string	不支持检测的原因。	Unsupported Region。
StorageClass	string	Bucket 的存储类型。取值： Standard：标准存储 IA：低频访问 Archive：归档存储 ColdArchive：冷归档存储	Archive
ConfigStatus	integer	Bucket 检测配置的开启状态，取值： 0：表示未配置。 1：表示已配置已开启。 2：表示已配置未开启。	0
DecompressStatus	integer	Bucket 解压缩配置的开启状态，取值： 0：未配置解压。 1：已配置解压。	0

示例

正常返回示例

JSON格式

{
  "RequestId": "6C578F36-92D2-552C-8AA0-86EB1AC2****",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 165
  },
  "Data": [
    {
      "BucketName": "hz-new02****",
      "RegionId": "cn-hangzhou",
      "LastScanTime": 1698388233883,
      "LastScanEndTime": 1698388233883,
      "Scanned": false,
      "ScanObject": 100,
      "TotalObject": 100,
      "HighRisk": 0,
      "MediumRisk": 0,
      "LowRisk": 0,
      "Status": 1,
      "Support": true,
      "Message": "Unsupported Region。",
      "StorageClass": "Archive",
      "ConfigStatus": 0,
      "DecompressStatus": 0
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作
2024-04-10	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-12-07	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情