Todos os produtos
Search
Central de documentação

Tablestore:ListInstances

Última atualização: Jun 30, 2026

Consulta instâncias.

Depuração

Execute esta interface diretamente no OpenAPI Explorer para evitar o cálculo manual de assinaturas. Após a execução bem-sucedida, o OpenAPI Explorer gera automaticamente exemplos de código SDK.

Depurar

Informações de autorização

Não há informações de autorização disponíveis para esta API.

Sintaxe da solicitação

GET /v2/openapi/listinstances HTTP/1.1

Parâmetros da solicitação

ParâmetroTipoObrigatórioDescriçãoExemplo
StatusstringNão

Status da instância.

Valores válidos:
  • normal: A instância está em execução normal.
  • deleting: A instância está sendo excluída.
  • forbidden: A instância está desativada.
normal
MaxResultsintegerNão

Número máximo de instâncias a retornar. Valores válidos: 0 a 200. Se você não definir este parâmetro ou defini-lo como 0, o valor padrão será 100.

100
NextTokenstringNão

Token que determina a posição inicial da consulta. Defina este parâmetro com o valor do parâmetro NextToken retornado na última chamada. As instâncias são retornadas em ordem lexicográfica a partir da posição especificada por este parâmetro. Na primeira chamada da operação, deixe este parâmetro vazio.

CAESCG15aC1xxxxx
InstanceNamestringNão

Nome da instância. A busca aproximada é compatível.

instance
ResourceGroupIdstringNão

ID do grupo de recursos. Consulte o ID na página Resource Group no console Resource Management.

rg-aek24upgom6p5ri
InstanceNameListarrayNão

Nomes das instâncias. Use este parâmetro para especificar várias instâncias a serem consultadas simultaneamente.

stringNão

Nome da instância. A correspondência exata e completa é compatível.

instance-test
Tagarray<object>Não

Tags da instância.

objectNão

Tag da instância.

KeystringNão

Chave da tag.

Owner
ValuestringNão

Valor da tag.

Tester

Parâmetros de resposta

ParâmetroTipoDescriçãoExemplo
object

Estrutura retornada.

RequestIdstring

ID da solicitação. Use-o para solucionar problemas.

E734979F-5A44-5993-9CE5-C23103576923
TotalCountlong

Número total de instâncias retornadas.

2
NextTokenstring

Token que define a posição inicial da próxima consulta. Se este parâmetro estiver vazio, todas as instâncias consultadas foram retornadas.

CAESCG15aC1xxxxx
Instancesarray<object>

Detalhes das instâncias.

Instancesobject

As instâncias.

InstanceNamestring

Nome da instância. Identifica a instância de forma única.

instance-test
ResourceGroupIdstring

ID do grupo de recursos.

rg-acfmxh4em5jnbcd
RegionIdstring

ID da região.

cn-huhehaote
SPInstanceIdstring

ID da instância.

ots_standard_public_cn-g4t3igqjj002
AliasNamestring

Alias da instância.

instance-test
UserIdstring

ID do usuário.

13542356466
InstanceDescriptionstring

Descrição da instância.

Description of the test instance.
InstanceSpecificationstring

Tipo da instância.

  • SSD: instância de alto desempenho
  • HYBRID: instância de capacidade
HYBRID
PaymentTypestring

Método de faturamento.

  • Subscription: assinatura
  • PayAsYouGo: pagamento conforme o uso
Subscription
StorageTypestring

Tipo de armazenamento.

  • SSD: alto desempenho
  • HYBRID: capacidade
HYBRID
VCUQuotainteger

Cota de VCU.

3
InstanceStatusstring

Status da instância.

  • normal: A instância está em execução normal.
  • forbidden: A instância está desativada.
  • Deleting: A instância está sendo liberada.
normal
CreateTimestring

Data e hora de criação da instância.

2019-04-07T09:19:21Z
IsMultiAZboolean

Indica se o armazenamento redundante de zona (ZRS) está ativado para a instância.

  • true: O ZRS está ativado para a instância.
  • false: O armazenamento localmente redundante (LRS) está ativado para a instância.
true

Exemplos

Exemplos de respostas de sucesso

Formato JSON

{

"RequestId": "E734979F-5A44-5993-9CE5-C23103576923",

"TotalCount": 2,

"NextToken": "CAESCG15aC1xxxxx",

"Instances": [

{

"InstanceName": "instance-test",

"ResourceGroupId": "rg-acfmxh4em5jnbcd",

"RegionId": "cn-huhehaote",

"SPInstanceId": "ots_standard_public_cn-g4t3igqjj002",

"AliasName": "instance-test",

"UserId": "13542356466",

"InstanceDescription": "Description of the test instance.",

"InstanceSpecification": "HYBRID",

"PaymentType": "Subscription",

"StorageType": "HYBRID",

"VCUQuota": 3,

"InstanceStatus": "normal",

"CreateTime": "2019-04-07T09:19:21Z",

"IsMultiAZ": true

}

]

}

Códigos de erro

Para obter uma lista de códigos de erro, consulte os Códigos de erro do serviço.

Histórico de alterações

Data da alteração

Resumo das alterações

Operação

2024-07-24

Os parâmetros de solicitação da API foram alterados

Visualize detalhes da alteração