Criar uma tarefa de migração - : Central de Documentação do Alibaba Cloud

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para facilitar o uso, recomendamos chamar 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

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateMigrateTask	A operação a ser executada. Defina o valor como CreateMigrateTask.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	O ID da instância.
DBName	String	Yes	testDB	O nome do banco de dados do qual deseja fazer backup.
BackupMode	String	Yes	FULL	O tipo da tarefa de migração. Valores válidos: FULL: a tarefa de migração migra arquivos de backup completo. UPDF: a tarefa de migração migra arquivos de backup incremental ou de log.
IsOnlineDB	String	Yes	True	Indica se os dados do banco de dados restaurado ficarão disponíveis para acesso dos usuários. Valores válidos: True False Nota Defina o valor como True para instâncias que executam SQL Server 2008 R2.
CheckDBMode	String	No	AsyncExecuteDBCheck	O método de verificação de consistência do banco de dados. Valores válidos: SyncExecuteDBCheck: verificação síncrona do banco de dados. AsyncExecuteDBCheck: verificação assíncrona do banco de dados. Valor padrão: AsyncExecuteDBCheck (compatível com SQL Server 2008 R2). Nota Este parâmetro é válido quando IsOnlineDB está definido como True.
OssObjectPositions	String	No	oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak	A localização do arquivo de backup no bucket OSS. O valor é composto pelas seguintes partes, separadas por dois-pontos (:): O endpoint OSS: oss-ap-southeast-1.aliyuncs.com. O nome do bucket OSS: rdsmssqlsingapore. A chave do arquivo de backup no bucket OSS: autotest_2008R2_TestMigration_FULL.bak. Nota Este parâmetro é opcional para instâncias que executam SQL Server 2008 R2. Este parâmetro é obrigatório para instâncias que executam uma versão de banco de dados posterior ao SQL Server 2008 R2.
OSSUrls	String	No	check_cdn_oss.sh www.xxxxxx.mobi	A URL compartilhada do arquivo de backup no bucket OSS. A URL deve ser codificada. Para especificar múltiplas URLs, separe-as com barras verticais (\|) e codifique-as em seguida. Nota Este parâmetro é obrigatório para instâncias que executam SQL Server 2008 R2.
MigrateTaskId	String	No	None	O ID da tarefa de migração. Valores válidos: Se BackupMode estiver definido como FULL, o valor deste parâmetro estará vazio. O modo de backup completo é compatível com instâncias que executam SQL Server 2008 R2. Se BackupMode estiver definido como UPDF, o valor deste parâmetro corresponde ao ID da tarefa de migração completa necessária. Nota Se IsOnlineDB estiver definido como True, BackupMode deve ser definido como FULL. Se IsOnlineDB estiver definido como False, BackupMode deve ser definido como UPDF.

Parâmetros de resposta

Parameter	Type	Example	Description
RequestId	String	866F5EB8-4650-4061-87F0-379F6F968BCE	O ID da requisição.
DBName	String	test02	O nome do banco de dados.
BackupMode	String	FULL	O tipo da tarefa de migração. Valores válidos: FULL: a tarefa de migração migra arquivos de backup completo. UPDF: a tarefa de migração migra arquivos de backup incremental ou de log.
DBInstanceId	String	rm-uf6wjk5xxxxx	O ID da instância.
MigrateTaskId	String	564563256	O ID da tarefa de migração.
TaskId	String	5451225	O ID da tarefa.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=CreateMigrateTask
&DBInstanceId=rm-uf6wjk5xxxxxxx
&DBName=testDB
&BackupMode=FULL
&IsOnlineDB=True
&OssObjectPositions=oss-ap-southeast-1.aliyuncs.com:rdsmssqlsingapore:autotest_2008R2_TestMigration_FULL.bak
&<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" ?>
<CreateMigrateTaskResponse>
	<MigrateTaskId>135847</MigrateTaskId>
	<DBInstanceId>rm-bp178grbxxxxxxx</DBInstanceId>
	<RequestId>5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2</RequestId>
	<BackupMode>UPDF</BackupMode>
	<TaskId>128301751</TaskId>
	<DBName>test02</DBName>
</CreateMigrateTaskResponse>

JSON formato

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

{
  "MigrateTaskId" : "135847",
  "DBInstanceId" : "rm-bp178grbxxxxxxx",
  "RequestId" : "5F2B3757-BD56-40B3-B5F2-FCDD9FA0E2E2",
  "BackupMode" : "UPDF",
  "TaskId" : "128301751",
  "DBName" : "test02"
}

Códigos de erro

HTTP status code	Error code	Error message	Description
400	InvalidFile	The operation does not support this kind of file	O erro foi retornado porque esta operação não é compatível com o tipo de arquivo atual.
400	InvalidInstanceType	The DB instance type does not support this operation.	O erro foi retornado porque a operação não é compatível com o tipo de instância atual.
400	InvalidInstanceLockMode	The DB instance lock mode does not support this operation.	O erro foi retornado porque esta operação não é compatível com instâncias bloqueadas.
400	InvalidDBName	The instance does not have the specified DB name.	O erro foi retornado porque o banco de dados de destino especificado não existe. Verifique o nome e o status do banco de dados de destino ou especifique outro banco de dados.
400	InvalidDBType	The DB type does not support this operation.	O erro foi retornado porque o status do banco de dados não é compatível com esta operação.
400	InvalidDBState	The DB state does not support this operation.	O erro foi retornado porque o estado atual do banco de dados não é compatível com esta operação.
400	ExceedUploadTime	Exceeding the daily upload times of this DB.	O erro foi retornado porque o número de downloads excedeu o limite diário do banco de dados.
400	InvalidOSSURL	The Specified OSS URL is not valid	O erro foi retornado porque a URL do OSS especificada é inválida.
400	ExceedDiskSize	The file size exceeding the disk size	O erro foi retornado porque o tamanho do arquivo excede a capacidade do disco. Verifique o tamanho do arquivo e tente novamente.
400	InvalideStatus	Parent migrate task status is invalid.	O erro foi retornado porque o status da tarefa de migração pai está anormal.
400	InvalidOssObjectStorageClassType	The specified OSS bucket storage type is invalid.	O erro foi retornado porque a classe de armazenamento do bucket OSS especificado é inválida.
403	InvalidInstanceState	The DB instance state does not support this operation.	O erro foi retornado porque o status da instância não é compatível com esta operação.

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