Consultar tarefas de backup - : 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 também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeBackupTasks	A operação a ser executada. Defina o valor como DescribeBackupTasks.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	O ID da instância.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxx	Token de cliente usado para garantir a idempotência da solicitação. Gere o valor com o cliente e garanta que seja único entre solicitações distintas. O token aceita apenas caracteres ASCII e tem limite de 64 caracteres.
Flag	String	No	None	Parâmetro oculto.
BackupJobId	Integer	No	4762614	ID da tarefa de backup específica a consultar.
BackupMode	String	No	Automated	Modo de backup das tarefas a consultar. Valores válidos: Automated Manual
BackupJobStatus	String	No	NoStart	Status das tarefas de backup a consultar. Valores válidos: NoStart: consulta tarefas de backup não iniciadas. Progressing: consulta tarefas de backup em andamento. Por padrão, esta operação retorna tarefas de backup em ambos os estados.

Parâmetros de resposta

Parameter	Type	Example	Description
Items	Array of BackupJob		Matriz composta por tarefas de backup.
BackupJob
BackupId	String	346650271	ID do conjunto de backup gerado pela tarefa. Nota Se o parâmetro BackupStatus retornar Finished, especifique o parâmetro BackupJobId para obter o ID do conjunto de backup gerado.
BackupJobId	String	4762614	ID da tarefa de backup.
BackupProgressStatus	String	NoStart	Status do programa de backup. Valores válidos: NoStart: programa de backup não iniciado. Preparing: programa de backup em preparação. Waiting: programa de backup em espera. Uploading: programa de backup enviando o arquivo. Checking: programa de backup verificando o arquivo enviado. Finished: programa de backup concluído.
BackupStatus	String	NoStart	Status da tarefa de backup. Valores válidos: NoStart: tarefa de backup não iniciada. Checking: tarefa de backup verificando configurações. Preparing: tarefa de backup em preparação. Waiting: tarefa de backup em espera. Uploading: tarefa de backup enviando o arquivo. Finished: tarefa de backup concluída. Failed: falha na tarefa de backup. Nota Este parâmetro é retornado apenas durante a execução de uma tarefa de backup.
JobMode	String	Automated	Modo de backup da tarefa. Valores válidos: Automated Manual
Process	String	25	Progresso da tarefa de backup. Unidade: %.
TaskAction	String	NormalBackupTask	Tipo da tarefa de backup. Valores válidos: TempBackupTask: tarefa de backup temporária NormalBackupTask: tarefa de backup regular
RequestId	String	90496720-2319-42A8-87CD-FCE4DF95EBED	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/? Action=DescribeBackupTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeBackupTasksResponse>
	  <Items>
		    <BackupJob>
			      <JobMode>Automated</JobMode>
			      <BackupProgressStatus>NoStart</BackupProgressStatus>
			      <TaskAction>NormalBackupTask</TaskAction>
			      <BackupStatus>NoStart</BackupStatus>
			      <BackupJobId>4762614</BackupJobId>
		    </BackupJob>
	  </Items>
	  <RequestId>90496720-2319-42A8-87CD-FCE4DF95EBED</RequestId>
</DescribeBackupTasksResponse>

Formato JSON

{
    "Items": {
        "BackupJob": [
            {
                "JobMode": "Automated",
                "BackupProgressStatus": "NoStart",
                "TaskAction": "NormalBackupTask",
                "BackupStatus": "NoStart",
                "BackupJobId": 4762614
            }
        ]
    },
    "RequestId": "90496720-2319-42A8-87CD-FCE4DF95EBED"
}

Códigos de erro

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