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

Modifica o método de cobrança de instâncias ECS. A modificação em lote é suportada.

Descrição da operação

Antes de começar

Certifique-se de compreender totalmente os métodos de cobrança por assinatura e pago conforme o uso e os preços do Elastic Compute Service (ECS).
Certifique-se de que as instâncias de destino estejam no estado Em execução (Running) ou Parada (Stopped) e que sua conta não tenha pagamentos em atraso.
Após a alteração do método de cobrança, o pagamento automático é ativado por padrão. Certifique-se de que o saldo da sua conta seja suficiente. Caso contrário, serão gerados pedidos anômalos e você só poderá cancelá-los. Se o saldo da sua conta for insuficiente, você pode definir o parâmetro AutoPay como false. Nesse caso, serão gerados pedidos não pagos e você poderá fazer login no console do ECS para concluir o pagamento.

Precauções

De assinatura para pago conforme o uso:
Ao transformar uma instância por assinatura em uma instância paga conforme o uso, o novo método de cobrança substitui a instância durante todo o seu ciclo de vida. Você recebe um reembolso pela diferença de preço, que é devolvido ao seu método de pagamento original. Os vouchers que foram resgatados não são reembolsáveis.
- Regras de reembolso: O valor de reembolso que você pode solicitar a cada mês é limitado e não é transferido para o mês seguinte. Após a cota de reembolso ser esgotada, você deve esperar até o mês seguinte para alterar os métodos de cobrança. A cota de reembolso consumida por cada alteração de método de cobrança é calculada usando a seguinte fórmula: vCPUs × (dias restantes × 24 ± horas flutuantes). Para mais informações, consulte Alterar o método de cobrança de assinatura para pago conforme o uso.
De pago conforme o uso para assinatura:
- Todos os discos de dados pagos conforme o uso conectados à instância podem ser convertidos em discos de dados por assinatura ao mesmo tempo.
- Se um horário de liberação estiver definido para a instância paga conforme o uso, você não poderá invocar esta operação. Para mais informações, consulte Alterar o método de cobrança de assinatura para pago conforme o uso.
- Se a instância estiver no modo econômico, inicie a instância primeiro.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:ModifyInstanceChargeType

update

*Instância.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceIds	string	Sim	Os IDs das instâncias. O valor pode ser um array JSON que consiste em até 20 IDs de instâncias. Separe os IDs com vírgulas (,).	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]
RegionId	string	Sim	O ID da região da instância. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
Period	integer	Não	O período de renovação da assinatura. Se a instância ECS estiver hospedada em um host dedicado, o valor não poderá exceder o período de assinatura do host dedicado. Valores válidos: Se PeriodUnit estiver definido como Month, valores válidos de Period: 1, 2, 3, 4, 5, 6, 7, 8, 9 e 12.	1
PeriodUnit	string	Não	A unidade do período de renovação especificada pelo parâmetro Period. Valores válidos: Month Valor padrão: Month.	Month
IncludeDataDisks	boolean	Não	Especifica se todos os discos de dados pagos conforme o uso conectados à instância devem ser convertidos em discos de dados por assinatura. true: Converte todos os discos de dados pagos conforme o uso em discos de dados por assinatura. false: Não converte os discos de dados pagos conforme o uso em discos de dados por assinatura. Valor padrão: false.	false
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: envia uma solicitação de verificação sem consultar o status do recurso. Os itens de verificação incluem se o seu par de AccessKey é válido, se o usuário do Resource Access Management (RAM) recebeu a autorização necessária e se os parâmetros necessários foram especificados. Se a solicitação falhar no dry run, a mensagem de erro correspondente será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado. false: envia uma solicitação normal. Se a solicitação passar no dry run, um código de status HTTP 2XX será retornado e a operação será executada. Valor padrão: false.	false
AutoPay	boolean	Não	Especifica se o pagamento automático deve ser ativado. Valores válidos: true: ativa o pagamento automático. Certifique-se de que o saldo da sua conta seja suficiente. Se o saldo da sua conta for insuficiente, serão gerados pedidos anômalos e você só poderá cancelá-los. false: gera pedidos sem cobrar. Valor padrão: true. Nota Se o seu método de pagamento tiver saldo insuficiente, você pode definir AutoPay como false. Nesse caso, serão gerados pedidos não pagos e você poderá fazer login no console do ECS para concluir o pagamento.	false
InstanceChargeType	string	Não	O método de cobrança de destino da instância. Valores válidos: PrePaid: transforma instâncias pagas conforme o uso em instâncias por assinatura. PostPaid: transforma instâncias por assinatura em instâncias pagas conforme o uso. Valor padrão: PrePaid.	PrePaid
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas certifique-se de que o token seja único entre diferentes solicitações. O valor ClientToken pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-426655440000
IsDetailFee	boolean	Não	Especifica se os detalhes da taxa do pedido devem ser retornados quando o método de cobrança é transformado de assinatura para pago conforme o uso. Valores válidos: true: Retorna os detalhes da taxa do pedido. false: Não retorna os detalhes da taxa do pedido. Valor padrão: false.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
FeeOfInstances	object
FeeOfInstance	array<object>	Os detalhes da taxa do pedido.
	object
