Todos os produtos
Search
Central de documentação

:Alterar o método de faturamento

Última atualização: Jun 26, 2026

Chame a operação TransformDBInstancePayType para alterar o método de faturamento de uma instância do ApsaraDB RDS.

Nota
  • Ao alterar o método de faturamento de assinatura para pagamento conforme o uso, um reembolso é concedido. O valor do reembolso corresponde ao saldo restante da assinatura deduzido de uma taxa de serviço. Para mais informações, consulte Switch an ApsaraDB RDS for MySQL instance from subscription to pay-as-you-go.

  • Se o saldo da sua conta Alibaba Cloud for insuficiente, não será possível alterar o método de faturamento de pagamento conforme o uso para assinatura.

  • Esta operação não é compatível com instâncias cujos pedidos de alteração de especificação ainda não foram concluídos.

  • Esta operação não é compatível com instâncias criadas em clusters dedicados.

O ApsaraDB RDS oferece suporte aos seguintes métodos de faturamento:

  • Assinatura: uma instância de assinatura exige o pagamento antecipado de uma taxa. Para uso de longo prazo, a assinatura é mais econômica do que o pagamento conforme o uso. Períodos de assinatura mais longos garantem preços menores.

  • Pagamento conforme o uso: uma instância com esse método de faturamento é cobrada por hora com base no consumo de recursos. A taxa horária é calculada de acordo com o tipo de instância especificado no pedido de compra e debitada do saldo da sua conta Alibaba Cloud. Para uso de curto prazo, recomendamos o pagamento conforme o uso. Se a instância não for mais necessária, libere-a para reduzir os custos.

Para mais informações sobre os métodos de faturamento, consulte Pricing, billable items, and billing methods.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo para diferentes SDKs.

Parâmetros de requisição

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim TransformDBInstancePayType

A operação a ser executada. Defina o valor como TransformDBInstancePayType.

ClientToken String Não ETnLKlblzczshOTUbOCzxxxxxxxxxx

O token do cliente usado para garantir a idempotência da requisição. Gere o valor pelo cliente, garantindo que seja único entre requisições diferentes. O token aceita apenas caracteres ASCII e não pode ultrapassar 64 caracteres.

DBInstanceId String Sim rm-uf6wjk5xxxxxx

O ID da instância.

UsedTime Integer Não 1

O período de assinatura da instância. Valores válidos:

  • Se o parâmetro Period for definido como Year, o valor de UsedTime varia de 1 a 5.
  • Se o parâmetro Period for definido como Month, o valor de UsedTime varia de 1 a 9.
Nota Este parâmetro é obrigatório quando o parâmetro PayType é definido como Prepaid.
PayType String Sim Prepaid

O método de faturamento da instância. Valores válidos:

  • Postpaid: pagamento conforme o uso
  • Prepaid: assinatura
Period String Não Month

O tipo de assinatura da instância. Valores válidos:

  • Year: assinatura anual
  • Month: assinatura mensal
Nota Este parâmetro é obrigatório quando o parâmetro PayType é definido como Prepaid.
BusinessInfo String Não None

As informações de negócio estendidas da instância.

AutoRenew String Não true

Indica se a renovação automática está ativada para a instância. Valores válidos:

  • true: renovação automática ativada.
  • false: renovação automática desativada.
Nota
  • Este parâmetro é válido apenas ao alterar o método de faturamento de pagamento conforme o uso para assinatura.
  • Qualquer valor diferente de true é interpretado como false.

Parâmetros de resposta

Parâmetro Tipo Exemplo Descrição
DBInstanceId String rm-uf6wjk5xxxxxx

O ID da instância.

RequestId String 5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A

O ID da requisição.

ExpiredTime String 2020-04-20T10:00:00Z

O horário de expiração da instância.

Nota Se o método de faturamento for alterado de assinatura para pagamento conforme o uso, este parâmetro não é retornado.
OrderId Long 205157600280623

O ID do pedido.

ChargeType String Prepaid

O método de faturamento da instância.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=TransformDBInstancePayType
&DBInstanceId=rm-uf6wjk5xxxxxx
&PayType=Prepaid
&UsedTime=3
&Period=Month
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

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

