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

Renueva una instancia de suscripción de Elastic Compute Service (ECS). Puede especificar un período de renovación o renovar la instancia a una fecha de vencimiento unificada.

Descripción de la operación

Antes de usar esta operación, asegúrese de comprender completamente los métodos de facturación y precios de Elastic Compute Service.

Asegúrese de que el saldo de su cuenta o el límite de crédito sea suficiente.
Solo se admiten las instancias de suscripción. Si se invoca esta operación para instancias de pago por uso, se devuelve un error.
Debe especificar los parámetros del período de renovación (Period y PeriodUnit) o el parámetro de la fecha de vencimiento unificada (ExpectedRenewDay), pero no ambos.

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

update

*Instance.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ClientToken	string	No	El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero asegúrese de que el token sea único entre diferentes solicitudes. El valor de ClientToken solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	Sí	El ID de la instancia que desea renovar.	i-bp67acfmxazb4p****
Period	integer	No	El período de renovación de la instancia de suscripción. Si especifica DedicatedHostId, el valor de Period no puede superar el período de suscripción restante del host dedicado. Valores válidos: Si PeriodUnit se establece en Month, los valores válidos de Period son: 1, 2, 3, 4, 5, 6, 7, 8, 9 y 12. Nota Debe especificar los parámetros del período de renovación (Period y PeriodUnit) o el parámetro de la fecha de vencimiento unificada (ExpectedRenewDay), pero no ambos.	1
PeriodUnit	string	No	La unidad del período de renovación. Este parámetro especifica la unidad del parámetro Period. Valores válidos: Month. Valor predeterminado: Month.	Month
ExpectedRenewDay	integer	No	El día en el que se renueva la instancia a una fecha de vencimiento unificada. Valores válidos: 1 a 28. Para usar este parámetro, primero debe establecer una fecha de vencimiento unificada para las instancias de ECS. El valor de este parámetro debe coincidir con la fecha de vencimiento unificada que estableció. De lo contrario, la llamada falla. Nota Debe especificar los parámetros del período de renovación (Period y PeriodUnit) o el parámetro de la fecha de vencimiento unificada (ExpectedRenewDay), pero no ambos.	5

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
OrderId	string	El ID del pedido.	1234567890
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "OrderId": "1234567890",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	El método de facturación de red especificado no es válido.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	El método de facturación de instancia especificado no existe.
400	InvalidRebootTime.Malformed	The specified RebootTime is not valid.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	La hora de reinicio especificada no es válida.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Los parámetros de la solicitud no coinciden con la solicitud que tiene el mismo ClientToken.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	El ClientToken especificado no es válido.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	El tipo de instancia especificado no es válido porque está fuera del rango disponible.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	El valor especificado para InstanceType no es válido.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	El InternetChargeType especificado no es compatible con esta instancia.
400	InvalidPeriod	The specified period is not valid.	El período de tiempo especificado no es válido.
400	MissingParamter	The specified parameter "Period" is not null.	El parámetro Period no puede estar vacío.
400	Upgrade.NotSupported	Upgrade operation is not supported.	La operación de actualización no es válida.
400	OperationDenied	Specified instance is in VPC.	La instantánea especificada no permite la creación de volúmenes de datos.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	El tipo de instancia actual no se puede cambiar al tipo de instancia especificado.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	El parámetro especificado PeriodUnit no es válido.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	El host dedicado especificado no existe.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	El estado actual del host dedicado no admite esta operación.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	El estado actual del recurso no admite esta operación.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	La instancia se está actualizando. Inténtelo de nuevo más tarde.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	El período de renovación especificado no puede exceder el período de validez máximo. Reduzca el período de renovación e inténtelo de nuevo.
400	LastOrderProcessing	The previous order is still processing, please try again later.	El pedido se está procesando. Inténtelo de nuevo más tarde.
400	Idempotence.Processing	The previous request is still processing, please try again later.	La solicitud se está procesando. Inténtelo de nuevo más tarde.
400	InvalidLoanOrderStatus.Uncompleted	Any unpaid order must be cancelled before you try this action again. The scheduled unpaid order is a loan order that cannot be auto cancelled. For more information, visit the loan management center.
400	OperationDenied.UnfinishedOrder	The current instance has unfinished refundOrder, this operation is denied.	La instancia tiene una orden de reembolso incompleta. Espere un momento e inténtelo de nuevo más tarde.
400	InvalidPeriod.NotFound	The specified period and expectedRenewDay cannot both be empty.
400	InvalidExpectedRenewDay.StarterPackageNotSupported	The specified starterPackage cannot support renew with expectedRenewDay.
400	InvalidParam.ExpectedRenewDay	The specified param ExpectedRenewDay is not valid.
400	QuotaExceed.AlignInstance	The maximum number of align operations is exceeded.
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.
400	OperationDenied.AbnormalInstanceInfo	The current renewable operation is not supported due to abnormal information of the instance, please submit ticket to process.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	Esta operación requiere permisos de precios. Solicite los permisos a su cuenta principal o configure el parámetro AutoPay en true para realizar el pago automático.
400	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.	La instancia basada en la arquitectura de red clásica ya no se puede renovar. Debe completar la migración a una VPC antes de poder realizar una renovación normal.
500	InternalError	The request processing has failed due to some unknown error.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	El disco especificado no se puede transformar en un disco extraíble debido a restricciones del tipo de disco. Un disco que no se puede desinstalar no es elegible para esta operación.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	La instancia especificada está reservada debido a un cambio de especificaciones y no puede surtir efecto durante el período de contrato actual.
403	LastTokenProcessing	The last token request is processing.
403	Instance.UnPaidOrder	The specified instance has unpaid order.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	La instancia a la que está conectado el disco está bloqueada por motivos de seguridad.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Esta operación no es compatible con instancias de este tipo de facturación.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	La categoría de disco especificada no existe en la zona o clúster especificado, o la zona especificada no coincide con el clúster.
403	OperationDenied.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Las instancias que participan en la promoción de paquetes de nivel básico solo se pueden configurar con renovación automática mensual.
403	RenewDateNotSupported.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed three days before it expires.
403	PrePaidInstance.Expired	The prePaid instance has expired.	La instancia de suscripción ha caducado.
403	Forbidden.RiskControl	This operation is forbidden by Aliyun RiskControl system.	La operación está prohibida por el sistema de gobernanza de riesgos.
404	InvalidDiskId.NotFound	The specified disk does not exist.	El disco especificado no existe. Verifique si el ID del disco es correcto.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	La instancia especificada no existe. Verifique si el ID de la instancia es correcto.

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.