Todos os produtos
Search
Central de documentação

:Consultar especificações disponíveis para uma instância

Última atualização: Jun 26, 2026

Chame a operação DescribeAvailableClasses para consultar as especificações compatíveis com uma instância. As especificações incluem tipos de instância e intervalo de capacidade de armazenamento.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim DescribeAvailableClasses

Operação a ser executada. Defina o valor como DescribeAvailableClasses.

RegionId String Sim cn-hangzhou

ID da região da instância. Chame a operação DescribeDBInstanceAttribute para consultar esse ID.

ZoneId String Sim cn-hangzhou-h

ID da zona da instância. Chame a operação DescribeDBInstanceAttribute para consultar esse ID.

Nota Se a operação DescribeDBInstanceAttribute retornar várias zonas, especifique apenas uma delas. Por exemplo, se o retorno for cn-hangzhou-MAZ9(g,h), defina este parâmetro como cn-hangzhou-g ou cn-hangzhou-h.
InstanceChargeType String Sim Prepaid

Método de faturamento da instância. Valores válidos:

  • Prepaid: assinatura
  • Postpaid: pagamento conforme o uso
  • Serverless: serverless
Engine String Sim MySQL

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

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
EngineVersion String Sim 8.0

Versão do mecanismo de banco de dados da instância. Valores válidos:

  • Para Engine definido como MySQL: 5.5, 5.6, 5.7 e 8.0
  • Para Engine definido como SQLServer: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha e 2019_ent
  • Para Engine definido como PostgreSQL: 10.0, 11.0, 12.0, 13.0, 14.0 e 15.0
  • Para Engine definido como MariaDB: 10.3
DBInstanceId String Não rm-uf6wjk5xxxxxx

ID da instância.

OrderType String Não BUY

Tipo do pedido. Defina o valor como BUY.

DBInstanceStorageType String Sim local_ssd

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

  • local_ssd: SSD local (recomendado).
  • cloud_ssd: SSD padrão.
  • cloud_essd: ESSD de nível de desempenho 1 (PL1).
  • cloud_essd2: ESSD de PL2.
  • cloud_essd3: ESSD de PL3.
Category String Sim HighAvailability

Edição do RDS da instância. Valores válidos:

  • Basic: RDS Basic Edition
  • HighAvailability: RDS High-availability Edition

  • AlwaysOn: RDS Cluster Edition para SQL Server
  • Finance: RDS Enterprise Edition
  • serverless_basic: RDS Serverless Basic Edition
CommodityCode String Não bards

Código da mercadoria da instância. Valores válidos:

  • bards: instância primária com pagamento conforme o uso (disponível no site da China - aliyun.com).
  • rds: instância primária por assinatura (disponível no site da China - aliyun.com).
  • rords: instância somente leitura com pagamento conforme o uso (disponível no site da China - aliyun.com).
  • rds_rordspre_public_cn: instância somente leitura por assinatura (disponível no site da China - aliyun.com).
  • bards_intl: instância primária com pagamento conforme o uso (disponível no site Internacional - alibabacloud.com).
  • rds_intl: instância primária por assinatura (disponível no site Internacional - alibabacloud.com).
  • rords_intl: instância somente leitura com pagamento conforme o uso (disponível no site Internacional - alibabacloud.com).
  • rds_rordspre_public_intl: instância somente leitura por assinatura (disponível no site Internacional - alibabacloud.com).
  • rds_serverless_public_cn: instância serverless (disponível no site da China - aliyun.com).
  • rds_serverless_public_intl: instância serverless (disponível no site Internacional - alibabacloud.com).
Nota Especifique este parâmetro se a instância for somente leitura.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC

ID da solicitação.

DBInstanceClasses

Array of DBInstanceClass

Matriz com os detalhes do tipo de instância.

DBInstanceClass

String

rds.mysql.c1.large

Tipo da instância.

DBInstanceStorageRange

Object

Intervalo de capacidade de armazenamento compatível com a instância.

Step

Integer

5

Incremento mínimo para ajuste da capacidade de armazenamento. O incremento mínimo é de 5 GB.

MinValue

Integer

5

Capacidade mínima de armazenamento compatível. Unidade: GB.

MaxValue

Integer

2000

Capacidade máxima de armazenamento compatível. Unidade: GB.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeAvailableClasses
&DBInstanceId=rm-uf6wjk5xxxxxx
&Category=HighAvailability
&DBInstanceStorageType=local_ssd
&Engine=MySQL
&EngineVersion=8.0
&InstanceChargeType=Prepaid
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-h
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAvailableClassesResponse>
<DBInstanceClasses>
    <DBInstanceClass>rds.mysql.c1.large</DBInstanceClass>
    <DBInstanceStorageRange>
        <MinValue>5</MinValue>
        <MaxValue>2000</MaxValue>
        <Step>5</Step>
    </DBInstanceStorageRange>
</DBInstanceClasses>
<DBInstanceClasses>
    <DBInstanceClass>rds.mysql.st.v52</DBInstanceClass>
    <DBInstanceStorageRange>
        <MinValue>1000</MinValue>
        <MaxValue>6000</MaxValue>
        <Step>5</Step>
    </DBInstanceStorageRange>
</DBInstanceClasses>
<RequestId>7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC</RequestId>
</DescribeAvailableClassesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DBInstanceClasses" : [ {
    "DBInstanceClass" : "rds.mysql.c1.large",
    "DBInstanceStorageRange" : {
      "MinValue" : 5,
      "MaxValue" : 2000,
      "Step" : 5
    }
  }, {
    "DBInstanceClass" : "rds.mysql.st.v52",
    "DBInstanceStorageRange" : {
      "MinValue" : 1000,
      "MaxValue" : 6000,
      "Step" : 5
    }
  } ],
  "RequestId" : "7E4448A6-9FE6-4474-A0C1-AA7CFC772CAC"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

ArticleNotFound

Article not found

Nenhum artigo relevante encontrado.

404

InvalidCondition.NotFound

No class found

Condição especificada para a classe disponível inválida.

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