DescribeElasticityAssurances - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta los detalles de una garantía de elasticidad. Por ejemplo, puede consultar el estado, el modo de coincidencia, el modo de entrada en vigor, la hora de vencimiento y el número de instancias utilizadas de una garantía de elasticidad.

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

ecs:DescribeElasticityAssurances

get

*ElasticityAssurance.

acs:ecs:{#regionId}:{#accountId}:elasticityassurance/*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región a la que pertenece la garantía de elasticidad. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
ResourceGroupId	string	No	El ID del grupo de recursos. Cuando utiliza este parámetro para filtrar recursos, la cantidad de recursos no puede superar los 1,000. Nota No se admite el filtrado por el grupo de recursos predeterminado.	rg-bp67acfmxazb4p****
Tag	array<object>	No	La lista de pares clave-valor de etiquetas vinculados a la garantía de elasticidad.
	object	No	La información de la etiqueta.
Key	string	No	La clave de la etiqueta. N indica que puede establecer varias claves de etiqueta para el filtrado. Valores válidos de N: 1 a 20. Si utiliza una sola etiqueta para filtrar recursos, la cantidad de recursos con esta etiqueta no puede superar los 1,000. Si utiliza varias etiquetas para filtrar recursos, la cantidad de recursos que tienen asignadas todas las etiquetas especificadas no puede superar los 1,000. Si la cantidad de recursos supera los 1,000, llame a la operación ListTagResources para consultar los recursos.	TestKey
Value	string	No	El valor de la etiqueta. N indica que puede especificar varios valores de etiqueta para el filtrado. Valores válidos de N: 1 a 20.	TestValue
MaxResults	integer	No	El número máximo de entradas por página para una consulta paginada. Valor máximo: 100. Valor predeterminado: 10.	10
NextToken	string	No	El token de paginación para la consulta de garantía de elasticidad. Obtenga este valor del resultado de la solicitud anterior.	caeba0bbb2be03f84eb48b699f0a4883
PrivatePoolOptions.Ids	string	No	La lista de ID de garantías de elasticidad. El valor puede ser una matriz JSON que consta de hasta 100 ID. Separe varios ID con comas (,).	["eap-bp67acfmxazb4**", "eap-bp67acfmxazb5**"]
Platform	string	No	Nota Este parámetro está obsoleto.	null
InstanceType	string	No	El tipo de instancia. Puede utilizar el tipo de instancia para consultar solo las garantías de elasticidad activas. Las garantías de elasticidad liberadas solo se pueden consultar mediante PrivatePoolOptions.Ids.	ecs.c6.large
ZoneId	string	No	El ID de la zona en la región a la que pertenece la garantía de elasticidad.	cn-hangzhou-h
InstanceChargeType	string	No	El método de facturación de la instancia. Valores válidos: PostPaid. Solo se admite el método de pago por uso. Valor predeterminado: PostPaid.	PostPaid
Status	string	No	El estado de la garantía de elasticidad. Valores válidos: All: todos los estados. Deactived: por activar. Este estado se encuentra en vista previa por invitación. Preparing: en preparación. Prepared: por entrar en vigor. Active: en vigor. Released: liberada. Si no especifica este parámetro, se consultan las garantías de elasticidad en todos los estados excepto Pending y Released.	Active
PackageType	string	No	El tipo de garantía de elasticidad. Valores válidos: ElasticityAssurance: garantía de elasticidad estándar. Este es el tipo cuando no se especifica RecurrenceRules. TimeDivisionElasticityAssurance: garantía de elasticidad de división de tiempo. Este es el tipo cuando se especifica RecurrenceRules.	ElasticityAssurance

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
NextToken	string	El token de paginación para la siguiente consulta.	caeba0bbb2be03f84eb48b699f0a4883
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCount	integer	El número total de entradas que coinciden con las condiciones de la consulta.	1
MaxResults	integer	El número máximo de entradas por página para la garantía de elasticidad.	10
ElasticityAssuranceSet	object
ElasticityAssuranceItem	array<object>	La colección de detalles de la garantía de elasticidad.
	array<object>	Los detalles de la garantía de elasticidad.
Status	string	El estado de la garantía de elasticidad. Valores válidos: Preparing: en preparación. Prepared: por entrar en vigor. Active: en vigor. Released: liberada.	Active
PrivatePoolOptionsMatchCriteria	string	El modo de coincidencia de la garantía de elasticidad. Valores válidos: Open: modo abierto. El sistema hace coincidir automáticamente la capacidad de los pools privados abiertos cuando se inician las instancias. Si no hay capacidad de pool privado coincidente disponible, se utilizan los recursos del pool público para iniciar las instancias. Target: modo dirigido. Las instancias se inician utilizando la capacidad del pool privado especificado. Si la capacidad del pool privado especificado no está disponible, las instancias no se inician.	Target
PrivatePoolOptionsId	string	El ID de la garantía de elasticidad.	eap-bp1ir35kqtn8ywci****
UsedAssuranceTimes	integer	Nota Este parámetro no está disponible públicamente.	0
LatestStartTime	string	Nota Este parámetro no está disponible públicamente.	null
PrivatePoolOptionsName	string	El nombre del servicio de la garantía de elasticidad.	eapTestName
RegionId	string	El ID de la región a la que pertenece la garantía de elasticidad.	cn-hangzhou
EndTime	string	La hora de vencimiento de la garantía de elasticidad. La hora se expresa en el estándar ISO 8601 en formato UTC.	2021-12-03T16:00Z
StartTime	string	El período de vigencia de la garantía de elasticidad. La hora se expresa en formato ISO 8601 en UTC.	2020-12-03T05:25Z
Description	string	La descripción de la garantía de elasticidad.	Esta es la descripción
ResourceGroupId	string	El ID del grupo de recursos.	rg-bp67acfmxazb4p****
TotalAssuranceTimes	string	El número total de veces que se aplica la garantía de elasticidad. Actualmente, solo se admite el modo ilimitado dentro del período de vigencia.	Unlimited
AllocatedResources	object
AllocatedResource	array<object>	La lista de detalles de asignación de recursos.
	array<object>	Los detalles de asignación de recursos.
UsedAmount	integer	El número de instancias utilizadas.	2
TotalAmount	integer	El número total de instancias que se reservarán para un solo tipo de instancia.	2
AvailableAmount	integer	Nota Este parámetro no está disponible públicamente.	5
FailedAmount	integer	La capacidad fallida.	1
LockedAmount	integer	La capacidad bloqueada.	1
zoneId	string	El ID de la zona en la región a la que pertenece la garantía de elasticidad.	cn-hangzhou-h
InstanceType	string	El tipo de instancia.	ecs.c6.large
ElasticityAssuranceUsages	object
ElasticityAssuranceUsage	array<object>	Nota Este parámetro no está disponible públicamente.
	object	Nota Este parámetro no está disponible públicamente.
AccountId	string	Nota Este parámetro no está disponible públicamente.	1144775968548340
ServiceName	string	Nota Este parámetro no está disponible públicamente.	name
UsedAmount	integer	Nota Este parámetro no está disponible públicamente.	1
Tags	object
Tag	array<object>	La lista de pares clave-valor de etiquetas vinculados a la garantía de elasticidad.
	object	La información del par clave-valor de la etiqueta vinculada a la garantía de elasticidad.
TagValue	string	El valor de la etiqueta.	TestValue
TagKey	string	La clave de la etiqueta.	TestKey
InstanceChargeType	string	El método de facturación de la instancia. Actualmente, solo se admite el método de pago por uso. Valores válidos: PostPaid.	PostPaid
StartTimeType	string	El modo de entrada en vigor de la garantía de elasticidad. Valores válidos: Now: entra en vigor inmediatamente. Later: entra en vigor en una hora especificada.	Now
ElasticityAssuranceOwnerId	string	Nota Este parámetro no está disponible públicamente.	e114477596854834
RecurrenceRules	object
RecurrenceRule	array<object>	La lista de reglas de recurrencia para la garantía de elasticidad de división de tiempo.
	object	La regla de recurrencia para la garantía de elasticidad de división de tiempo.
RecurrenceType	string	El tipo de política de la regla de recurrencia. Valores válidos: Daily: recurrencia diaria. Weekly: recurrencia semanal. Monthly: recurrencia mensual.	Daily
RecurrenceValue	string	El valor de la regla de recurrencia. Valores válidos: Si RecurrenceType se establece en Daily, solo se puede especificar un valor. Valores válidos: 1 a 31. El valor indica el intervalo en días. Si RecurrenceType se establece en Weekly, se pueden especificar varios valores y separarlos con comas (,). Los valores para el domingo, lunes, martes, miércoles, jueves, viernes y sábado son 0, 1, 2, 3, 4, 5 y 6. Por ejemplo, 1,2 indica lunes y martes. Si RecurrenceType se establece en Monthly, el formato es A-B. Valores válidos de A y B: 1 a 31. B debe ser mayor o igual que A. Por ejemplo, 1-5 indica del día 1 al 5 de cada mes.	1
StartHour	integer	El período de vigencia de la garantía de división de tiempo.	4
EndHour	integer	La hora de finalización de la garantía de división de tiempo.	10
PackageType	string	El tipo de garantía de elasticidad. Valores válidos: ElasticityAssurance: garantía de elasticidad estándar. TimeDivisionElasticityAssurance: garantía de elasticidad de división de tiempo.	ElasticityAssurance

Ejemplos

Respuesta exitosa

JSON Formato

{
  "NextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 1,
  "MaxResults": 10,
  "ElasticityAssuranceSet": {
    "ElasticityAssuranceItem": [
      {
        "Status": "Active",
        "PrivatePoolOptionsMatchCriteria": "Target",
        "PrivatePoolOptionsId": "eap-bp1ir35kqtn8ywci****",
        "UsedAssuranceTimes": 0,
        "LatestStartTime": "null",
        "PrivatePoolOptionsName": "eapTestName",
        "RegionId": "cn-hangzhou",
        "EndTime": "2021-12-03T16:00Z",
        "StartTime": "2020-12-03T05:25Z",
        "Description": "Esta es la descripción",
        "ResourceGroupId": "rg-bp67acfmxazb4p****",
        "TotalAssuranceTimes": "Unlimited",
        "AllocatedResources": {
          "AllocatedResource": [
            {
              "UsedAmount": 2,
              "TotalAmount": 2,
              "AvailableAmount": 5,
              "FailedAmount": 1,
              "LockedAmount": 1,
              "zoneId": "cn-hangzhou-h",
              "InstanceType": "ecs.c6.large",
              "ElasticityAssuranceUsages": {
                "ElasticityAssuranceUsage": [
                  {
                    "AccountId": "1144775968548340",
                    "ServiceName": "nombre",
                    "UsedAmount": 1
                  }
                ]
              }
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagValue": "ValorDePrueba",
              "TagKey": "ClaveDePrueba"
            }
          ]
        },
        "InstanceChargeType": "PostPaid",
        "StartTimeType": "Now",
        "ElasticityAssuranceOwnerId": "e114477596854834",
        "RecurrenceRules": {
          "RecurrenceRule": [
            {
              "RecurrenceType": "Daily",
              "RecurrenceValue": "1",
              "StartHour": 4,
              "EndHour": 10
            }
          ]
        },
        "PackageType": "ElasticityAssurance"
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	MissingParameter.RegionId	The specified RegionId should not be null.	El parámetro RegionId no puede estar vacío.
400	InvalidParameter.Name	The specified PrivatePoolOptions.Name is invalid.
400	InvalidParameter.PrivatePoolOptions.Ids	The specified PrivatePoolOptions.Ids is invalid.
400	DedicatedHostNotSupported	DedicatedHost is not supported for PrivatePool.	Los pools privados no admiten hosts dedicados.
400	SpotNotSupported	Spot is not supported for PrivatePool.	Los pools privados no admiten instancias spot.
400	ClassicNetworkNotSupported	Classic network is not supported for PrivatePool.	Los pools privados no admiten instancias de tipo de red clásica.
400	Invalid.InstanceId	Instance does not exist.	La instancia no coincide con ningún pool privado.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	El parámetro PrivatePoolOptions.MatchCriteria especificado no coincide con el pool privado.
400	MissingParameter.PrivatePoolOptions.Id	The specified PrivatePoolOptions.Id should not be null.	El parámetro PrivatePoolOptions.Id no puede estar vacío.
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.	El pool privado no existe.
400	Invalid.InstanceType	The InstanceType does not match the PrivatePool.	El tipo de instancia no coincide con el pool privado.
400	Invalid.InstanceChargeType	The InstanceChargeType does not match the PrivatePool.	El parámetro InstanceChargeType especificado no es válido.
400	Invalid.ZoneId	The ZoneId does not match the PrivatePool.	La zona no coincide con el pool privado.
400	Invalid.PrivatePoolOptions.status	The PrivatePool has been used up.	El estado del pool privado especificado no es válido.
400	InvalidPlatform.ValueNotSupported	The Platform does not match the PrivatePool.	El parámetro Platform especificado no coincide con el pool privado.
400	InvalidAliUid	The PrivatePool does not belong to the user of the Instance.	El pool privado no pertenece al usuario que está creando la instancia.
400	MissingParameter.PackageType	The specified parameter "PackageType" can not be empty.	El parámetro PackageType no puede estar vacío.
400	MissingParameter.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" can not be empty.	El parámetro especificado PrivatePoolOptions.ids no puede estar vacío.
400	MissingParameter.InstanceCpuCoreCount	The specified parameter "InstanceCpuCoreCount" can not be empty.	El parámetro especificado InstanceCpuCocount no puede estar vacío.
400	MissingParameter.InstanceAmount	The specified parameter "InstanceAmount" can not be empty.	El parámetro especificado InstanceAmount no puede estar vacío.
400	MissingParameter.InstanceCpuCoreCountOrInstanceAmount	The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.	Los parámetros InstanceCpuCoreCount e InstanceAmount no pueden estar vacíos simultáneamente.
400	Invalid.TooManyPrivatePoolOptions.Ids	Too many PrivatePoolOptions.Ids in this request.	El parámetro PrivatePoolOptions.Ids supera el límite superior.
400	Invalid.TooManyZoneIds	Too many ZoneIds in the request.	El parámetro ZoneIds supera el límite superior.
400	Invalid.TooManyInstanceTypes	Too many InstanceTypes in the request.	El parámetro InstanceTypes supera el límite superior.
400	Invalid.TooManyUnpaidPrivatePool	Too many PrivatePools create but still unpaid.	No se han pagado múltiples pools privados.
400	Invalid.InstanceCpuCoreCountOrInstanceAmount	Both InstanceCpuCoreCount and InstanceAmount are provided.	Los parámetros InstanceCpuCoreCount e InstanceAmount no necesitan especificarse al mismo tiempo.
400	Invalid.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.	El ID de pool privado especificado no existe.
400	Invalid.PackageType	The specified parameter "PackageType" is invalid.	El parámetro PackageType especificado no es válido.
400	Invalid.PrivatePool.Purchase	The PrivatePool has already paid.	El pool privado ya está pagado.
400	Invalid.AssuranceTimes.NotSupported	The value of AssuranceTimes is not supported.	El valor del parámetro AssuranceTimes no es compatible.
400	RepeatStartPrivatePool	PrivatePool has already been started.	El pool privado ya se ha iniciado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo.
404	InvalidResourceGroup.NotFound	The specified resource group is not found.	No se encuentra el grupo de recursos en los registros.

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.