RenewInstance - Renovar uma instância de assinatura do DTS - Data Transmission Service: Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	RenewInstance	Operação a executar. Defina o valor como RenewInstance.
DtsJobId	String	Sim	qi0r643lc31****	ID da tarefa de sincronização de dados ou rastreamento de alterações. Chame DescribeDtsJobs para consultar o ID da tarefa.
ChargeType	String	Sim	PREPAY	Método de faturamento. Defina o valor como PREPAY (assinatura).
Period	String	Não	Month	Ciclo de faturamento da renovação. Valores válidos: Year: anual. Month (padrão): mensal.
BuyCount	String	Não	1	Duração da renovação. Valor padrão: 1. Se Period for Year: 1 a 5. Se Period for Month: 1 a 60.
RegionId	String	Não	cn-hangzhou	ID da região da instância do DTS. Consulte a lista de regiões suportadas.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
HttpStatusCode	Integer	200	Código de status HTTP.
EndTime	String	2021-08-04T16:00:00.000+00:00	Nova data de expiração após a renovação, no formato ISO 8601 aaaa-MM-ddTHH:mm:ssZZZ (UTC). Nota ZZZ representa o deslocamento do fuso horário, como +00:00.
RequestId	String	1112E255-0C38-4970-8159-1D54AD92****	ID da solicitação.
ErrCode	String	InternalError	Código de erro retornado em caso de falha na solicitação.
DtsJobId	String	qi0r643lc31****	ID da tarefa de sincronização de dados ou rastreamento de alterações.
Success	Boolean	true	Indica se a solicitação foi bem-sucedida. Valores válidos: true false
ErrMessage	String	The request processing has failed due to some unknown error.	Mensagem de erro retornada em caso de falha na solicitação.
ChargeType	String	PREPAY	Método de faturamento. Retorna PREPAY (assinatura).
Code	String	200	Código de erro. Nota Este parâmetro será removido futuramente.
DynamicMessage	String	DtsJobId	Parte dinâmica da mensagem de erro, usada para substituir a variável %s em ErrMessage. Nota Por exemplo, se ErrMessage for The Value of Input Parameter %s is not valid e DynamicMessage for DtsJobId, significa que o parâmetro DtsJobId é inválido.
InstanceId	String	dtsqi0r643lc31****	ID da instância do DTS.

Exemplos

Solicitações de exemplo

http(s)://dts.aliyuncs.com/?Action=RenewInstance
&ChargeType=PREPAY
&DtsJobId=qi0r643lc31****
&Period=Month
&BuyCount=1
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<RenewInstanceResponse>
<DtsJobId>qi0r643lc31****</DtsJobId>
<EndTime>2021-08-04T16:00:00.000+00:00</EndTime>
<RequestId>1112E255-0C38-4970-8159-1D54AD92****</RequestId>
<InstanceId>dtsqi0r643lc31****</InstanceId>
<ChargeType>PREPAY</ChargeType>
<HttpStatusCode>200</HttpStatusCode>
<Success>true</Success>
</RenewInstanceResponse>

Formato JSON

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

{
  "DtsJobId" : "qi0r643lc31****",
  "EndTime" : "2021-08-04T16:00:00.000+00:00",
  "RequestId" : "1112E255-0C38-4970-8159-1D54AD92****",
  "InstanceId" : "dtsqi0r643lc31****",
  "ChargeType" : "PREPAY",
  "HttpStatusCode" : 200,
  "Success" : true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Throttling.User	Request was denied due to user flow control.	Solicitação limitada devido ao controle de fluxo do usuário. Tente novamente mais tarde.
403	InvalidSecurityToken.Expired	Specified SecurityToken is expired.	O token de segurança expirou. Utilize um novo token.
500	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Servidor temporariamente indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.