Todos os produtos
Search
Central de documentação

:Consultar tipos de instância

Última atualização: Jul 09, 2026

Chame a operação ListClasses para consultar os detalhes de todos os tipos de instância disponíveis para o ApsaraDB RDS.

Depuração

Execute esta operação diretamente no OpenAPI Explorer para simplificar o cálculo da assinatura e gerar automaticamente código de exemplo do SDK.

Parâmetros da solicitação

Name Type Required Example Description
Action String Yes ListClasses

Parâmetro obrigatório. Defina o valor como ListClasses.

ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxx

Token gerado pelo cliente para garantir a idempotência da solicitação. O token deve ser exclusivo entre diferentes solicitações, conter apenas caracteres ASCII e ter no máximo 64 caracteres.

CommodityCode String Yes bards

Código da mercadoria da instância.

  • bards_intl: instância primária com pagamento conforme o uso
  • rds_intl: instância primária por assinatura
  • rords_intl: instância somente leitura com pagamento conforme o uso
  • rds_rordspre_public_intl: instância somente leitura por assinatura
DBInstanceId String No rm-uf6wjk5xxxxxxx

ID da instância primária. Chame DescribeDBInstances para obter o ID.

Nota Este parâmetro é obrigatório ao especificar o código de mercadoria de uma instância somente leitura no parâmetro CommodityCode.
OrderType String Yes BUY

Tipo de pedido. Valores válidos:

  • BUY: Nova compra.
  • UPGRADE: Upgrade.
  • RENEW: Renovação.
  • CONVERT: Alteração do método de faturamento.
RegionId String No cn-hangzhou

ID da região. Chame DescribeRegions para obter a lista mais recente de regiões.

Nota Este parâmetro é obrigatório para contas do Alibaba Cloud International Website (www.alibabacloud.com).

Dados retornados

Name Type Example Description
RequestId String CF8D35BF-263D-4F7B-883A-1163B79A9EC6

ID da solicitação.

RegionId String cn-hangzhou

ID da região.

Items Array of ClassList

Lista composta pelos detalhes dos tipos de instância.

MaxIOPS String 10000

Número máximo de operações de entrada e saída por segundo (IOPS) do tipo de instância. Unidade: operações/segundo.

Cpu String 1

Número de núcleos de CPU suportados pelo tipo de instância.

ReferencePrice String 2500

Preço do tipo de instância.

  • Unidade: centavos (USD).
Nota
  • Se CommodityCode for um código de mercadoria com pagamento conforme o uso, este parâmetro indica o preço por hora.
  • Se CommodityCode for um código de mercadoria por assinatura, este parâmetro indica o preço mensal.
MaxConnections String 2000

Número máximo de conexões do tipo de instância.

MemoryClass String 1 GB (Basic Edition)

Capacidade de memória do tipo de instância. Unidade: GB.

ClassCode String mysql.n1.micro.1

Código do tipo de instância. Para mais informações, consulte Tipos de instância primária e Tipos de instância somente leitura.

ClassGroup String General-purpose

Família da instância. Para mais informações, consulte Famílias de instâncias.

MaxIOMBPS String 1024Mbps

Largura de banda máxima de E/S do tipo de instância. Unidade: Mbit/s.

EncryptedMemory String 4

Tamanho da memória criptografada do tipo de instância com segurança aprimorada. Unidade: GB.

InstructionSetArch String arm

Arquitetura do tipo de instância. Valores válidos:

  • Instâncias com arquitetura x86 retornam uma string vazia.
  • Instâncias com arquitetura arm retornam arm.

Exemplos

Exemplo de solicitação

http(s)://rds.aliyuncs.com/?Action=ListClasses
&CommodityCode=bards
&OrderType=BUY
&<Common request parameters>

Exemplo de resposta

Formato XML

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

<ListClassesResponse>
<RequestId>CF8D35BF-263D-4F7B-883A-1163B79A9EC6</RequestId>
<Items>
    <MaxIOMBPS>1024Mbps</MaxIOMBPS>
    <ClassCode>mysql.n2.medium.1</ClassCode>
    <MaxConnections>4000</MaxConnections>
    <ClassGroup>General-purpose</ClassGroup>
    <Cpu>2 </Cpu>
    <MemoryClass> 4 GB (Basic Edition)</MemoryClass>
    <ReferencePrice>32.6</ReferencePrice>
    <MaxIOPS>10000</MaxIOPS>
</Items>
<Items>
    <MaxIOMBPS>1024Mbps</MaxIOMBPS>
    <ClassCode>mysql.n1.micro.1</ClassCode>
    <MaxConnections>2000</MaxConnections>
    <ClassGroup>General-purpose</ClassGroup>
    <Cpu>1 </Cpu>
    <MemoryClass> 1 GB (Basic Edition)</MemoryClass>
    <ReferencePrice>5.2</ReferencePrice>
    <MaxIOPS>10000</MaxIOPS>
</Items>
</ListClassesResponse>

Formato JSON

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

{
  "RequestId" : "CF8D35BF-263D-4F7B-883A-1163B79A9EC6",
  "Items" : [ {
    "MaxIOMBPS" : "1024Mbps",
    "ClassCode" : "mysql.n2.medium.1",
    "MaxConnections" : "4000",
    "ClassGroup" : "General-purpose",
    "Cpu" : "2 ",
    "MemoryClass" : " 4 GB (Basic Edition)",
    "ReferencePrice" : "32.6",
    "MaxIOPS" : "10000"
  }, {
    "MaxIOMBPS" : "1024Mbps",
    "ClassCode" : "mysql.n1.micro.1",
    "MaxConnections" : "2000",
    "ClassGroup" : "General-purpose",
    "Cpu" : "1 ",
    "MemoryClass" : " 1 GB (Basic Edition)",
    "ReferencePrice" : "5.2",
    "MaxIOPS" : "10000"
  } ]
}

Códigos de erro

HttpCode

Error code

Error message

Description

400

InvalidSecurityIPList.Duplicate

The Security IP address is not in the available range or occupied.

O endereço IP especificado já está em uso ou não está no intervalo válido. Defina outro endereço IP.

400

InvalidCommodityCode.Malformed

The commodity code is invalid.

O código da mercadoria é inválido.

403

Forbidden.Authentication

The operation is forbidden by Aliyun Realname Authentication System.

Falha na operação: proibida pelo sistema de verificação de identidade do Alibaba Cloud.

404

GetCommodity.Failed

Get commodity failed.

Falha ao obter as informações da mercadoria. O parâmetro CommodityCode é inválido. Verifique o parâmetro.

404

InvalidDBInstanceName.NotFound

Invalid DBInstanceId NotFound.

O ID da instância de banco de dados não existe. Verifique o ID.

Para mais informações, consulte o Error Center.