Currency	string	A unidade monetária da fatura. Site da China: CNY. Site internacional: USD.	CNY
Fee	string	O valor da taxa.	0
InstanceId	string	O ID da instância.	i-bp67acfmxazb4p****
OrderId	string	O ID do pedido. Este parâmetro é retornado apenas quando o método de cobrança é alterado para assinatura.	20413515388****
RequestId	string	O ID da solicitação.	B61C08E5-403A-46A2-96C1-F7B1216DB10C

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidInstance.UnpaidOrder	%s
400	Throttling	Request was denied due to request throttling, try again later.	A solicitação foi limitada.
400	InstanceHasProcessingConvertOrder	%s
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	A instância especificada é inválida.
400	InvalidParameter	%s	Os parâmetros da solicitação atual são inválidos. Tente novamente.
400	InvalidStatus.ValueNotSupported	%s	O status do disco especificado não suporta esta operação.
400	InvalidInstanceChargeType.ValueNotSupported	%s	O método de cobrança da instância especificado não existe.
400	InvalidSpotStrategy	The specified spotStrategy is not valid.	O parâmetro SpotStrategy especificado é inválido.
400	ExpiredInstance	The specified instance has expired.	A instância especificada expirou.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	O ClientToken especificado é inválido.
400	InvalidInternetChargeType.ValueNotSupported	%s	O método de cobrança de rede especificado é inválido.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	A instância especificada já possui um horário de liberação agendado configurado.
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded: %s.
400	InvalidParameter.Bandwidth	%s	O parâmetro de largura de banda é inválido.
400	QuotaExceed.RufundVcpu	The maximum number of refund vcpu is exceeded: %s.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	O período especificado deve estar associado ao PeriodUnit.
400	InvalidImageType.NotSupported	%s	O tipo de imagem especificado é inválido. Verifique se este tipo de imagem é suportado na região atual.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	O método de cobrança da imagem do Alibaba Cloud Marketplace especificada não é suportado.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	O SystemDisk.Size especificado é inválido.
400	InvalidAccountStatus.PayAmountLimitExceeded	Your account is being restricted, due to no default payment method is set or you has not being authorized.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	A instância especificada não possui um disco do sistema anexado. Certifique-se de que a instância especificada tenha um disco do sistema anexado. Você pode chamar DescribeInstances para consultar as informações da instância especificada.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Os clientes de migração para a nuvem corporativa podem comprar apenas instâncias ECS pagas conforme o uso e não podem comprar produtos de terceiros, como imagens fornecidas pelo Alibaba Cloud Marketplace. Verifique os parâmetros e tente novamente com parâmetros válidos.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	O parâmetro PrivatePoolOptions.MatchCriteria especificado não corresponde ao pool privado.
400	InvalidPeriod	The specified period is not valid.	O período de tempo especificado é inválido.
400	DISK_IN_DEDICATED_BLOCK_STORAGE_CLUSTER	The disk in dedicated block storage cluster is not allowed to do this operation.
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 operação requer permissões de preços. Solicite permissões à sua conta principal ou defina o parâmetro AutoPay como true para pagamento automático.
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	Esta conta não tem permissão para realizar um reembolso. A conta principal deve conceder as permissões relacionadas ao reembolso.
400	QuotaExceeded.InternetBandwidth	%s.	A largura de banda pública total com cobrança por largura de banda fixa das instâncias ECS pós-pagas em sua conta excedeu o limite total de cota de largura de banda.
400	DiskExpiredOrInArrears	Your account has an overdue payment for the specified instance.	A instância especificada possui um pagamento em atraso.
400	LastTokenProcessing	The last token request is processing	A solicitação de token anterior ainda está sendo processada. Tente novamente mais tarde.
400	Account.NotSupported	Your account is not support ordering product in marketplace, please change other accounts.	O pedido envolve produtos de terceiros do Alibaba Cloud Marketplace. Clientes de revendedores não podem comprar esses produtos. Para comprar os produtos, recomendamos que você use uma conta diferente. Se tiver dúvidas, entre em contato com seu revendedor para conhecer as regras de negócios relevantes.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocorreu um erro interno. Tente novamente.
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
500	InvalidOperation.RefundFailed	Failed to refund. Please try again or submit a support ticket.	O reembolso falhou.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	A instância não pode ser convertida para pós-pago durante uma atualização temporária de largura de banda.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
403	InstanceType.Offline	%s	O tipo de instância especificado foi descontinuado. Selecione um tipo de instância diferente.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	Account.Arrearage	Your account has an outstanding payment.
403	InvalidParameter.NotMatch	%s	O parâmetro especificado é inválido. Verifique se os parâmetros entram em conflito entre si.
403	InvalidAction	%s
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	O número de discos pós-pagos excedeu a cota permitida.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	A imagem especificada não suporta este tipo de instância.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	O tipo de instância especificado foi descontinuado e não está mais disponível para venda.
403	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Sua conta Alibaba Cloud não concluiu o registro de nome real. Conclua o registro de nome real antes de realizar esta operação.
403	InvalidOperation.NotSupport	Instance on dedicated host not support modify charge type.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	O número de instâncias a serem criadas com o tipo de instância selecionado na região atual excede a cota, ou a cota total de vCPU para todos os tipos de instância foi excedida. Você pode acessar o console do ECS ou o Quota Center para solicitar um aumento de cota.
403	PeriodNotSupported.InstanceOnManagedPrivateSpace	The instance on ManagedPrivateSpace is not supported to modify chargeType.
403	UnsupportedIspChargeType	%s	O método de cobrança especificado não oferece suporte ao parâmetro Isp.
403	InvalidOperation.StoppedModeUnsupported	The specified instance is StopCharging.	A instância no modo econômico não pode ser operada.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.
409	InvalidOperation.Conflict	Request was denied due to conflict with a previous request, please try again later.	Esta operação não é permitida devido a um conflito de tarefas.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.