DescribeDataCaches - 查詢資料緩衝 - Elastic Container Instance

查詢資料緩衝資訊。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

eci:DescribeDataCaches

list

*DataCache

acs:eci:{#regionId}:{#accountId}:datacache/{#datacacheId}

eci:tag

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	地區 ID。	cn-hangzhou
RegionId	string	是	地區 ID。	cn-hangzhou
DataCacheId	array	否	資料緩衝 ID。
	string	否	資料緩衝 ID。	edc-bp1a7n7uawwwol******
Bucket	string	否	資料緩衝 Bucket。預設為 default。	default
Path	string	否	資料緩衝對應 Virtual Host 的目錄。	/data/models/
Tag	array<object>	否	標籤列表。
	object	否	標籤列表
Key	string	否	標籤鍵。	testkey
Value	string	否	標籤值。	testvalue
ResourceGroupId	string	否	資源群組 ID。	rg-acfmzw2jz2z****
Limit	integer	否	查詢結果條數上限。預設值和最大值為 20。	20
NextToken	string	否	查詢憑證（Token），取值為上一次 API 呼叫返回的 NextToken 參數值。	d78f2dd8-5979-42fe-****-b16db43be5bc

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	B8756BA0-6452-419C-9727-37A6209C85E0
DataCaches	array<object>	資料緩衝資訊。
	array<object>	資料緩衝資訊。
DataCacheId	string	資料緩衝 ID。	edc-bp15l4vvys94oo******
CreationTime	string	建立時間。	2023-06-16T02:43Z
Status	string	資料緩衝狀態。可能值： Loading：快取資料中 Creating：建立中 Available：建立成功 Failed：建立失敗 Updating：更新中 UpdateFailed：更新失敗當狀態為 Available 時，即可使用該資料緩衝。	Available
Progress	string	建立進度。	100%
LastMatchedTime	string	最新一次匹配資料緩衝的時間。	2023-06-18T02:43Z
ExpireDateTime	string	到期時間。	2023-06-26T02:43Z
ContainerGroupId	string	建立資料緩衝過程中，產生的 ECI 執行個體 ID。	eci-8vb1y2w1dv7zeirn****
Tags	array<object>	標籤列表。
	object	標籤列表。
Key	string	標籤鍵。	testkey
Value	string	標籤值。	testvalue
Events	array<object>	事件列表。
	object	事件列表。
Type	string	事件類型。可能值： Normal Warning	Normal
LastTimestamp	string	事件結束時間。	2021-06-16T02:24:48Z
Message	string	事件資訊。	Successfully check data cache resource.
Name	string	事件名稱。	datacache
Count	integer	事件數目。	1
FirstTimestamp	string	事件開始時間。	2021-06-16T02:14:48Z
Reason	string	事件原因。	Started
RegionId	string	地區 ID。	cn-hangzhou
SnapshotId	string	快照 ID。	s-2zec5oj8e1yhxijt****
FlashSnapshotId	string	本地快照 ID。	s-bp12w3v37sit96t6****
ResourceGroupId	string	資源群組 ID。	rg-aek2hlt3ux4****
Size	integer	資料緩衝大小。單位為 GiB。	20
Name	string	資料緩衝名稱。	test
DataSource	object	資料來源資訊。
Type	string	資料來源類型。可能值： NAS OSS URL SNAPSHOT	URL
Options	string	資料來源的配置參數。	{ "options": { "path": "/", "server": "0ce1f4**-or*.cn-hangzhou.nas.aliyuncs.com", "vers": "3", "options": "nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport" }, "type": "NAS" }
Bucket	string	資料緩衝 Bucket。	default
Path	string	資料緩衝對應 Virtual Host 的目錄。	/data/models/
NextToken	string	查詢憑證（Token），取值為上一次 API 呼叫返回的 NextToken 參數值。	d78f2dd8-5979-42fe-xaee-b16db43be5bc
TotalCount	integer	符合查詢條件的結果條數。	2

樣本

正常返回樣本

JSON格式

{
  "RequestId": "B8756BA0-6452-419C-9727-37A6209C85E0",
  "DataCaches": [
    {
      "DataCacheId": "edc-bp15l4vvys94oo******\n",
      "CreationTime": "2023-06-16T02:43Z",
      "Status": "Available",
      "Progress": "100%",
      "LastMatchedTime": "2023-06-18T02:43Z",
      "ExpireDateTime": "2023-06-26T02:43Z\n",
      "ContainerGroupId": "eci-8vb1y2w1dv7zeirn****",
      "Tags": [
        {
          "Key": "testkey",
          "Value": "testvalue"
        }
      ],
      "Events": [
        {
          "Type": "Normal",
          "LastTimestamp": "2021-06-16T02:24:48Z",
          "Message": "Successfully check data cache resource.",
          "Name": "datacache",
          "Count": 1,
          "FirstTimestamp": "2021-06-16T02:14:48Z",
          "Reason": "Started"
        }
      ],
      "RegionId": "cn-hangzhou",
      "SnapshotId": "s-2zec5oj8e1yhxijt****",
      "FlashSnapshotId": "s-bp12w3v37sit96t6****\n",
      "ResourceGroupId": "rg-aek2hlt3ux4****",
      "Size": 20,
      "Name": "test",
      "DataSource": {
        "Type": "URL",
        "Options": "{\n      \"options\": {\n            \"path\": \"/\",\n            \"server\": \"0ce1f4****-or***.cn-hangzhou.nas.aliyuncs.com\",\n            \"vers\": \"3\",\n            \"options\": \"nolock,proto=tcp,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2,noresvport\"\n      },\n      \"type\": \"NAS\"\n}"
      },
      "Bucket": "default",
      "Path": "/data/models/"
    }
  ],
  "NextToken": "d78f2dd8-5979-42fe-xaee-b16db43be5bc",
  "TotalCount": 2
}

錯誤碼

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.

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

變更歷史

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