ModifyInstanceChargeType - : Central de Documentação do Alibaba Cloud

Altera o método de faturamento de uma ou mais instâncias do Elastic Compute Service (ECS). Você pode alternar o método de faturamento das instâncias entre pagamento conforme o uso e assinatura, ou alterar o método de faturamento de todos os discos de dados associados a uma instância de pagamento conforme o uso para assinatura.

Observações de uso

Antes de chamar esta operação, certifique-se de compreender os métodos de faturamento e a tabela de preços do ECS. Para obter mais informações, visite a página do produto Elastic Compute Service.

Observe os seguintes pontos:

As instâncias devem estar no estado Running(Running) ou Stopped(Stopped) e não podem ter pagamentos em atraso.
Após a alteração do método de faturamento, o pagamento é concluído automaticamente. Mantenha saldo suficiente na conta. Caso contrário, o pedido se tornará inválido e deverá ser cancelado. Se o saldo da conta for insuficiente, defina AutoPay como false para gerar um pedido não pago. Em seguida, faça login no ECS console para pagar o pedido.
Alteração do método de faturamento de assinatura para pagamento conforme o uso:
- O uso do ECS determina se é possível alterar o método de faturamento de uma instância de assinatura para pagamento conforme o uso.
- Após alterar o método de faturamento de uma instância de assinatura para pagamento conforme o uso, o novo método permanece válido pelo restante do ciclo de vida da instância. A diferença de preço é reembolsada na conta de pagamento utilizada. Vouchers já resgatados não são reembolsáveis.
- Regra de reembolso: existe uma cota para o valor total de reembolso mensal, e o saldo não utilizado dessa cota não é transferido para o mês seguinte. Após esgotar a cota de reembolso do mês atual, só será possível alterar o método de faturamento no próximo mês. O valor do reembolso gerado na alteração do método de faturamento é calculado pela seguinte fórmula: Número de vCPUs × (Número de dias restantes × 24 ± Número de horas restantes ou decorridas).
Alteração do método de faturamento de pagamento conforme o uso para assinatura:
- Você pode alterar o método de faturamento de todos os discos de dados associados a uma instância de pagamento conforme o uso para assinatura.
- Não é possível chamar esta operação para uma instância de pagamento conforme o uso que tenha um horário de liberação automática configurado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ModifyInstanceChargeType	A operação a ser executada. Defina o valor como ModifyInstanceChargeType.
InstanceIds	String	Sim	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]	Os IDs das instâncias. O valor pode ser um array JSON composto por até 20 IDs de instância. Separe os IDs das instâncias com vírgulas (,).
RegionId	String	Sim	cn-hangzhou	O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
Period	Integer	Não	1	A duração da renovação da instância por assinatura. Se a instância estiver hospedada em um host dedicado, a duração da renovação da instância não poderá exceder a duração da assinatura do host dedicado. Valores válidos: Valores válidos quando `PeriodUnit` está definido como Month: `1, 2, 3, 4, 5, 6, 7, 8, 9 e 12`.
PeriodUnit	String	Não	Month	A unidade da duração da renovação (`Period`). Valores válidos: Month Valor padrão: Month.
IncludeDataDisks	Boolean	Não	false	Indica se deve alterar o método de faturamento de todos os discos de dados na instância de pagamento conforme o uso para assinatura. true false Valor padrão: false.
DryRun	Boolean	Não	false	Indica se deve realizar apenas uma simulação, sem executar a solicitação real. Valores válidos: true: realiza apenas uma simulação. O sistema verifica o par de AccessKey, as permissões do usuário RAM e os parâmetros obrigatórios. Se a solicitação falhar na simulação, uma mensagem de erro será retornada. Se a solicitação passar na simulação, o código de erro `DryRunOperation` será retornado. false: realiza uma simulação e executa a solicitação real. Se a solicitação passar na simulação, um código de status HTTP 2xx será retornado e a operação será executada. Valor padrão: false.
AutoPay	Boolean	Não	false	Indica se deve concluir o pagamento automaticamente. Valores válidos: true: o pagamento é concluído automaticamente. Mantenha saldo suficiente na conta. Caso contrário, o pedido se tornará inválido e será cancelado. false: um pedido é gerado, mas nenhum pagamento é efetuado. Valor padrão: true. Nota Se o saldo da conta for insuficiente, defina AutoPay como false para gerar um pedido não pago. Em seguida, faça login no ECS console para pagar o pedido.
InstanceChargeType	String	Não	PrePaid	O novo método de faturamento. Valores válidos: PrePaid: assinatura PostPaid: pagamento conforme o uso Valor padrão: PrePaid.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	O token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token, mas certifique-se de que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.
IsDetailFee	Boolean	Não	false	Indica se deve retornar detalhes de custos do pedido após a alteração do método de faturamento de assinatura para pagamento conforme o uso. Valores válidos: true false Valor padrão: false.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
OrderId	String	20413515388****	O ID do pedido.
RequestId	String	B61C08E5-403A-46A2-96C1-F7B1216DB10C	O ID da solicitação.
FeeOfInstances	Array of FeeOfInstance		Detalhes sobre as cobranças do pedido.
FeeOfInstance
InstanceId	String	i-bp67acfmxazb4p****	O ID da instância.
Currency	String	CNY	A unidade monetária da fatura. Site da China do Alibaba Cloud (aliyun.com): CNY. Site Internacional do Alibaba Cloud (alibabacloud.com): USD.
Fee	String	0	O valor do custo.

