Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):DescribeAvailableResource

Última atualização: Jun 29, 2026

Consulta os tipos de instâncias Tair (compatíveis com Redis OSS) que podem ser criadas em uma zona especificada.

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:DescribeAvailableResource

get

*All Resource

*

Nenhuma 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. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

ZoneId

string

Não

O ID da zona da instância. Você pode chamar a operação DescribeZones para consultar a lista de zonas mais recente.

cn-hangzhou-h

InstanceChargeType

string

Não

O método de cobrança. Valores válidos:

  • PrePaid (padrão): assinatura

  • PostPaid: pay-as-you-go

PrePaid

OrderType

string

Não

O tipo de pedido. Valores válidos:

  • BUY (padrão): pedidos usados para criar instâncias

  • UPGRADE: pedidos usados para fazer upgrade de instâncias

  • DOWNGRADE: pedidos usados para fazer downgrade de instâncias

BUY

Engine

string

Não

O mecanismo de banco de dados da instância. Valores válidos:

  • Redis

  • Memcache

Redis

ResourceGroupId

string

Não

O ID do grupo de recursos ao qual a instância pertence. Você pode chamar a operação ListResourceGroups para consultar os IDs dos grupos de recursos.

Nota

Você também pode consultar os IDs dos grupos de recursos no console do Resource Management. Para mais informações, consulte Exibir informações básicas sobre um grupo de recursos.

rg-acfmyiu4e******

InstanceId

string

Não

O ID da instância.

Nota

Este parâmetro está disponível e é obrigatório apenas se o parâmetro OrderType estiver definido como UPGRADE ou DOWNGRADE.

r-bp1zxszhcgatnx****

AcceptLanguage

string

Não

O idioma de exibição da resposta. Valores válidos:

  • zh-CN: chinês. Este é o valor padrão.

  • en-US: inglês.

zh-CN

ProductType

string

Não

O tipo de instância. Valor padrão: Local. Valores válidos:

  • Local: instância clássica do Redis Open-Source Edition ou instância clássica baseada em DRAM

  • Tair_rdb: instância baseada em DRAM nativa da nuvem

  • Tair_scm: instância otimizada para memória persistente

  • Tair_essd: instância baseada em ESSD/SSD

  • OnECS: instância do Redis Open-Source Edition nativa da nuvem

Nota

O valor padrão deste parâmetro é Local. Para consultar recursos de disco, você deve especificar o tipo de instância que fornece os recursos de disco necessários.

Local

NodeId

string

Não

O ID do nó de dados para o qual você deseja consultar os recursos disponíveis que podem ser criados. Você pode chamar a operação DescribeLogicInstanceTopology para consultar o ID do nó de dados. Remova o sinal de número (#) e o conteúdo que segue o sinal de número. Por exemplo, mantenha apenas r-bp10noxlhcoim2****-db-0.

Nota

Antes de especificar este parâmetro, você deve definir o parâmetro InstanceId como o ID de uma instância que usa a arquitetura de cluster ou de divisão de leitura/gravação.

r-bp1zxszhcgatnx****-db-0

InstanceScene

string

Não

A edição da instância. Valores válidos:

  • professional: Standard Edition. Esta edição oferece suporte às arquiteturas standalone, master-replica, read/write splitting e cluster, e fornece alta escalabilidade.

professional

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

RequestId

string

O ID da solicitação.

493B7308-D9C2-55F6-B042-0313BD63****

AvailableZones

object

AvailableZone

array<object>

Detalhes sobre as zonas.

array<object>

ZoneId

string

The ID of the zone in which the instance is located.

cn-hangzhou-h

ZoneName

string

The name of the zone.

杭州 可用区H

RegionId

string

The ID of the region.

cn-hangzhou

SupportedEngines

object

SupportedEngine

array<object>

The supported engines.

array<object>

Engine

string

The database engine of the instance.

Redis

SupportedEditionTypes

object

SupportedEditionType

array<object>

The instance edition types.

array<object>

EditionType

string

The edition of the instance. Valid values:

  • Community: Community Edition

  • Enterprise: Enhanced Edition (Tair)

Enterprise

SupportedSeriesTypes

object

SupportedSeriesType

array<object>

The instance series types.

array<object>

SeriesType

string

The instance series. Valid values:

  • enhanced_performance_type: Tair (Enterprise Edition) DRAM-based instance

  • hybrid_storage: Redis Open-Source Edition hybrid-storage instance

enhanced_performance_type

SupportedEngineVersions

object

SupportedEngineVersion

array<object>

The available engine versions.

array<object>

Version

string

The engine version of the instance.

5.0

SupportedArchitectureTypes

object

SupportedArchitectureType

array<object>

The available architectures.

array<object>

Architecture

string

The architecture of the instance. Valid values:

  • standard: standard architecture

  • cluster: cluster architecture

  • rwsplit: read/write splitting architecture

cluster

SupportedShardNumbers

object

SupportedShardNumber

array<object>

The numbers of available shards.

array<object>

ShardNumber

string

The number of shards.

8

SupportedNodeTypes

object

SupportedNodeType

array<object>

The supported node types.

array<object>

The supported node type.

SupportedNodeType

string

The node type of the instance. Valid values:

  • single: standalone

  • double: master-replica

double

AvailableResources

object

AvailableResource

array<object>

The available instance types.

object

The available instance type.

InstanceClassRemark

string

The description of the instance type.

16G集群版(8节点)(QPS:1920000 Connections:240000)

Capacity

integer

The memory size of the instance. Unit: MB.

16384

InstanceClass

string

The code of the instance type. If you want to view the code of an instance type, you can search for the code of the instance type in Help Center.

redis.amber.logic.sharding.2g.8db.0rodb.24proxy.multithread

IsMainSale

boolean

An internal parameter.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "493B7308-D9C2-55F6-B042-0313BD63****",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-h",
        "ZoneName": "杭州 可用区H",
        "RegionId": "cn-hangzhou",
        "SupportedEngines": {
          "SupportedEngine": [
            {
              "Engine": "Redis",
              "SupportedEditionTypes": {
                "SupportedEditionType": [
                  {
                    "EditionType": "Enterprise",
                    "SupportedSeriesTypes": {
                      "SupportedSeriesType": [
                        {
                          "SeriesType": "enhanced_performance_type",
                          "SupportedEngineVersions": {
                            "SupportedEngineVersion": [
                              {
                                "Version": "5.0",
                                "SupportedArchitectureTypes": {
                                  "SupportedArchitectureType": [
                                    {
                                      "Architecture": "cluster",
                                      "SupportedShardNumbers": {
                                        "SupportedShardNumber": [
                                          {
                                            "ShardNumber": "8",
                                            "SupportedNodeTypes": {
                                              "SupportedNodeType": [
                                                {
                                                  "SupportedNodeType": "double",
                                                  "AvailableResources": {
                                                    "AvailableResource": [
                                                      {
                                                        "InstanceClassRemark": "16G集群版(8节点)(QPS:1920000 Connections:240000)",
                                                        "Capacity": 16384,
                                                        "InstanceClass": "redis.amber.logic.sharding.2g.8db.0rodb.24proxy.multithread"
                                                      }
                                                    ]
                                                  }
                                                }
                                              ]
                                            }
                                          }
                                        ]
                                      }
                                    }
                                  ]
                                }
                              }
                            ]
                          }
                        }
                      ]
                    }
                  }
                ]
              }
            }
          ]
        },
        "IsMainSale": true
      }
    ]
  }
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.