DescribeTairKVCacheInferInstances - Tair (Redis® OSS-Compatible) - Alibaba Cloud ドキュメントセンター

1 つ以上の Tair KVCache インスタンスの情報をクエリします。

操作説明

この操作は、Tair KVCache 推論演算子インスタンス、仮想クラスターインスタンス、およびキャッシュサービスインスタンスのクエリをサポートします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

kvstore:DescribeTairKVCacheInferInstances

list

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	インスタンスのリージョン ID。	cn-beijing
InstanceIds	string	任意	クエリするインスタンスの ID。説明複数のインスタンス ID を指定するには、コンマ（,）で区切ります。1 回のリクエストで最大 30 個のインスタンス ID を指定できます。	tk-2zefe7728c2c****
InstanceStatus	string	任意	インスタンスステータス。有効な値: Normal: 法線。 Creating: インスタンスを作成中です。説明インスタンスステータスの詳細については、インスタンスの状態と影響を参照してください。	Normal
ChargeType	string	任意	インスタンスの課金方法。有効な値: PrePaid: サブスクリプション。 PostPaid: 従量課金。	PrePaid
NetworkType	string	任意	ネットワークタイプ。有効な値: VPC: 仮想非公開クラウド（VPC）。これはデフォルト値です。	VPC
InstanceClass	string	任意	インスタンスタイプ。	kvcache.cu.g4c.2
VpcId	string	任意	VPC ID。	vpc-bp1nme44gek34slfc****
VSwitchId	string	任意	vSwitch ID。	vsw-bp1e7clcw529l773d****
PageNumber	integer	任意	ページ番号。値は 1 から始まります。デフォルト値: 1。	1
PageSize	integer	任意	1 ページあたりのエントリ数。デフォルト値: 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	任意	タグのキー。タグのキーと値でキーと値のペアをフォームします。説明 1 回のリクエストで最大 5 個のタグのキーと値のペアを指定できます。	key1_test
Value	string	任意	タグ値。説明 N はタグのシーケンス番号を指定します。例えば、Tag.1.Value は最初のタグの値を指定し、Tag.2.Value は 2 番目のタグの値を指定します。	testvalue
PrivateIp	string	任意	VPC 内の非公開 IP アドレス。このパラメーターは非推奨です。	172.16.49.***

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	CD225838-7069-5CE4-89E1-67B83AC149C8
PageNumber	integer	ページ番号。	1
PageSize	integer	1 ページあたりのエントリ数。	30
TotalCount	integer	エントリの総数。	3
Instances	object
TairInferInstanceDTO	array<object>	Tair KVCache インスタンスのリスト。
	array<object>
VpcId	string	VPC 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: TairInfer インスタンス。 TairKVCacheVnode: 仮想クラスターインスタンス。 TairKVCacheService: キャッシュサービスインスタンス。	TairInfer
RegionId	string	リージョン ID。	cn-beijing
EndTime	string	サブスクリプションインスタンスの有効期限。	2025-11-04T02:09:26Z
VSwitchId	string	vSwitch 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	タグのキー。	thread
Value	string	タグの値。	900
PrivateIp	string	プライベート IP アドレス。このパラメーターは非推奨です。	172.16.49.***
Capacity	integer	KVCache インスタンスのストレージ容量。単位: GB。	256
Model	string	TairInfer インスタンスの組み込みモデル。	DeepSeek-OCR
ModelServiceNum	integer	TairInfer インスタンス内のモデルサービスの数。	1
ComputeUnitNum	integer	計算ユニットの数。	1
VNodeName	string	vNode インスタンスの名前。このパラメーターは非推奨です。	tv-xxxxx
AckId	string	仮想クラスターインスタンスに関連付けられた ACK クラスターの ID。	c809******************************
VNodeCount	integer	仮想クラスターインスタンス内の vNode 数。	2
FixedVNodeCount	integer
ElasticVNodeCount	integer

例

成功レスポンス

JSONJSON

{
  "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 ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidInstanceIds.Malformed	The Specified parameter InstanceIds is not valid.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。