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

Cambia el tipo de pool privado para una instancia de Elastic Compute Service (ECS).

Descripción de la operación

Se genera un pool privado después de crear una garantía de elasticidad o una reserva de capacidad. El pool privado se asocia con información sobre las instancias que lo utilizan. Puede especificar si desea usar un pool privado al crear una instancia de ECS para asociar la instancia con la garantía de elasticidad o la reserva de capacidad correspondiente.

Después de llamar a esta operación para modificar los atributos del pool privado de una instancia de ECS, no es necesario reiniciar la instancia para que los cambios surtan efecto.
Cuando llama a las siguientes operaciones en una instancia de ECS, el sistema intenta asociar la instancia con pools privados activos. Si la instancia ya está asociada a un pool privado específico, la llamada a la operación puede fallar cuando se agota la capacidad del pool privado o este caduca. Si la llamada falla, llame a la operación ModifyInstanceAttachmentAttributes para cambiar el tipo de pool privado a Open.
- StartInstance: inicia una instancia de ECS que está detenida en modo económico.
- ReActivateInstances: reactiva una instancia de ECS que ha caducado o ha sido recuperada debido a un pago vencido.
- ModifyInstanceChargeType: cambia el método de facturación de una instancia de ECS.
- ModifyPrepayInstanceSpec: cambia el tipo de instancia de una instancia de ECS.
- ReplaceSystemDisk: reemplaza el sistema operativo de una instancia de ECS.

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:ModifyInstanceAttachmentAttributes

update

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región del pool privado. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
InstanceId	string	Sí	El ID de la instancia cuyos atributos de pool privado desea modificar.	i-bp67acfmxazb4****
PrivatePoolOptions.MatchCriteria	string	Sí	El nuevo tipo de pool privado. Valores válidos: Open: pool privado abierto. El sistema asocia la instancia con un pool privado abierto. Si no existen pools privados abiertos coincidentes, el sistema utiliza recursos del pool público para iniciar la instancia. Target: pool privado especificado. El sistema utiliza la capacidad de un pool privado especificado para iniciar la instancia. Si el pool privado especificado no está disponible, la instancia no se puede iniciar. Debe usar `PrivatePoolOptions.Id` para especificar el ID de un pool privado. None: sin pool privado. No se utiliza la capacidad de los pools privados para iniciar la instancia.	Open
PrivatePoolOptions.Id	string	No	El ID del pool privado. Establezca el valor como el ID de la garantía de elasticidad o la reserva de capacidad que genera el pool privado. Este parámetro es obligatorio cuando `PrivatePoolOptions.MatchCriteria` se establece en `Target`. Este parámetro debe estar vacío cuando `PrivatePoolOptions.MatchCriteria` se establece en `Open` o `None`.	eap-bp67acfmxazb4****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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.	The RegionId parameter is required.
400	MissingParameter.InstanceId	The specified InstanceId should not be null.
400	InvalidResourcePackage.BizStatus	The resource package business status is not supported.
400	InvalidInstanceId.MalFormed	The specified InstanceId is not valid.
400	DedicatedHostNotSupported	DedicatedHost is not supported for PrivatePool.	The private pool does not support dedicated hosts.
400	SpotNotSupported	Spot is not supported for PrivatePool.	The private pool does not support spot instances.
400	ClassicNetworkNotSupported	Classic network is not supported for PrivatePool.	The private pool does not support instances in the classic network.
400	Invalid.InstanceId	Instance does not exist.	The specified instance does not exist.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	The operation is not supported while the PrivatePoolOptions.MatchCriteria parameter is set to Target.
400	MissingParameter.PrivatePoolOptions.Id	The specified PrivatePoolOptions.Id should not be null.	The PrivatePoolOptions.Id parameter is required.
400	Invalid.PrivatePoolOptions.Id	The PrivatePool does not exist.	The private pool does not exist.
400	Invalid.InstanceType	The InstanceType does not match the PrivatePool.	The instance type and the private pool do not match.
400	Invalid.InstanceChargeType	The InstanceChargeType does not match the PrivatePool.	The instance billing method and the private pool do not match.
400	Invalid.ZoneId	The ZoneId does not match the PrivatePool.	The zone and the private pool do not match.
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	The capacity of the specified private pool (elastic assurance, capacity reservation) has been used up.
400	InvalidPlatform.ValueNotSupported	The Platform does not match the PrivatePool.	The specified Platform parameter does not match the private pool.
400	Invalid.PrivatePoolOptions.status	The PrivatePool is expired or inactive.	The private pool has expired or is not activated.
400	InvalidAliUid	The PrivatePool does not belong to the user of the Instance.	The specified private pool does not belong to the user who attempted to create the instance.
400	MissingParameter.PackageType	The specified parameter "PackageType" can not be empty.	The required parameter PackageType cannot be empty.
400	MissingParameter.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" can not be empty.	Specifies that the parameter "PrivatePoolOptions.ids" cannot be empty.
400	MissingParameter.InstanceCpuCoreCount	The specified parameter "InstanceCpuCoreCount" can not be empty.	The specified parameter 'InstanceCpuCocount' cannot be empty.
400	MissingParameter.InstanceAmount	The specified parameter "InstanceAmount" can not be empty.	The specified parameter InstanceAmount cannot be empty.
400	MissingParameter.InstanceCpuCoreCountOrInstanceAmount	The specified parameter "InstanceCpuCoreCount" and "InstanceAmount" must not be empty at the same time.	The specified parameter InstanceCpuCoreCount and InstanceAmount cannot be both empty.
400	Invalid.TooManyPrivatePoolOptions.Ids	Too many PrivatePoolOptions.Ids in this request.	The number of specified private pool IDs exceeds the upper limit.
400	Invalid.TooManyZoneIds	Too many ZoneIds in the request.	The number of specified zone IDs exceeds the upper limit.
400	Invalid.TooManyInstanceTypes	Too many InstanceTypes in the request.	The number of specified instance types exceeds the upper limit.
400	Invalid.TooManyUnpaidPrivatePool	Too many PrivatePools create but still unpaid.	Multiple private pools are created but not paid.
400	Invalid.InstanceCpuCoreCountOrInstanceAmount	Both InstanceCpuCoreCount and InstanceAmount are provided.	The InstanceCpuCoreCount and InstanceAmount parameters cannot be both specified.
400	Invalid.PrivatePoolOptions.Ids	The specified parameter "PrivatePoolOptions.Ids" exist invalid element Id.	The specified private pool ID does not exist.
400	Invalid.PackageType	The specified parameter "PackageType" is invalid.	The specified parameter PackageType is invalid.
400	Invalid.PrivatePool.Purchase	The PrivatePool has already paid.	The private pool is already paid.
400	Invalid.AssuranceTimes.NotSupported	The value of AssuranceTimes is not supported.	The specified AssuranceTimes parameter is invalid.
400	RepeatStartPrivatePool	PrivatePool has already been started.	The private pool is already started.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	An internal error has occurred. Try again later.
500	InvalidRegionId.NotFound	The specified RegionId does not exist.
403	InvalidOperation.PrePaidInstanceUnsupported	Not support to modify the private pool options of prepay instances.

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.