DescribeTairKVCacheInferInstances - Tair (Redis® OSS-Compatible): Central de Documentação do Alibaba Cloud

Consulta os detalhes de uma ou mais instâncias do Tair KVCache.

Descrição da operação

Esta operação consulta instâncias de operador de inferência, instâncias de cluster virtual e instâncias de serviço de cache do Tair KVCache.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

kvstore:DescribeTairKVCacheInferInstances

list

*All resources.

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância.	cn-beijing
InstanceIds	string	Não	Os IDs das instâncias a serem consultadas. Nota Se você especificar vários IDs de instância, separe-os por vírgulas (,). Você pode especificar até 30 IDs de instância em uma única solicitação.	tk-2zefe7728c2c****
InstanceStatus	string	Não	O status da instância. Valores válidos: Normal: Normal. Creating: Criando. Nota Para obter mais informações sobre os status da instância, consulte Status e impactos da instância.	Normal
ChargeType	string	Não	O método de cobrança da instância. Valores válidos: PrePaid: Assinatura. PostPaid: Pay-as-you-go. Valores válidos: PostPaid : Pay-as-you-go. PrePaid : Assinatura.	PrePaid
NetworkType	string	Não	O tipo de rede. Valores válidos: VPC: Virtual Private Cloud (VPC). Este é o valor padrão.	VPC
InstanceClass	string	Não	O tipo de instância.	kvcache.cu.g4c.2
VpcId	string	Não	O ID da VPC.	vpc-bp1nme44gek34slfc****
VSwitchId	string	Não	O ID do vSwitch.	vsw-bp1e7clcw529l773d****
PageNumber	integer	Não	O número da página da lista de instâncias. As páginas começam em 1. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 30.	30
SearchKey	string	Não	A palavra-chave de pesquisa. Você pode usar este parâmetro para realizar uma pesquisa aproximada por nome de instância ou ID de instância.	apitest
Expired	string	Não	O status de expiração da instância. Valores válidos: true: Expirado. false: Não expirado.	false
ZoneId	string	Não	O ID da zona.	cn-hangzhou-e
ResourceGroupId	string	Não	O ID do grupo de recursos. Este parâmetro pode ser deixado vazio.	rg-acfmyiu4ekp****
Tag	array<object>	Não	As tags da instância.
	object	Não	As tags da instância.
Key	string	Não	A chave da tag. Uma chave de tag e um valor de tag formam um par chave-valor. Nota Você pode especificar até 5 pares chave-valor de tag em uma única solicitação.	key1_test
Value	string	Não	O valor da tag. Nota N especifica o número de sequência da tag. Por exemplo, Tag.1.Value especifica o valor da primeira tag, e Tag.2.Value especifica o valor da segunda tag.	testvalue
PrivateIp	string	Não	[Descontinuado] O endereço IP privado da VPC.	172.16.49.***

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	CD225838-7069-5CE4-89E1-67B83AC149C8
PageNumber	integer	O número da página.	1
PageSize	integer	O número de entradas retornadas por página.	30
TotalCount	integer	O número total de entradas.	3
Instances	object
TairInferInstanceDTO	array<object>	A lista de instâncias do Tair KVCache.
	array<object>
VpcId	string	O ID da VPC.	vpc-2zef5w848p4j5g***
CreateTime	string	A hora em que a instância foi criada. A hora é exibida no formato yyyy-MM-ddTHH:mmZ em UTC.	2025-04-07T04:46Z
ChargeType	string	O método de cobrança.	PostPaid
NetworkType	string	O tipo de rede.	VPC
InstanceName	string	O nome da instância.	kvcache-7
InstanceClass	string	O tipo de instância.	kvcache.cu.g4b.2
DestroyTime	string	A hora em que a instância foi destruída. A hora é exibida no formato yyyy-MM-ddTHH:mmZ em UTC.	2025-04-07T04:46Z
InstanceId	string	O ID da instância.	tk-9dp7e37bab*****
InstanceType	string	O tipo de instância. Valores válidos: TairInfer: Instância de operador de inferência. TairKVCacheVnode: Instância de cluster virtual. TairKVCacheService: Instância de serviço de cache.	TairInfer
RegionId	string	O ID da região.	cn-beijing
EndTime	string	A hora em que a instância pré-paga expira. A hora é exibida no formato yyyy-MM-ddTHH:mm:ssZ em UTC.	2025-11-04T02:09:26Z
VSwitchId	string	O ID do vSwitch.	vsw-8vbf0ksk774ai6q1d****
ResourceGroupId	string	O ID do grupo de recursos.	rg-acfm4bdru5z****
ZoneId	string	O ID da zona.	cn-hangzhou-g
InstanceStatus	string	O status da instância. Valores válidos: Normal: Normal. Creating: Criando.	Normal
Tags	object
Tag	array<object>	As tags da instância.
	object	As tags da instância.
Key	string	A chave da tag.	thread
Value	string	O valor da tag.	900
PrivateIp	string	[Descontinuado] O endereço IP privado da VPC.	172.16.49.***
Capacity	integer	A capacidade de armazenamento do KVCache. Unidade: GB.	256
Model	string	O modelo integrado da instância de operador de inferência.	DeepSeek-OCR
ModelServiceNum	integer	O número de serviços de modelo na instância de operador de inferência.	1
ComputeUnitNum	integer	O número de unidades de computação.	1
VNodeName	string	[Descontinuado] A lista de nomes de instâncias vNode sob a instância de cluster virtual.	tv-xxxxx
AckId	string	O ID do ACK correspondente à instância de cluster virtual.	c809******************************
VNodeCount	integer	O número de nós virtuais na instância de cluster virtual.	2
FixedVNodeCount	integer	O número de vNodes fixos.	0
ElasticVNodeCount	integer	O número de vNodes elásticos.	0

Exemplos

Resposta de sucesso

JSON formato

{
  "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
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstanceIds.Malformed	The Specified parameter InstanceIds is not valid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.