Consultar arquivos de backup de dados entre regiões - : Central de Documentação do Alibaba Cloud

Para obter mais informações sobre como consultar os arquivos de backup de logs entre regiões de uma instância RDS, consulte DescribeCrossRegionLogBackupFiles.

Antes de chamar esta operação, verifique se a instância executa um dos seguintes mecanismos de banco de dados:

MySQL. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for MySQL entre regiões.
SQL Server. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for SQL Server entre regiões.
PostgreSQL. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for PostgreSQL entre regiões.

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeCrossRegionBackups	A operação a ser executada. Defina o valor como DescribeCrossRegionBackups.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxxxxx	O ID da instância.
RegionId	String	Sim	cn-hangzhou	O ID da região da instância.
CrossBackupRegion	String	Não	cn-shanghai	O ID da região de destino onde o arquivo de backup de dados entre regiões está armazenado.
CrossBackupId	Integer	Não	14562	O ID do arquivo de backup de dados entre regiões. Nota Especifique o parâmetro CrossBackupId ou os parâmetros StartTime e EndTime.
StartTime	String	Não	2019-05-30T12:10:00Z	O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
EndTime	String	Não	2019-06-15T12:10:00Z	O fim do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.
PageSize	Integer	Não	30	O número de entradas a retornar por página. Valores válidos: 30 50 100 Valor padrão: 30.
PageNumber	Integer	Não	1	O número da página a retornar. Valores válidos: qualquer número inteiro positivo diferente de zero. Valor padrão: 1.
BackupId	Integer	Não	603524***	O ID do arquivo de backup de dados entre regiões.
ResourceGroupId	String	Não	rg-acfmy*****	O ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
EndTime	String	2019-06-15T12:10:00Z	O fim do intervalo de tempo consultado.
StartTime	String	2019-05-30T12:10:00Z	O início do intervalo de tempo consultado.
RequestId	String	60912B41-7579-4B5D-B289-8856030F0A6A	O ID da solicitação.
PageRecordCount	Integer	30	O número de arquivos de backup de dados entre regiões na página atual.
TotalRecordCount	Integer	100	O número total de entradas retornadas.
PageNumber	Integer	1	O número da página retornada. Valores válidos: qualquer número inteiro positivo diferente de zero. Valor padrão: 1.
RegionId	String	cn-hangzhou	O ID da região da instância.
Items	Array of Item		Um array com os detalhes dos arquivos de backup de dados entre regiões.
Item
ConsistentTime	String	2019-06-12T05:44:46Z	O ponto no tempo indicado pelos dados no arquivo de backup de dados entre regiões.
DBInstanceStorageType	String	ssd	O tipo de armazenamento. Valores válidos: local_ssd: SSD local. Tipo de armazenamento recomendado. cloud_ssd: SSD padrão. cloud_essd: SSD aprimorado (ESSD).
CrossBackupId	Integer	14377	O ID do arquivo de backup de dados entre regiões.
BackupType	String	F	O tipo do backup de dados entre regiões. Valores válidos: F: backup completo de dados I: backup incremental de dados
BackupStartTime	String	2019-05-30T12:10:00Z	A hora de início do backup de dados entre regiões.
CrossBackupSetLocation	String	oss	O local onde o arquivo de backup de dados entre regiões está armazenado.
InstanceId	Integer	8161055	O ID da instância. Este parâmetro indica se a instância que gerou o arquivo de backup de dados entre regiões é primária ou secundária.
CrossBackupDownloadLink	String	http://rdsddrbak-shanghai.oss-cn-shanghai.aliyuncs.com/xxxxx	A URL externa para baixe o arquivo de backup de dados entre regiões.
BackupEndTime	String	2019-06-15T12:10:00Z	A hora de geração do arquivo de backup de dados entre regiões.
EngineVersion	String	5.6	A versão do mecanismo de banco de dados.
BackupSetStatus	Integer	0	O status do backup de dados entre regiões. Valores válidos: 0: backup de dados entre regiões bem-sucedido. 1: falha no backup de dados entre regiões.
CrossBackupSetFile	String	cn-hangzhou_rm-xxxxx_hins81xxx_data_20190612134426_qp.xb	O nome do pacote compactado que contém o arquivo de backup de dados entre regiões.
BackupSetScale	Integer	0	O nível de geração do arquivo de backup de dados entre regiões. 0: backup no nível da instância 1: backup no nível do banco de dados
CrossBackupSetSize	Long	5312836	O tamanho do arquivo de backup de dados entre regiões. Unidade: bytes.
CrossBackupRegion	String	cn-shanghai	O ID da região de destino onde o arquivo de backup de dados entre regiões da instância está armazenado.
Category	String	HighAvailability	A edição RDS da instância. Valores válidos: Basic: Basic Edition. HighAvailability: High-availability Edition. Finance: Enterprise Edition. Disponível apenas no site da China (aliyun.com).
Engine	String	mysql	O mecanismo do banco de dados.
BackupMethod	String	P	O método usado para gerar o arquivo de backup de dados entre regiões. Valores válidos: L: backup lógico P: backup físico
RestoreRegions	Array of String	"cn-hangzhou", "cn-shanghai"	Um array com as regiões nas quais o arquivo de backup de dados entre regiões pode ser restaurado.