Exemplos

Exemplos de solicitações

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>

Exemplos de respostas de sucesso

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 erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	Valor de InstanceIds inválido.
400	InvalidParameter	%s	Um parâmetro inválido.
400	InvalidStatus.ValueNotSupported	%s	Não é possível realizar esta operação no recurso no estado atual.
400	InvalidInstanceChargeType.ValueNotSupported	%s	Valor de InstanceChargeType inválido.
400	ExpiredInstance	The specified instance has expired.	A instância especificada expirou.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.	O número máximo de instâncias foi excedido.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Valor de ClientToken inválido.
400	InvalidInternetChargeType.ValueNotSupported	%s	Valor de InternetChargeType inválido.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	Um horário de liberação automática está definido para a instância especificada.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Sua solicitação foi negada devido ao limitador de taxa. Tente novamente após 5 minutos.
400	Throttling	%s	A solicitação foi negada devido ao limitador de taxa.
400	InvalidParameter.Bandwidth	%s	Largura de banda inválida. Verifique os valores dos parâmetros.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	O valor de Period está fora do intervalo de valores determinado pelo parâmetro PeriodUnit.
400	InvalidImageType.NotSupported	%s	Tipo de imagem inválido. Verifique se o tipo de imagem é suportado na região.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	O método de faturamento da imagem do Alibaba Cloud Marketplace não é suportado.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	A categoria do disco do sistema não suporta esta operação.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	A instância especificada não possui disco do sistema associado. Certifique-se de que a instância especificada tenha um disco do sistema associado. Chame a operação DescribeInstances para consultar os detalhes da instância.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Usuários internos só podem comprar instâncias ECS com pagamento conforme o uso. Eles não podem comprar produtos de terceiros, como imagens do Alibaba Cloud Marketplace. Verifique os parâmetros. Certifique-se de que todos os parâmetros atendam às condições e tente novamente.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Não é possível realizar esta operação quando PrivatePoolOptions.MatchCriteria está definido como Target.
400	InvalidPeriod	The specified period is not valid.	Valor de Period inválido.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	Não é possível alterar o método de faturamento da instância para pagamento conforme o uso durante um período de atualização temporária de largura de banda.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	O tipo de instância não foi encontrado ou você não tem autorização para gerenciar instâncias desse tipo.
403	InstanceType.Offline	%s	Não é possível realizar a operação enquanto o tipo de instância estiver descontinuado ou enquanto o estoque do tipo de instância for insuficiente.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	O saldo da conta é insuficiente. Adicione fundos à conta e tente novamente.
403	Account.Arrearage	Your account has an outstanding payment.	Você tem pedidos não pagos em sua conta.
403	InvalidParameter.NotMatch	%s	Valor de parâmetro inválido. Verifique se existem conflitos de parâmetros.
403	InvalidAction	%s	A operação é inválida.
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	O número máximo de discos de pagamento conforme o uso foi excedido.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	A imagem especificada do Alibaba Cloud Marketplace não suporta o tipo de instância.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	O tipo de instância especificado está descontinuado.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Você não concluiu a verificação de nome real. Conclua a verificação de nome real e tente novamente.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O número máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza o número de instâncias que deseja criar. Você também pode acessar o ECS console ou o Quota Center para solicitar um aumento de cota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	O número máximo de instâncias do tipo especificado na região foi excedido. Tente outra região ou tipo de instância, ou reduza o número de instâncias que deseja criar. Você também pode acessar o ECS console ou o Quota Center para solicitar um aumento de cota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	O número máximo de vCPUs para todos os tipos de instância foi excedido. Acesse o ECS console ou o Quota Center para solicitar um aumento de cota.
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.	O número máximo de instâncias do tipo especificado na região, ou o número máximo de vCPUs para todos os tipos de instância foi excedido. Acesse o ECS console ou o Quota Center para solicitar um aumento de cota.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	O ID da instância especificado não foi encontrado.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error.	Ocorreu um erro interno. Tente novamente mais tarde.
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Você não tem autorização para usar o tipo de instância.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.