Consulta de tipos de instancia - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación ListClasses para consultar los tipos de instancia disponibles para instancias específicas.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	ListClasses	La operación que desea ejecutar. Establezca el valor en ListClasses.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxx	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el valor, pero debe asegurarse de que el token generado sea único entre las distintas solicitudes. El token solo puede contener caracteres ASCII y no debe exceder los 64 caracteres de longitud.
CommodityCode	String	Sí	bards	El código de producto de las instancias. bards_intl: instancias principales pay-as-you-go. rds_intl: instancias principales suscripción. rords_intl: instancias de solo lectura pay-as-you-go. rds_rordspre_public_intl: instancias de solo lectura suscripción.
DBInstanceId	String	No	rm-uf6wjk5xxxxxxx	El ID de la instancia principal. Puede llamar a la operación DescribeDBInstances para consultar los ID de las instancias. Nota Si utiliza el parámetro CommodityCode para consultar los tipos de instancia disponibles para instancias de solo lectura, debe especificar el parámetro DBInstanceId.
OrderType	String	Sí	BUY	El tipo de pedido que desea consultar. Valores válidos: BUY: consulta pedidos de compra de instancias. UPGRADE: consulta pedidos de cambio de especificaciones de instancias. RENEW: consulta pedidos de renovación de instancias. CONVERT: consulta pedidos de cambio de método de facturación de instancias.
RegionId	String	No	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente. Nota Si utiliza una cuenta de Alibaba Cloud en el sitio internacional (alibabacloud.com), debe especificar el parámetro RegionId.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	CF8D35BF-263D-4F7B-883A-1163B79A9EC6	El ID de la solicitud.
RegionId	String	cn-hangzhou	El ID de región de la instancia.
Items	Array of ClassList		Una matriz que contiene los tipos de instancia disponibles.
MaxIOPS	String	10000	El número máximo de operaciones de entrada/salida por segundo (IOPS) compatible con el tipo de instancia. Unidad: operaciones por segundo.
Cpu	String	1	El número de núcleos compatible con el tipo de instancia. Unidad: núcleos.
ReferencePrice	String	2500	El costo del tipo de instancia. Unidad: centavos (USD). Nota Si establece el parámetro CommodityCode en un valor que indica el método de facturación pay-as-you-go, el parámetro ReferencePrice especifica el costo por hora. Si establece el parámetro CommodityCode en un valor que indica el método de facturación suscripción, el parámetro ReferencePrice especifica el costo mensual.
MaxConnections	String	2000	El número máximo de conexiones compatible con el tipo de instancia. Unidad: conexiones.
MemoryClass	String	1 GB (RDS Basic Edition)	La capacidad de memoria compatible con el tipo de instancia. Unidad: GB.
ClassCode	String	mysql.n1.micro.1	El código del tipo de instancia. Para obtener más información, consulte Tipos de instancia principal de ApsaraDB RDS y Tipos de instancia de solo lectura de ApsaraDB RDS.
ClassGroup	String	General-purpose	La familia de la instancia. Para obtener más información, consulte Familias de instancias.
MaxIOMBPS	String	1024Mbps	El ancho de banda máximo de E/S compatible con el tipo de instancia. Unidad: Mbit/s.
EncryptedMemory	String	4	El tamaño de la memoria cifrada compatible con el tipo de instancia de seguridad mejorada. Unidad: GB.
InstructionSetArch	String	arm	La arquitectura del tipo de instancia. Nota Si la arquitectura del tipo de instancia es x86, se devuelve una cadena vacía de forma predeterminada. Si la arquitectura del tipo de instancia es ARM, se devuelve arm.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 (RDS 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 (RDS 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 (RDS Basic Edition)",
    "ReferencePrice" : "32.6",
    "MaxIOPS" : "10000"
  }, {
    "MaxIOMBPS" : "1024Mbps",
    "ClassCode" : "mysql.n1.micro.1",
    "MaxConnections" : "2000",
    "ClassGroup" : "General-purpose",
    "Cpu" : "1 ",
    "MemoryClass" : " 1 GB (RDS Basic Edition)",
    "ReferencePrice" : "5.2",
    "MaxIOPS" : "10000"
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidSecurityIPList.Duplicate	The Security IP address is not in the available range or occupied.	El mensaje de error devuelto porque la dirección IP especificada está in use o no se encuentra dentro del rango válido. Especifique una dirección IP válida e inténtelo de nuevo.
400	InvalidCommodityCode.Malformed	The commodity code is invalid.	El mensaje de error devuelto porque el código de producto especificado no es válido.
403	Forbidden.Authentication	The operation is forbidden by Aliyun Realname Authentication System.	El mensaje de error devuelto porque esta operación está prohibida por el sistema de verificación de nombre real de Alibaba Cloud.
404	GetCommodity.Failed	Get commodity failed.	El mensaje de error devuelto porque el valor especificado para el parámetro CommodityCode no es válido. Introduzca un valor válido e inténtelo de nuevo.
404	InvalidDBInstanceName.NotFound	Invalid DBInstanceId NotFound.	El mensaje de error devuelto porque no se encuentra el ID de la instancia de base de datos.

Para obtener una lista de códigos de error, visite el Centro de errores de API.