DescribeTairKVCacheInferInstances - Tair (Redis® OSS-Compatible)

查詢一個或多個Tair KVCache執行個體的資訊。

介面說明

本介面支援查詢 Tair KVCache 的推理算子執行個體、虛擬叢集執行個體、快取服務執行個體。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

kvstore:DescribeTairKVCacheInferInstances

list

*All Resource

*

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	執行個體所屬的地域 ID。	cn-beijing
InstanceIds	string	否	需要查詢的執行個體 ID。說明如需傳入多個執行個體 ID 時，使用英文逗號（,）分隔執行個體 ID，最多一個請求傳入 30 個執行個體 ID。	tk-2zefe7728c2c****
InstanceStatus	string	否	執行個體狀態，取值： Normal：正常。 Creating：建立中。說明更多執行個體狀態及詳細資訊，請參見執行個體狀態與影響。	Normal
ChargeType	string	否	執行個體的付費類型，取值： PrePaid：預付費，包年包月。 PostPaid：後付費，按量付費。	PrePaid
NetworkType	string	否	網路類型，取值： VPC：專有網路，預設值。	VPC
InstanceClass	string	否	執行個體規格。	kvcache.cu.g4c.2
VpcId	string	否	專有網路 ID。	vpc-bp1nme44gek34slfc****
VSwitchId	string	否	虛擬交換機 ID。	vsw-bp1e7clcw529l773d****
PageNumber	integer	否	執行個體列表的頁碼，起始值為 1，預設值為 1。	1
PageSize	integer	否	分頁大小，預設為 30。	30
SearchKey	string	否	支援模糊搜尋執行個體名稱或執行個體 ID。	apitest
Expired	string	否	執行個體的過期狀態，取值： true：已過期。 false：未過期。	false
ZoneId	string	否	可用區 ID。	cn-hangzhou-e
ResourceGroupId	string	否	資源群組 ID，可以為空。	rg-acfmyiu4ekp****
Tag	array<object>	否	執行個體的標籤資訊。
	object	否	執行個體的標籤資訊。
Key	string	否	標籤的鍵，與 Tag Value 組成標籤的鍵值對。說明單次最多支援傳入 5 組標籤的鍵值對。	key1_test
Value	string	否	標籤的值。說明 N 表示傳入第幾個標籤的值。例如Tag.1.Value表示傳入第一個標籤的值；Tag.2.Value表示傳入第二個標籤的值。	testvalue
PrivateIp	string	否	專有網路 IP 位址。該參數已棄用。	172.16.49.***

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	CD225838-7069-5CE4-89E1-67B83AC149C8
PageNumber	integer	頁碼。	1
PageSize	integer	每頁返回的記錄數。	30
TotalCount	integer	總記錄數。	3
Instances	object
TairInferInstanceDTO	array<object>	Tair KVCache 執行個體資訊列表內容。
	array<object>
VpcId	string	Virtual Private Cloud ID。	vpc-2zef5w848p4j5g***
CreateTime	string	執行個體的建立時間。	2025-04-07T04:46Z
ChargeType	string	付費類型。	PostPaid
NetworkType	string	網路類型。	VPC
InstanceName	string	執行個體名稱。	kvcache-7
InstanceClass	string	執行個體規格。	kvcache.cu.g4b.2
DestroyTime	string	銷毀執行個體的時間。	2025-04-07T04:46Z
InstanceId	string	執行個體 ID。	tk-9dp7e37bab*****
InstanceType	string	執行個體類型，傳回值： TairInfer：推理運算元執行個體 TairKVCacheVnode：虛擬叢集執行個體。 TairKVCacheService：快取服務執行個體。	TairInfer
RegionId	string	地區 ID。	cn-beijing
EndTime	string	預付費執行個體到期時間。	2025-11-04T02:09:26Z
VSwitchId	string	虛擬交換器 ID。	vsw-8vbf0ksk774ai6q1d****
ResourceGroupId	string	資源群組 ID。	rg-acfm4bdru5z****
ZoneId	string	可用性區域 ID。	cn-hangzhou-g
InstanceStatus	string	執行個體狀態，取值： Normal：正常。 Creating：建立中。	Normal
Tags	object
Tag	array<object>	執行個體的標籤資訊。
	object	執行個體的標籤資訊。
Key	string	Tag 的 Key。	thread
Value	string	標籤 value。	900
PrivateIp	string	專用網路 IP 位址。該參數已棄用。	172.16.49.***
Capacity	integer	KVCache 儲存容量。單位 GB。	256
Model	string	推理運算元執行個體的內建模型。	DeepSeek-OCR
ModelServiceNum	integer	推理運算元執行個體的模型服務數量。	1
ComputeUnitNum	integer	計算單元數量。	1
VNodeName	string	虛擬叢集執行個體下屬 VNode 執行個體名列表。該參數已棄用。	tv-xxxxx
AckId	string	虛擬叢集執行個體對應的 ACK ID。	c809******************************
VNodeCount	integer	虛擬叢集執行個體下的虛擬節點數量。	2
FixedVNodeCount	integer
ElasticVNodeCount	integer

樣本

正常返回樣本

JSON格式

{
  "RequestId": "CD225838-7069-5CE4-89E1-67B83AC149C8",
  "PageNumber": 1,
  "PageSize": 30,
  "TotalCount": 3,
  "Instances": {
    "TairInferInstanceDTO": [
      {
        "VpcId": "vpc-2zef5w848p4j5g***",
        "CreateTime": "2025-04-07T04:46Z",
        "ChargeType": "PostPaid",
        "NetworkType": "VPC",
        "InstanceName": "kvcache-7",
        "InstanceClass": "kvcache.cu.g4b.2",
        "DestroyTime": "2025-04-07T04:46Z\n",
        "InstanceId": "tk-9dp7e37bab*****",
        "InstanceType": "TairInfer",
        "RegionId": "cn-beijing",
        "EndTime": "2025-11-04T02:09:26Z",
        "VSwitchId": "vsw-8vbf0ksk774ai6q1d****",
        "ResourceGroupId": "rg-acfm4bdru5z****",
        "ZoneId": "cn-hangzhou-g",
        "InstanceStatus": "Normal",
        "Tags": {
          "Tag": [
            {
              "Key": "thread",
              "Value": "900"
            }
          ]
        },
        "PrivateIp": "172.16.49.***",
        "Capacity": 256,
        "Model": "DeepSeek-OCR",
        "ModelServiceNum": 1,
        "ComputeUnitNum": 1,
        "VNodeName": "tv-xxxxx",
        "AckId": "c809******************************",
        "VNodeCount": 2,
        "FixedVNodeCount": 0,
        "ElasticVNodeCount": 0
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidInstanceIds.Malformed	The Specified parameter InstanceIds is not valid.

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

變更歷史

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