查詢容器鏡像安全掃描覆蓋的鏡像數和待消耗的授權數。
介面說明
本介面可幫您預檢鏡像安全掃描待消耗的授權數，以確保您在建立鏡像安全掃描任務之前，已知曉鏡像安全掃描任務消耗的授權數。如果授權數不足，您需要購買足夠的授權數，以避免因授權數不足導致鏡像安全掃描任務執行中斷。
調用本介面時，如果未設定非必選的請求參數，則查詢掃描所有容器鏡像覆蓋的鏡像數和待消耗的授權數。如果設定了非必選的請求參數，則按照所設定的參數，篩選合格容器鏡像在進行安全掃描時覆蓋的鏡像數和待消耗的授權數。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
yundun-sas:PublicPreCheckImageScanTask |
none |
*全部資源
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| SourceIp |
string |
否 |
訪問源的 IP 位址。 |
192.168.XX.XX |
| RegistryTypes |
string |
否 |
鏡像倉的類型。多個鏡像倉的類型之間使用半形逗號（,）分隔。取值：
|
acr |
| RegionIds |
string |
否 |
鏡像的地區 ID。多個地區 ID 之間使用半形逗號（,）分隔。 |
cn-hangzhou |
| InstanceIds |
string |
否 |
ACR 鏡像倉執行個體的 ID。多個執行個體的 ID 之間使用半形逗號（,）分隔。 |
i-uf6j8vq9l4r5ntht**** |
| RepoNamespaces |
string |
否 |
鏡像倉的命名空間。多個命名空間之間使用半形逗號（,）分隔。 |
hanghai-namespace |
| RepoIds |
string |
否 |
鏡像倉的 ID。多個鏡像倉的 ID 之間使用半形逗號（,）分隔。 |
crr-vridcl4**** |
| RepoNames |
string |
否 |
鏡像倉的名稱。多個鏡像倉的名稱之間使用半形逗號（,）分隔。 |
centos |
| Digests |
string |
否 |
鏡像的摘要的 SHA256 值。多個摘要的 SHA256 值之間使用半形逗號（,）分隔。 |
6a5e103187b31a94592a47a5858617f7**** |
| Tags |
string |
否 |
鏡像的標籤。多個標籤之間使用半形逗號（,）分隔。 |
0.2 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
請求返回資料。 |
||
| RequestId |
string |
本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。 |
F9353221-40F4-5F98-B73C-2803DC804033 |
| Data |
object |
介面調用成功時，返回的資料。 |
|
| ScanImageCount |
integer |
鏡像安全掃描待消耗的授權數。 |
3 |
| NeedAuthCount |
integer |
鏡像安全掃描覆蓋的鏡像的總數量。 |
6 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "F9353221-40F4-5F98-B73C-2803DC804033",
"Data": {
"ScanImageCount": 3,
"NeedAuthCount": 6
}
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 500 | ServerError | ServerError | 服務故障，請稍後重試！ |
| 403 | NoPermission | caller has no permission | 當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。