Consultar arquivos de backup de dados de uma instância excluída - : Central de Documentação do Alibaba Cloud

Esta operação é compatível com instâncias MySQL que usam SSDs locais. Para saber como reter os arquivos de backup de dados após a liberação da instância, consulte Configurar backup automático.

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 para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeDetachedBackups	Operação a ser executada. Defina o valor como DescribeDetachedBackups.
DBInstanceId	String	Não	rm-uf6wjk5xxxxxxx	ID da instância.
BackupId	String	Não	327xxxxx3	ID do arquivo de backup de dados.
BackupStatus	String	Não	Success	Status do arquivo de backup de dados. Valores válidos: Success Failed
BackupMode	String	Não	Automated	Modo de backup do arquivo de backup de dados. Valores válidos: Automated Manual
StartTime	String	Não	2021-03-01T16:00Z	Início do intervalo de tempo da consulta. Especifique a hora no padrão ISO 8601, no formato aaaa-MM-ddTHH:mmZ. A hora deve estar em UTC.
EndTime	String	Não	2021-03-15T16:00Z	Fim do intervalo de tempo da consulta. O horário final deve ser posterior ao inicial. A hora segue o padrão ISO 8601, no formato aaaa-MM-ddTHH:mmZ. A hora é exibida em UTC.
PageSize	Integer	Não	30	Número de entradas a retornar por página. Valores válidos: 30 50 100 Nota Valor padrão: 30.
PageNumber	Integer	Não	1	Número da página a retornar. Valores válidos: qualquer número inteiro positivo diferente de zero. Nota Valor padrão: 1.
Region	String	Sim	cn-hangzhou	ID da região da instância.
ResourceGroupId	String	Não	rg-acfmy*****	ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
PageNumber	String	1	Número da página retornada.
RequestId	String	1A6D328C-84B8-40DC-BF49-6C73984D7494	ID da solicitação.
PageRecordCount	String	30	Quantidade de arquivos de backup de dados na página.
TotalRecordCount	String	100	Total de entradas retornadas.
Items	Array of Backup		Detalhes dos arquivos de backup de dados retornados.
Backup
ConsistentTime	Long	1576506856	Momento em que os dados do arquivo de backup apresentam consistência. O valor retornado é um timestamp. Nota Se a instância executar o MySQL 5.6, um timestamp será retornado. Caso contrário, o valor retornado será 0.
StoreStatus	String	Disabled	Indica se é possível excluir o arquivo de backup de dados. Valores válidos: Enabled: o arquivo pode ser excluído. Disabled: o arquivo não pode ser excluído.
BackupStatus	String	Success	Status do arquivo de backup de dados. Valores válidos: Success Failed
BackupType	String	FullBackup	Tipo de backup. Valores válidos: FullBackup IncrementalBackup
BackupStartTime	String	2019-02-03T12:20:00Z	Hora de início do backup. A hora segue o padrão ISO 8601, no formato aaaa-MM-ddTHH:mmZ. A hora é exibida em UTC.
BackupDownloadURL	String	http://rdsbak-hz-v3.oss-cn-hangzhou.aliyuncs.com/xxxxx	URL para baixar o arquivo de backup de dados pela Internet. Se o download não for possível, uma string vazia será retornada.
IsAvail	Integer	1	Indica se o arquivo de backup de dados está disponível. Valores válidos: 0: indisponível. 1: disponível.
MetaStatus	String	OK	Status do arquivo de backup de dados usado para restaurar bancos de dados ou tabelas individuais. Valores válidos: OK: arquivo normal. LARGE: contém um número anormalmente grande de tabelas e não permite restaurar bancos de dados ou tabelas individuais. EMPTY: gerado por uma tarefa de backup com falha.
BackupEndTime	String	2019-02-13T12:20:00Z	Hora de término do backup. A hora segue o padrão ISO 8601, no formato aaaa-MM-ddTHH:mmZ. A hora é exibida em UTC.
BackupId	String	321020562	ID do arquivo de backup de dados.
HostInstanceID	String	5882781	Número da instância que gerou o arquivo de backup de dados. Este parâmetro indica se a instância de origem é primária ou secundária.
BackupIntranetDownloadURL	String	http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/xxxxx	URL para baixar o arquivo de backup de dados por uma rede interna. Se o download não for possível, uma string vazia será retornada.
BackupSize	Long	2167808	Tamanho do arquivo de backup de dados. Unidade: bytes.
BackupMode	String	Automated	Modo de backup do arquivo de backup de dados. Valores válidos: Automated Manual
DBInstanceId	String	rm-uf6wjk5xxxxxxx	ID da instância.
DBInstanceComment	String	test	Descrição da instância.
BackupMethod	String	Physical	Método usado para gerar o arquivo de backup de dados. Valores válidos: Logical: backup lógico Physical: backup físico

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeDetachedBackups
&Region=cn-hangzhou
&<Common request parameters>

Resposta de sucesso de exemplo

Formato XML

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

<DescribeDetachedBackupsResponse>
  <TotalRecordCount>1</TotalRecordCount>
  <PageRecordCount>1</PageRecordCount>
  <RequestId>B0BBC25A-6B3E-4BFD-A052-48664294E20D</RequestId>
  <PageNumber>1</PageNumber>
  <Items>
        <Backup>
              <BackupMethod>Snapshot</BackupMethod>
              <BackupInitiator>System</BackupInitiator>
              <StorageClass>0</StorageClass>
              <BackupMode>Automated</BackupMode>
              <BackupSize>161061273600</BackupSize>
              <BackupId>677987116</BackupId>
              <IsAvail>1</IsAvail>
              <HostInstanceID>9232003</HostInstanceID>
              <BackupDBNames></BackupDBNames>
              <StoreStatus>Disabled</StoreStatus>
              <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
              <BackupDownloadURL></BackupDownloadURL>
              <BackupEndTime>2020-07-11T05:07:33Z</BackupEndTime>
              <BackupStartTime>2020-07-11T05:07:33Z</BackupStartTime>
              <ConsistentTime>0</ConsistentTime>
              <BackupType>FullBackup</BackupType>
              <MetaStatus></MetaStatus>
              <BackupScale>DBInstance</BackupScale>
              <BackupStatus>Success</BackupStatus>
              <BackupLocation>OSS</BackupLocation>
        </Backup>
  </Items>
  <TotalBackupSize>161061273600</TotalBackupSize>
</DescribeDetachedBackupsResponse>

Formato JSON

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

{
  "TotalRecordCount" : 1,
  "PageRecordCount" : 1,
  "RequestId" : "B0BBC25A-6B3E-4BFD-A052-48664294E20D",
  "PageNumber" : 1,
  "Items" : {
    "Backup" : [ {
      "BackupMethod" : "Physical",
      "BackupIntranetDownloadURL" : "http://...",
      "BackupMode" : "Automated",
      "BackupSize" : 9405440,
      "BackupId" : 509538643,
      "IsAvail" : 1,
      "HostInstanceID" : 100453678,
      "BackupDBNames" : "",
      "StoreStatus" : "Enabled",
      "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
      "BackupDownloadURL" : "https://...",
      "BackupEndTime" : "2020-09-04T02:55:36Z",
      "BackupStartTime" : "2020-09-04T02:54:04Z",
      "ConsistentTime" : "1599188049",
      "BackupType" : "FullBackup",
      "MetaStatus" : "OK",
      "BackupScale" : "DBInstance",
      "BackupStatus" : "Success",
      "BackupLocation" : "OSS"
    } ]
  },
  "TotalBackupSize" : "161061273600"
}

Códigos de erro

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