Todos os produtos
Search

Este produto

    Tablestore:GetInstance

    Central de documentação

    Tablestore:GetInstance

    Última atualização: Jun 30, 2026

    Consulta informações da instância.

    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 do SDK.

    Depurar

    Informações de autorização

    Esta API não possui informações de autorização divulgadas.

    Sintaxe da solicitação

    GET /v2/openapi/getinstance HTTP/1.1

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo

    InstanceName

    string

    Sim

    Nome da instância.

    instance-test

    Parâmetros de resposta

    ParâmetroTipoDescriçãoExemplo
    object

    Struct retornada.

    RequestIdstring

    ID da solicitação. Utilize este ID para solucionar problemas.

    		757E172A-F94B-5E78-8A23-D9068E42F2E9
    InstanceNamestring

    Nome da instância.

    		instance-test
    ResourceGroupIdstring

    ID do grupo de recursos ao qual a instância pertence.

    		rg-acfmxh4em5jncda
    RegionIdstring

    ID da região da instância.

    		cn-chengdu
    SPInstanceIdstring

    ID da instância.

    		ots_standard_public_cn-9lb34u7u5001
    AliasNamestring

    Alias da instância.

    		instance-test
    UserIdstring

    ID do usuário.

    		16542312566
    Networkstring

    Tipo de rede da instância. Valores válidos:

    • VPC: a instância é acessível apenas pelas Virtual Private Clouds (VPCs) vinculadas.
    • VPC_CONSOLE: a instância é acessível pelo console do Tablestore ou pelas VPCs vinculadas.
    • NORMAL: a instância é acessível por redes de tipos personalizados.
    		VPC
    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
    		SSD
    PaymentTypestring

    Método de faturamento. Valores válidos:

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

    Tipo de armazenamento.

    • SSD: alto desempenho
    • HYBRID: capacidade
    		HYBRID
    VCUQuotainteger

    Cota de VCU.

    		20
    TableQuotainteger

    Número total de tabelas na instância.

    		100
    InstanceStatusstring

    Status da instância.

    • normal: a instância funciona conforme o esperado.
    • forbidden: a instância está desativada.
    • Deleting: a instância está sendo excluída.
    		normal
    CreateTimestring

    Horário de criação da instância.

    		2019-12-23T07:24:33Z
    Tagsarray<object>

    Tags da instância.

    Tagsobject

    Tag da instância.

    Keystring

    Chave da tag.

    		tag
    Valuestring

    Valor da tag.

    		333
    TagKeystring

    (Obsoleto) Chave da tag.

    		keyTestA
    TagValuestring

    (Obsoleto) Valor da tag.

    		00004a20240452b0
    NetworkTypeACLarray

    Tipos de rede com acesso permitido. Valores válidos:

    • CLASSIC: rede clássica
    • INTERNET: Internet
    • VPC: VPCs
    NetworkTypeACLstring

    Tipo de rede com acesso permitido.

    		INTERNET
    NetworkSourceACLarray

    Origens de rede com acesso permitido. Valor válido:

    TRUST_PROXY: console

    NetworkSourceACLstring

    Origem de rede com acesso permitido.

    		TRUST_PROXY
    Policystring

    Política da instância.

    		{ "Version": "1", "Statement": [ { "Action": [ "ots:*" ], "Resource": [ "acs:ots:*:13791xxxxxxxxxxx:instance/myinstance*" ], "Principal": [ "*" ], "Effect": "Allow", "Condition": { "StringEquals": { "ots:TLSVersion": [ "1.2" ] }, "IpAddress": { "acs:SourceIp": [ "192.168.0.1", "198.51.100.1" ] } } } ] }
    PolicyVersionlong

    Versão da política da instância.

    		1
    IsMultiAZboolean

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

    • true: ZRS ativado para a instância.
    • false: armazenamento com redundância local (LRS) ativado para a instância.
    		true
    ElasticVCUUpperLimitfloat

    Limite superior de VCUs da instância.

    		6

    Exemplos

    Exemplos de respostas de sucesso

    Formato JSON

    {

    "RequestId": "757E172A-F94B-5E78-8A23-D9068E42F2E9",

    "InstanceName": "instance-test",

    "ResourceGroupId": "rg-acfmxh4em5jncda",

    "RegionId": "cn-chengdu",

    "SPInstanceId": "ots_standard_public_cn-9lb34u7u5001",

    "AliasName": "instance-test",

    "UserId": "16542312566",

    "Network": "VPC",

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

    "InstanceSpecification": "SSD",

    "PaymentType": "Subscription",

    "StorageType": "HYBRID",

    "VCUQuota": 20,

    "TableQuota": 100,

    "InstanceStatus": "normal",

    "CreateTime": "2019-12-23T07:24:33Z",

    "Tags": [

    {

    "Key": "tag",

    "Value": "333",

    "TagKey": "keyTestA",

    "TagValue": "00004a20240452b0"

    }

    ],

    "NetworkTypeACL": [

    "INTERNET"

    ],

    "NetworkSourceACL": [

    "TRUST_PROXY"

    ],

    "Policy": "{\n \"Version\": \"1\",\n \"Statement\": [\n {\n \"Action\": [\n \"ots:\"\n ],\n \"Resource\": [\n \"acs:ots::13791xxxxxxxxxxx:instance/myinstance\"\n ],\n \"Principal\": [\n \"\"\n ],\n \"Effect\": \"Allow\",\n \"Condition\": {\n \"StringEquals\": {\n \"ots:TLSVersion\": [\n \"1.2\"\n ]\n },\n \"IpAddress\": {\n \"acs:SourceIp\": [\n \"192.168.0.1\",\n \"198.51.100.1\"\n ]\n }\n }\n }\n ]\n}",

    "PolicyVersion": 1,

    "IsMultiAZ": true,

    "ElasticVCUUpperLimit": 6

    }

    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

    02/04/2024

    A estrutura de resposta da API foi alterada

    Visualize detalhes da alteração

    13/10/2023

    A estrutura de resposta da API foi alterada

    Visualize detalhes da alteração