全部產品
Search
文件中心

Security Center:ListOssBucketScanInfo

更新時間:Jun 15, 2026

查詢 Bucket 的風險資訊列表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-sas:ListOssBucketScanInfo

get

*All Resource

*

請求參數

名稱

類型

必填

描述

樣本值

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>

資料詳情。

object

資料詳情。

BucketName

string

Bucket 名稱。

hz-new02****

RegionId

string

地域 ID。

cn-hangzhou

LastScanTime

integer

最新掃描的時間戳記,單位為毫秒。

1698388233883

LastScanEndTime

integer

最新一次掃描的結束時間戳記,單位為毫秒。

1698388233883

Scanned

boolean

是否已檢測過。取值:

  • true:已檢測

  • false:未檢測。

false

ScanObject

integer

檢測過的檔案數。

100

TotalObject

integer

Bucket 內總檔案數。

說明

該參數透過 OSS 介面 GetBucketStat 取得。

100

HighRisk

integer

高風險檔案數。

0

MediumRisk

integer

中風險檔案數。

0

LowRisk

integer

低風險檔案數。

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

錯誤碼

錯誤資訊

描述

500 ServerError ServerError
403 NoPermission caller has no permission

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情