調用ScanOssObjectV1介面為對應儲存物件建立敏感性資料識別的掃描任務。
介面說明
前置條件
對應的 Bucket 需要授權並串連後才能調用本介面,若 Bucket 未授權,調用 API 會返回 bucket_not_authorized 錯誤碼。
QPS 限制
本介面的單使用者 QPS 限制為 10 次/秒。超過限制,API 呼叫將會被限流,這可能影響您的業務,請合理調用。
使用說明
根據介面返回的任務 ID 可調用 DescribeIdentifyTaskStatus 介面來查看任務的運行狀態。
任務完成後可根據 BucketName、ServiceRegionId 和 ObjectKey 調用 DescribeOssObjectDetailV2 介面來查看對應儲存物件的敏感性資料識別結果。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
yundun-sddp:ScanOssObjectV1 |
none |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ServiceRegionId |
string |
是 |
服務地區 ID,即 OSS Bucket 所在的地區 ID。 |
cn-hangzhou |
| BucketName |
string |
是 |
OSS Bucket 名稱。 |
sddp-api-demo-bucket |
| ObjectKeyList |
array |
是 |
待掃描的 OSS Bucket 中儲存物件列表,一次最多可輸入 50 個 ObjectKey。 |
|
|
string |
否 |
OSS Bucket 中儲存物件名稱,需要傳入完整路徑。 |
dir1/object.txt |
|
| TemplateId |
integer |
否 |
行業模版 ID。 說明
可調用 DescribeCategoryTemplateList 擷取模版列表,如不填本參數,預設使用主用模板來進行掃描。 |
1 |
| Lang |
string |
否 |
請求和接收訊息的語言類型。取值:
|
zh |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次調用請求的 ID,是由阿里雲為該請求產生的唯一識別碼,可用於排查和定位問題。 |
7C3AC882-E5A8-4855-BE77-B6837B695EF1 |
| Id |
integer |
建立識別任務成功後,返回的識別任務 ID。 |
268 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "7C3AC882-E5A8-4855-BE77-B6837B695EF1",
"Id": 268
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。