ModifyInstanceChargeType - - Centro de documentación de Alibaba Cloud

Cambia el método de facturación de una o más instancias de Elastic Compute Service (ECS). Puede cambiar el método de facturación de las instancias entre pay-as-you-go y suscripción, o bien cambiar el método de facturación de todos los discos de datos conectados a una instancia de pay-as-you-go a suscripción.

Notas de uso

Antes de llamar a esta operación, asegúrese de comprender los métodos de facturación y la lista de precios de ECS. Para obtener más información, visite la página del producto Elastic Compute Service.

Tome en cuenta los siguientes puntos:

Las instancias deben estar en estado Running (Running) o Stopped (Stopped), y no deben tener pagos vencidos.
Después de cambiar el método de facturación, el pago se completa automáticamente. Mantenga un saldo suficiente en su cuenta; de lo contrario, su pedido quedará invalidado y deberá cancelarse. Si el saldo de su cuenta es insuficiente, establezca AutoPay en false para generar un pedido sin pagar. Posteriormente, inicie sesión en la ECS console para pagar el pedido.
Cambiar el método de facturación de suscripción a pay-as-you-go:
- El uso de ECS determina si es posible cambiar el método de facturación de una instancia de suscripción a pay-as-you-go.
- Después de cambiar el método de facturación de una instancia de suscripción a pay-as-you-go, el nuevo método permanece vigente durante el resto del ciclo de vida de la instancia. La diferencia de precio se reembolsa a la cuenta de pago que utilizó. Los cupones canjeados no son reembolsables.
- Regla de reembolso: existe una cuota para el monto total de reembolso cada mes, y el saldo no utilizado de esta cuota no se transfiere al mes siguiente. Una vez agotada la cuota de reembolso del mes actual, solo podrá cambiar el método de facturación en el mes siguiente. El monto del reembolso generado al cambiar el método de facturación se calcula con la siguiente fórmula: Número de vCPU × (Número de días restantes × 24 ± Número de horas restantes o transcurridas).
Cambiar el método de facturación de pay-as-you-go a suscripción:
- Puede cambiar el método de facturación de todos los discos de datos conectados a una instancia de pay-as-you-go a suscripción.
- No es posible llamar a esta operación para una instancia pay-as-you-go que tenga configurada una hora de liberación automática.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Por comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta 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í	ModifyInstanceChargeType	La operación que desea ejecutar. Establezca el valor en ModifyInstanceChargeType.
InstanceIds	String	Sí	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]	Los ID de las instancias. El valor puede ser un arreglo JSON compuesto por hasta 20 ID de instancia. Separe los ID de instancia con comas (,).
RegionId	String	Sí	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.
Period	Integer	No	1	La duración de renovación de la instancia de suscripción. Si la instancia está alojada en un host dedicado, la duración de renovación de la instancia no puede exceder la duración de suscripción del host dedicado. Valores válidos: Valores válidos cuando `PeriodUnit` se establece en Month: `1, 2, 3, 4, 5, 6, 7, 8, 9 y 12`.
PeriodUnit	String	No	Month	La unidad de la duración de renovación (`Period`). Valores válidos: Month Valor predeterminado: Month.
IncludeDataDisks	Boolean	No	false	Especifica si se debe cambiar el método de facturación de todos los discos de datos de la instancia de pay-as-you-go a suscripción. true false Valor predeterminado: false.
DryRun	Boolean	No	false	Especifica si se debe realizar solo una prueba en seco, sin ejecutar la solicitud real. Valores válidos: true: realiza solo una prueba en seco. El sistema comprueba el par de AccessKey, los permisos del usuario RAM y los parámetros obligatorios. Si la solicitud falla la prueba en seco, se devuelve un mensaje de error. Si la solicitud pasa la prueba en seco, se devuelve el código de error `DryRunOperation`. false: realiza una prueba en seco y ejecuta la solicitud real. Si la solicitud pasa la prueba en seco, se devuelve un código de estado HTTP 2xx y se ejecuta la operación. Valor predeterminado: false.
AutoPay	Boolean	No	false	Especifica si se debe completar automáticamente el pago. Valores válidos: true: el pago se completa automáticamente. Mantenga un saldo suficiente en su cuenta; de lo contrario, su pedido quedará invalidado y se cancelará. false: se genera un pedido pero no se realiza ningún pago. Valor predeterminado: true. Nota Si el saldo de su cuenta es insuficiente, establezca AutoPay en false para generar un pedido sin pagar. Posteriormente, inicie sesión en la consola de ECS para pagar el pedido.
InstanceChargeType	String	No	PrePaid	El nuevo método de facturación. Valores válidos: PrePaid: suscripción PostPaid: pay-as-you-go Valor predeterminado: PrePaid.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no debe superar los 64 caracteres de longitud. Para obtener más información, consulte How to ensure idempotence.
IsDetailFee	Boolean	No	false	Especifica si se deben devolver los detalles de costos del pedido después de cambiar el método de facturación de suscripción a pay-as-you-go. Valores válidos: true false Valor predeterminado: false.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
OrderId	String	20413515388****	El ID del pedido.
RequestId	String	B61C08E5-403A-46A2-96C1-F7B1216DB10C	El ID de la solicitud.
FeeOfInstances	Array of FeeOfInstance		Detalles sobre los cargos del pedido.
FeeOfInstance
InstanceId	String	i-bp67acfmxazb4p****	El ID de la instancia.
Currency	String	CNY	La unidad monetaria de la factura. Sitio de China de Alibaba Cloud (aliyun.com): CNY. Sitio internacional de Alibaba Cloud (alibabacloud.com): USD.
Fee	String	0	El valor del costo.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb4p****","i-bp67acfmxazb4d****"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&IncludeDataDisks=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyInstanceChargeTypeResponse>
    <OrderId>20413515388****</OrderId>
    <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
    <FeeOfInstances>
        <InstanceId>i-bp67acfmxazb4p****</InstanceId>
        <Currency>CNY</Currency>
        <Fee>0</Fee>
    </FeeOfInstances>
</ModifyInstanceChargeTypeResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "OrderId" : "20413515388****",
  "RequestId" : "B61C08E5-403A-46A2-96C1-F7B1216DB10C",
  "FeeOfInstances" : [ {
    "InstanceId" : "i-bp67acfmxazb4p****",
    "Currency" : "CNY",
    "Fee" : "0"
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	Valor de InstanceIds no válido.
400	InvalidParameter	%s	Un parámetro no válido.
400	InvalidStatus.ValueNotSupported	%s	No es posible ejecutar esta operación en el recurso debido a su estado actual.
400	InvalidInstanceChargeType.ValueNotSupported	%s	Valor de InstanceChargeType no válido.
400	ExpiredInstance	The specified instance has expired.	La instancia especificada ha caducado.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.	Se superó el número máximo de instancias.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Valor de ClientToken no válido.
400	InvalidInternetChargeType.ValueNotSupported	%s	Valor de InternetChargeType no válido.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	La instancia especificada tiene configurada una hora de liberación automática.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Su solicitud fue rechazada debido a limitación de tráfico. Inténtelo de nuevo después de 5 minutos.
400	Throttling	%s	La solicitud fue rechazada debido a limitación de tráfico.
400	InvalidParameter.Bandwidth	%s	Ancho de banda no válido. Compruebe los valores de los parámetros.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	El valor de Period está fuera del rango determinado por el parámetro PeriodUnit.
400	InvalidImageType.NotSupported	%s	Tipo de imagen no válido. Compruebe si el tipo de imagen es compatible con la región.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	El método de facturación de la imagen de Alibaba Cloud Marketplace no es compatible.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	La categoría del disco del sistema no admite esta operación.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	La instancia especificada no tiene un disco del sistema conectado. Asegúrese de que la instancia tenga un disco del sistema conectado. Puede llamar a la operación DescribeInstances para consultar los detalles de la instancia.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Los usuarios internos solo pueden adquirir instancias ECS pay-as-you-go. No pueden adquirir productos de terceros, como imágenes de Alibaba Cloud Marketplace. Revise los parámetros. Asegúrese de que todos cumplan las condiciones e inténtelo de nuevo.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	No es posible ejecutar esta operación cuando PrivatePoolOptions.MatchCriteria se establece en Target.
400	InvalidPeriod	The specified period is not valid.	Valor de Period no válido.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	No puede cambiar el método de facturación de la instancia a pay-as-you-go durante un periodo de actualización temporal de ancho de banda.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	No se encuentra el tipo de instancia o no tiene autorización para gestionar instancias de ese tipo.
403	InstanceType.Offline	%s	No es posible ejecutar la operación mientras el tipo de instancia esté retirado o haya inventario insuficiente.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	El saldo de su cuenta es insuficiente. Agregue fondos a su cuenta e inténtelo de nuevo.
403	Account.Arrearage	Your account has an outstanding payment.	Tiene pedidos sin pagar en su cuenta.
403	InvalidParameter.NotMatch	%s	Valor de parámetro no válido. Compruebe si existen conflictos entre parámetros.
403	InvalidAction	%s	La operación no es válida.
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	Se superó el número máximo de discos pay-as-you-go.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	La imagen de Alibaba Cloud Marketplace especificada no admite el tipo de instancia.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	El tipo de instancia especificado está retirado.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	No ha completado la verificación de nombre real. Complete la verificación e inténtelo de nuevo.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Se superó el número máximo de instancias del tipo especificado en la región. Pruebe con otra región o tipo de instancia, o reduzca la cantidad de instancias que desea crear. También puede ir a la consola de ECS o al Centro de cuotas para solicitar un aumento.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	Se superó el número máximo de instancias del tipo especificado en la región. Pruebe con otra región o tipo de instancia, o reduzca la cantidad de instancias que desea crear. También puede ir a la consola de ECS o al Centro de cuotas para solicitar un aumento.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Se superó el número máximo de vCPU para todos los tipos de instancia. Puede ir a la consola de ECS o al Centro de cuotas para solicitar un aumento.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Se superó el número máximo de instancias del tipo especificado en la región, o el número máximo de vCPU para todos los tipos de instancia. Puede ir a la consola de ECS o al Centro de cuotas para solicitar un aumento.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	No se encuentra el ID de instancia especificado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo más tarde.
500	InternalError	The request processing has failed due to some unknown error.	Ocurrió un error interno. Inténtelo de nuevo más tarde.
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	No tiene autorización para usar este tipo de instancia.

Para consultar una lista de códigos de error, consulte Códigos de error del servicio.