Todos os produtos
Search
Central de documentação

:Renovar manualmente uma instância do ApsaraDB RDS

Última atualização: Jun 26, 2026

Chame a operação RenewInstance para renovar manualmente uma instância do ApsaraDB RDS.

Antes de chamar esta operação, certifique-se de que compreende os métodos de faturamento e os preços do ApsaraDB RDS. Para mais informações, consulte Itens faturáveis, métodos de faturamento e preços.

Antes de chamar esta operação, verifique se os seguintes requisitos são atendidos:

  • A instância é uma instância de assinatura.

  • Sua conta aceita pagamentos por cartão de crédito ou pagamentos por saldo.

    Nota

    Por padrão, os cupons disponíveis na sua conta são usados preferencialmente para pagamento.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua comodidade, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

ParameterTypeRequiredExampleDescription
ActionStringYesRenewInstance

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

ClientTokenStringNoETnLKlblzczshOTUbOCzxxxxxxxxxx

O token de cliente usado para garantir a idempotência da requisição. Use o cliente para gerar o valor, mas certifique-se de que o token gerado seja único entre requisições diferentes. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres.

DBInstanceIdStringYesrm-uf6wjk5xxxxxxxxxx

O ID da instância.

PeriodIntegerYes12

A duração da renovação da assinatura. Unidade: meses. Valores válidos:

  • 1~9
  • 12
  • 24
  • 36
  • 48
  • 60
AutoPayStringNoTrue

Indica se o pagamento automático deve ser ativado durante a renovação. Valores válidos:

  • True: O pagamento automático está ativado. Certifique-se de que sua conta da Alibaba Cloud tem saldo suficiente.
  • False: O pagamento automático está desativado. Pague o pedido manualmente pelo console. Acesse o console do ApsaraDB RDS. No canto superior direito, escolha Expenses > User Center. No painel de navegação à esquerda, clique em Orders. Na página exibida, localize seu pedido e conclua o pagamento.
AutoRenewStringNotrue

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

  • true.
  • false. Este é o valor padrão.

Parâmetros de resposta

Parameter

Type

Example

Description

OrderId

Long

201815745430941

O ID do pedido.

RequestId

String

1AD222E9-E606-4A42-BF6D-8A4442913CEF

O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=RenewInstance
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&Period=12
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML formato

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

<?xml version="1.0" encoding="UTF-8" ?>
<RenewInstanceResponse>
    <OrderId>20286717xxxxx</OrderId>
    <RequestId>E10319A3-B96A-46B0-81CE-D610DC891409</RequestId></RenewInstanceResponse>

JSON formato

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

{
  "OrderId" : "20286717xxxxx",
  "RequestId" : "E10319A3-B96A-46B0-81CE-D610DC891409"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

SYSTEM.CONCURRENT_OPERATE

Concurrent operation is detected.

Erro retornado porque operações simultâneas foram detectadas no sistema.

400

ArrearageOrderExists

Your account has an outstanding balance.

Erro retornado porque sua conta da Alibaba Cloud possui saldo devedor pendente.

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