<TransformDBInstancePayTypeResponse>
<ChargeType>Prepaid</ChargeType>
<DBInstanceId>rm-uf6wjk5xxxxxx</DBInstanceId>
<ExpiredTime>2020-04-20T10:00:00Z</ExpiredTime>
<OrderId>205157600280623</OrderId>
<RequestId>5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A</RequestId>
</TransformDBInstancePayTypeResponse>

JSON format

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

{
  "ChargeType" : "Prepaid",
  "DBInstanceId" : "rm-uf6wjk5xxxxxx",
  "ExpiredTime" : "2020-04-20T10:00:00Z",
  "OrderId" : 205157600280623,
  "RequestId" : "5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidDBInstanceName.NotFound

The specified DB instance name does not exist.

O nome da instância especificada não foi encontrado.

400

InvalidInstanceUseType.NotSupport

Specified instanceUseType does not support in RDS.

A instância é uma instância filha e não é compatível com esta operação.

400

InvalidOrderCharge.NotSupport

The specified order charge does not support in RDS.

O valor do parâmetro PayType é inválido. Os valores válidos são Prepaid e Postpaid. Prepaid indica assinatura e Postpaid indica pagamento conforme o uso.

400

InvalidOrderTask.NotSupport

The Current InstanceId exist Order Task in RDS.

A instância possui pedidos não concluídos. Tente novamente mais tarde.

400

IncorrectDBInstanceType

Current DB instance type does not support this operation.

Esta operação não é compatível com o estado atual da instância.

400

IncompleteAccountInfo

Your information is incomplete. Complete your information before the operation.

As informações da sua conta estão incompletas. Acesse o console do Account Center e preencha todos os campos marcados com asterisco (*).

400

IncompleteTaxInfo

Your tax information is incomplete. Complete your information before the operation.

As informações fiscais estão incompletas. Preencha todos os dados fiscais obrigatórios.

400

InvalidPaymentMethod.Incomplete

No payment method is specified for your account. We recommend that you add a payment method.

Nenhum método de pagamento válido foi encontrado na sua conta Alibaba Cloud. Adicione um método de pagamento válido e tente novamente.

400

InvalidPaymentMethod.Missing

Your payment method is incomplete. We recommend that you add a payment method.

Nenhum método de pagamento válido foi encontrado na conta Alibaba Cloud atual. Adicione um método de pagamento válido e tente novamente.

400

InsuffcientBalanceOrBankAccount

Add a payment method or add funds to the prepayment balance. Get started by creating an instance.

Nenhum método de pagamento válido foi encontrado na conta Alibaba Cloud atual. Adicione um método de pagamento válido ou adicione saldo e tente novamente.

400

InvalidPaymentMethod.Missing

No payment method is specified for your account. We recommend that you add a payment method.

Nenhum método de pagamento válido foi encontrado na sua conta Alibaba Cloud. Adicione um método de pagamento válido e tente novamente.

400

OrderTaskAlreadyExists

Order task already exists.

O pedido já existe.

400

InvalidOldInstanceType.NotSupport

Specified oldInstanceType does not support in RDS.

Esta operação não é compatível com a versão do mecanismo de banco de dados da instância.

400

OperationDenied.TimeLimit

The interval between the two conversion operations must be greater than 15 minutes.

O intervalo entre esta operação e a anterior é menor ou igual a 15 minutos.

400

InvalidResource.Format

The specified parameter Resource is not valid.

O recurso especificado é inválido.

400

InvalidPayType.Format

The specified parameter PayType is not valid.

O valor do parâmetro PayType é inválido.

400

InvalidUsedTime.Format

The specified parameter UsedTime is not valid.

O parâmetro UsedTime não foi especificado.

403

OperationDenied.LockMode

The operation is not permitted when the instance locked.

A instância está bloqueada. O saldo da sua conta Alibaba Cloud pode estar insuficiente. Adicione saldo para desbloquear a instância e tente novamente.

Para consultar a lista de códigos de erro, acesse o API Error Center.