DescribeImageCaches - 批量查詢鏡像緩衝資訊 - Elastic Container Instance

調用DescribeImageCaches批量查詢鏡像緩衝資訊。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

eci:DescribeImageCaches

get

ImageCache

acs:eci:{#regionId}:{#accountId}:imagecache/*

ImageCache

acs:eci:{#regionId}:{#accountId}:imagecache/{#imagecacheId}

eci:tag

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	地區 ID。	cn-hangzhou
RegionId	string	是	地區 ID。	cn-hangzhou
ImageCacheId	string	否	鏡像緩衝 ID。	imc-bp195erqe9o2pb09****
ImageCacheName	string	否	鏡像緩衝名稱。	testcache
SnapshotId	string	否	鏡像緩衝對應的快照 ID。	s-2zec5oj8e1yhxijt****
Image	string	否	容器鏡像。	nginx
ResourceGroupId	string	否	所屬資源群組 ID。	rg-2df3isufhi38****
Tag	array<object>	否	鏡像緩衝綁定的標籤資訊。
	object	否	鏡像緩衝綁定的標籤資訊，最多 20 個。
Key	string	否	鏡像緩衝標籤鍵。	imc
Value	string	否	鏡像緩衝標籤值。	test
MatchImage	array	否	指定容器鏡像，用於查詢首選的鏡像緩衝，最多 100 個。	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
	string	否	指定容器鏡像，用於查詢首選的鏡像緩衝，最多 100 個。	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
Limit	integer	否	查詢結果條數上限。	20
NextToken	string	否	查詢憑證（Token），取值為上一次 API 呼叫返回的 NextToken 參數值。	AAAAAdDWBF2****
ImageFullMatch	boolean	否	是否完全符合容器鏡像。在配置了 MatchImage 取值的情況下，進一步過濾查詢結果。	true
ImageMatchCountRequest	integer	否	完全符合容器鏡像的鏡像緩衝個數。在配置了 MatchImage 取值的情況下，進一步過濾查詢結果。	3

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID，唯一標識。	39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301
ImageCaches	array<object>	鏡像緩衝資訊列表。
	array<object>	鏡像緩衝資訊列表。
Images	array	鏡像緩衝包含的鏡像列表。
	string	鏡像緩衝包含的鏡像列表。	registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl
CreationTime	string	建立時間。	2021-02-09T02:24:07Z
Status	string	鏡像緩衝狀態。可能值： Preparing：準備中 Creating：建立中 Ready：建立完成 Failed：建立失敗 Updating：更新中 UpdateFailed：更新失敗當狀態為 Ready 時，即可使用該鏡像緩衝。	Ready
Progress	string	鏡像緩衝對應快照的建立進度。說明如果開啟了極速鏡像緩衝功能，將先建立一份臨時使用的本地快照再建立一份標準快照，該進度為標準快照的建立進度。	100%
ExpireDateTime	string	到期時間。	2019-11-10T09:00:48Z
LastMatchedTime	string	最新一次匹配到鏡像緩衝的時間。	2021-08-18T03:48:10Z
ContainerGroupId	string	容器組 ID。	eci-bp18oq3m15prd9jb****
Tags	array<object>	鏡像緩衝的標籤列表資訊。
	object	鏡像緩衝的標籤列表資訊。
Key	string	標籤鍵。	imc
Value	string	標籤值。	test
Events	array<object>	鏡像緩衝拉取鏡像事件資訊。
	object	鏡像緩衝拉取鏡像事件資訊。
Type	string	事件類型。	Normal
LastTimestamp	string	事件結束時間。	2021-02-09T02:24:48Z
Message	string	事件訊息。	Successfully check image cache resource.
Name	string	事件名稱。	imagetest.1661f31f851a****
Count	integer	事件數目。	1
FirstTimestamp	string	事件開始時間。	2021-02-09T02:24:48Z
Reason	string	事件原因。	Started
ImageCacheId	string	鏡像緩衝 ID。	imc-bp195erqe9o2pb09****
RegionId	string	所屬地區。	cn-beijing
SnapshotId	string	鏡像緩衝對應的快照 ID。	s-2zec5oj8e1yhxijt****
FlashSnapshotId	string	本地快照 ID。開啟極速鏡像緩衝功能後，將臨時建立一份本地快照。	s-bp12w3v37sit96t6****
ResourceGroupId	string	所屬資源群組 ID。	rg-2df3isufhi38****
ImageCacheSize	integer	鏡像緩衝大小。單位：GiB。	20
ImageCacheName	string	鏡像緩衝名稱。	imagetest
EliminationStrategy	string	鏡像緩衝的淘汰策略。預設為空白，表示一直保留。支援配置為 LRU，表示可以被自動刪除。當鏡像緩衝數量達到配額限制時，系統將自動刪除最不常用的 EliminationStrategy 為 LRU 的鏡像緩衝。	LRU
NextToken	string	本次調用返回的查詢憑證值。	AAAAAdDWBF2****
TotalCount	integer	查詢結果總條數。	15

樣本

正常返回樣本

JSON格式

{
  "RequestId": "39FC2E43-3DD7-4CEF-9EF4-E4AD6E635301",
  "ImageCaches": [
    {
      "Images": [
        "registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl"
      ],
      "CreationTime": "2021-02-09T02:24:07Z",
      "Status": "Ready",
      "Progress": "100%",
      "ExpireDateTime": "2019-11-10T09:00:48Z",
      "LastMatchedTime": "2021-08-18T03:48:10Z",
      "ContainerGroupId": "eci-bp18oq3m15prd9jb****",
      "Tags": [
        {
          "Key": "imc",
          "Value": "test"
        }
      ],
      "Events": [
        {
          "Type": "Normal",
          "LastTimestamp": "2021-02-09T02:24:48Z",
          "Message": "Successfully check image cache resource.",
          "Name": "imagetest.1661f31f851a****",
          "Count": 1,
          "FirstTimestamp": "2021-02-09T02:24:48Z",
          "Reason": "Started"
        }
      ],
      "ImageCacheId": "imc-bp195erqe9o2pb09****",
      "RegionId": "cn-beijing",
      "SnapshotId": "s-2zec5oj8e1yhxijt****",
      "FlashSnapshotId": "s-bp12w3v37sit96t6****",
      "ResourceGroupId": "rg-2df3isufhi38****",
      "ImageCacheSize": 20,
      "ImageCacheName": "imagetest",
      "EliminationStrategy": "LRU"
    }
  ],
  "NextToken": "AAAAAdDWBF2****",
  "TotalCount": 15
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	Account.Arrearage	Your account has an outstanding payment.	帳號已經欠費。
400	DryRunOperation	Request validation has been passed with DryRun flag set.	此次DryRun預檢請求合格。
400	ServiceNotEnabled	%s	該次請求所依賴的服務沒有開通，請開通後再試。
403	Forbidden.SubUser	The specified action is not available for you.
403	Forbidden.UserBussinessStatus	This operation is not allowed, because you have overdue bills. Pay the overdue bill and try again.	使用者處於欠費狀態不允許建立，請儲值後再嘗試。
403	Forbidden.UserNotRealNameAuthentication	This operation is not allowed, because you have not passed the real-name verification.	操作被禁止，因為使用者還未進行實名認證。
403	NoPermission	The RAM role does not belong to ECS.

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

變更歷史

更多資訊，參考變更詳情。