Todos os produtos
Search
Central de documentação

Data Transmission Service:TransferInstanceClass

Última atualização: Jun 27, 2026

Atualiza a classe de uma instância do Data Transmission Service (DTS).

Nota

Não é possível fazer downgrade de instâncias do DTS.

Depuração

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

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim TransferInstanceClass

Operação a ser executada. Defina o valor como TransferInstanceClass.

OrderType String Sim UPGRADE

Tipo de pedido. Defina o valor como UPGRADE.

InstanceClass String Sim large

Nova classe da instância. Chame a API DescribeDtsJobDetail para consultar a classe atual.

  • Instâncias de migração de dados: xxlarge, xlarge, large, medium e small.
  • Instâncias de sincronização de dados: large, medium, small e micro.
Nota Para verificar o desempenho de teste de cada classe de instância, consulte Especificações de instâncias de migração de dados e Especificações de canais de sincronização de dados.
RegionId String Não cn-hangzhou

ID da região da instância do DTS. Consulte Regiões suportadas.

DtsJobId String Sim r4yr723m199****

ID da tarefa de migração ou sincronização de dados. Chame a API DescribeDtsJobs para consultar o ID da tarefa.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

EndTime String 2021-08-04T16:00:00.000+00:00

Data de expiração da instância do DTS.

Nota Retornado apenas se ChargeType for PREPAY.
HttpStatusCode Integer 200

Código de status HTTP.

RequestId String 716DB03E-2D0B-4DC3-BC4C-F7A9EE21****

ID da solicitação.

DtsJobId String r4yr723m199****

ID da tarefa de migração ou sincronização de dados.

ErrCode String InternalError

Código de erro retornado em caso de falha na solicitação.

Success Boolean true

Indica se a solicitação foi bem-sucedida.

  • true
  • false
ChargeType String POSTPAY

Método de faturamento da instância do DTS.

  • POSTPAY: pagamento conforme o uso.
  • PREPAY: assinatura.
ErrMessage String The request processing has failed due to some unknown error.

Mensagem de erro retornada em caso de falha na solicitação.

Code String 200

Código de erro.

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, o valor especificado para DtsJobId é inválido.
InstanceId String dtsr4yr723m199****

ID da instância do DTS.

Exemplos

Exemplos de solicitações

http(s)://dts.aliyuncs.com/?Action=TransferInstanceClass
&OrderType=UPGRADE
&InstanceClass=large
&DtsJobId=r4yr723m199****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<TransferInstanceClassResponse>
      <DtsJobId>r4yr723m199****</DtsJobId>
      <RequestId>716DB03E-2D0B-4DC3-BC4C-F7A9EE21****</RequestId>
      <InstanceId>dtsr4yr723m199****</InstanceId>
      <ChargeType>POSTPAY</ChargeType>
      <HttpStatusCode>200</HttpStatusCode>
      <Success>true</Success>  
</TransferInstanceClassResponse>

Formato JSON

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

{
  "DtsJobId" : "r4yr723m199****",
  "RequestId" : "716DB03E-2D0B-4DC3-BC4C-F7A9EE21****",
  "InstanceId" : "dtsr4yr723m199****",
  "ChargeType" : "POSTPAY",
  "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.

500

ServiceUnavailable

The request has failed due to a temporary failure of the server.

O servidor atingiu o tempo limite ou está indisponível. Tente novamente. Se o erro persistir, entre em contato com o suporte técnico.

403

InvalidSecurityToken.Expired

Specified SecurityToken is expired.

O token de segurança expirou. Utilize um novo token de segurança.

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