DescribeInstanceTypes - ENS - Centro de documentación de Alibaba Cloud

Consulta la lista de tipos de instancia mediante una llamada a DescribeInstanceTypes.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

ens:DescribeInstanceTypes

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
InstanceType	string	No	El tipo de instancia.	ens.sn1.small

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
Code	integer	El código de negocio. Un valor de 0 indica que la operación se realizó correctamente. Se devuelve un código de error en caso de fallo.	0
InstanceTypes	object
InstanceType	array<object>	La colección de tipos de instancia.
	object	La información del tipo de instancia.
CpuCoreCount	integer	El número de núcleos de vCPU.	2
InstanceTypeId	string	Este parámetro no se utiliza actualmente.	Este parámetro no está en uso
InstanceTypeName	string	El nombre del tipo de instancia.	ens.xxx.small
MemorySize	integer	El tamaño de memoria. Unidad: MB.	8192
InstanceBandwidthRx	integer	El ancho de banda de entrada máximo de la instancia en la red interna. Unidad: Kbit/s.	1024
InstanceBandwidthTx	integer	El ancho de banda de salida máximo de la instancia en la red interna. Unidad: Kbit/s.	1024
InstanceType	string	The instance type.	ens.sn1.small
RequestId	string	El ID de la solicitud.	D452D190-BADF-5D09-910D-599B96D42AAA

Ejemplos

Respuesta exitosa

JSON Formato

{
  "Code": 0,
  "InstanceTypes": {
    "InstanceType": [
      {
        "CpuCoreCount": 2,
        "InstanceTypeId": "This parameter is not in use.",
        "InstanceTypeName": "ens.xxx.small",
        "MemorySize": 8192,
        "InstanceBandwidthRx": 1024,
        "InstanceBandwidthTx": 1024,
        "InstanceType": "ens.sn1.small"
      }
    ]
  },
  "RequestId": "D452D190-BADF-5D09-910D-599B96D42AAA"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter	The input parameter domainName that is mandatory for processing this request is not supplied.
400	InstanceIdNotFound	The input parameter instancdId that is not found.	The specified instance ID does not exist.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.
400	CallInterface	Call Interface Happen Error.	An error occurred when you call the operation.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.