Exemplos

Solicitações de exemplo

http(s)://rds.aliyuncs.com/?Action=DescribeCrossRegionBackups
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RegionId=cn-hangzhou
&CrossBackupId=14562
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<DescribeCrossRegionBackupsResponse>
<Items>
		<Item>
			<CrossBackupSetFile>cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz</CrossBackupSetFile>
			<BackupSetScale>0</BackupSetScale>
			<BackupType>F</BackupType>
			<InstanceId>7980000</InstanceId>
			<CrossBackupId>14358</CrossBackupId>
			<BackupEndTime>2019-06-11T04:55:02Z</BackupEndTime>
			<BackupMethod>P</BackupMethod>
			<CrossBackupSetLocation>oss</CrossBackupSetLocation>
			<CrossBackupSetSize>2179643</CrossBackupSetSize>
			<Engine>mysql</Engine>
			<BackupStartTime>2019-06-11T04:52:46Z</BackupStartTime>
			<CrossBackupDownloadLink>http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&amp;Expires=1560501641&amp;Signature=laK0kxxxxx%3D</CrossBackupDownloadLink>
			<Category>HighAvailability</Category>
			<CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
			<RestoreRegions>
				<RestoreRegion>cn-hangzhou</RestoreRegion>
				<RestoreRegion>cn-zhangjiakou</RestoreRegion>
			</RestoreRegions>
			<EngineVersion>5.7</EngineVersion>
			<DBInstanceStorageType>ssd</DBInstanceStorageType>
		</Item>
	</Items>
	<TotalRecordCount>1</TotalRecordCount>
	<PageNumber>1</PageNumber>
	<RequestId>60912B41-7579-4B5D-B289-8856030F0A6A</RequestId>
	<RegionId>cn-hangzhou</RegionId>
	<EndTime>2019-06-11T08:00:00Z</EndTime>
	<StartTime>2019-06-10T00:00:00Z</StartTime>
	<PageRecordCount>30</PageRecordCount>
    </DescribeCrossRegionBackupsResponse>

Formato JSON

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

{
  "Items" : {
    "Item" : [ {
      "CrossBackupSetFile" : "cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz",
      "BackupSetScale" : 0,
      "BackupType" : "F",
      "InstanceId" : 7980000,
      "CrossBackupId" : 14358,
      "BackupEndTime" : "2019-06-11T04:55:02Z",
      "BackupMethod" : "P",
      "CrossBackupSetLocation" : "oss",
      "CrossBackupSetSize" : 2179643,
      "Engine" : "mysql",
      "BackupStartTime" : "2019-06-11T04:52:46Z",
      "CrossBackupDownloadLink" : "http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&Expires=1560501641&Signature=laK0kxxxxx%3D",
      "Category" : "HighAvailability",
      "CrossBackupRegion" : "cn-zhangjiakou",
      "RestoreRegions" : {
        "RestoreRegion" : [ "cn-hangzhou", "cn-zhangjiakou" ]
      },
      "EngineVersion" : "5.7",
      "DBInstanceStorageType" : "ssd"
    } ]
  },
  "TotalRecordCount" : 1,
  "PageNumber" : 1,
  "RequestId" : "60912B41-7579-4B5D-B289-8856030F0A6A",
  "RegionId" : "cn-hangzhou",
  "EndTime" : "2019-06-11T08:00:00Z",
  "StartTime" : "2019-06-10T00:00:00Z",
  "PageRecordCount" : 30
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidRegion.Format	Specified Region is not valid.	Erro retornado porque a região especificada é inválida.
400	InvalidStartTime.Format	Specified start time is not valid.	Erro retornado porque a hora de início especificada é inválida.
400	InvalidEndTime.Format	Specified end time is not valid.	Erro retornado porque a hora de término especificada é inválida. Especifique um valor válido e tente novamente.
400	InvalidTime.Format	Specified time is not valid.	Erro retornado porque o formato da hora é inválido.
403	CrossBackupNotSupport	Specified region not support cross region backup.	Erro retornado porque a região especificada não oferece suporte ao recurso de backup entre regiões.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	Erro retornado porque a instância não foi encontrada, foi excluída ou não oferece suporte à operação.

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