Consultar tarefas de migração de dados de backup - : Central de Documentação do Alibaba Cloud

Esta operação permite consultar as tarefas de migração criadas para a instância na última semana.

Nota

Esta operação é compatível apenas com tarefas de migração de arquivos de backup completo.
Instâncias que executam o SQL Server 2017 (cluster edition) não oferecem suporte a esta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer 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	DescribeMigrateTasks	Operação a ser executada. Defina o valor como DescribeMigrateTasks.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	ID da instância.
StartTime	String	Sim	2017-10-20T01:00Z	Início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-dd T HH:mm Z. A hora deve estar em UTC.
EndTime	String	Sim	2017-10-25T01:00Z	Fim do intervalo de tempo a ser consultado. A hora final deve ser posterior à hora inicial. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-dd T HH:mm Z. A hora deve estar em UTC.
PageSize	Integer	Não	30	Número de entradas a serem retornadas em cada página. Valores válidos: de 30 a 100. Valor padrão: 30.
PageNumber	Integer	Não	1	Número da página a ser retornada. Valores válidos: qualquer número inteiro positivo diferente de zero. Valor padrão: 1.
ResourceGroupId	String	Não	rg-acfmy*	ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
DBInstanceId	String	rm-uf6wjk5xxxxxxx	ID da instância.
PageNumber	Integer	1	Número da página retornada.
RequestId	String	4E356DDF-6B83-45DB-99D5-4B1E8A0D286B	ID da solicitação.
PageRecordCount	Integer	10	Número de entradas retornadas em cada página.
TotalRecordCount	Integer	30	Número total de entradas retornadas.
Items	Array of MigrateTask		Detalhes da tarefa de migração.
MigrateTask
EndTime	String	2017-05-30T13:11:04Z	Hora de conclusão da tarefa de migração. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibida em UTC.
Status	String	Success	Status da tarefa de migração. Valores válidos: NoStart: A tarefa não foi iniciada. Running: A tarefa está em andamento. Success: A tarefa foi concluída com êxito. Failed: A tarefa falhou. Waiting: A tarefa aguarda a importação de um arquivo de backup incremental.
Description	String	Api description	Descrição da tarefa de migração.
CreateTime	String	2017-05-30T12:11:04Z	Hora de criação da tarefa de migração. Segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ e é exibida em UTC.
DBName	String	testDB	Nome do banco de dados.
BackupMode	String	FULL	Tipo da tarefa de migração. Valores válidos: FULL: Migra arquivos de backup completo para restaurar todos os dados da instância. UPDF: Migra arquivos de backup incremental ou de log para restaurar os dados incrementais da instância.
MigrateTaskId	String	564522545	ID da tarefa de migração.
IsDBReplaced	String	True	Indica se os dados importados substituem os dados existentes.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2017-10-20T01:00Z
&EndTime=2017-10-25T01:00Z
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeMigrateTasksResponse>
	<RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
	<PageRecordCount>1</PageRecordCount>
	<PageNumber>1</PageNumber>
	<TotalRecordCount>10</TotalRecordCount>
	<Items>
		<MigrateTaskId>rm-bp1842vxxxxx</MigrateTaskId>
		<DBName>test02</DBName>
		<CreateTime>2017-05-30 T12:11:4Z</CreateTime>
		<EndTime>2017-05-30 T12:11:4Z</EndTime>
		<IsDBReplaced>True</IsDBReplaced>
		<Status>Success</Status>
		<BackupMode>FULL</BackupMode>
		<Description>Api description</Description>
	</Items>
</DescribeMigrateTasksResponse>

Formato JSON

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

{
  "RequestId" : "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
  "PageRecordCount" : 1,
  "PageNumber" : 1,
  "TotalRecordCount" : 10,
  "Items" : {
    "MigrateTaskId" : "rm-bp1842vxxxxx",
    "DBName" : "test02",
    "CreateTime" : "2017-05-30 T12:11:4Z",
    "EndTime" : "2017-05-30 T12:11:4Z",
    "IsDBReplaced" : "True",
    "Status" : "Success",
    "BackupMode" : "FULL",
    "Description" : "Api description"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidStartTimeAndEndTime.Malformed	The end time must be greater than the start time	A hora final deve ser posterior à hora inicial.
403	InvalidInstanceState	The DB instance state does not support this operation.	O status da instância não oferece suporte a esta operação.

Para obter uma lista de códigos de erro, visite o API Error Center.