Chame a operação DescribeCrossBackupMetaList para consultar os bancos de dados e as tabelas cujos dados estão incluídos em um arquivo de backup entre regiões de uma instância do ApsaraDB RDS.
As instâncias do ApsaraDB RDS for MySQL oferecem suporte a backup e restauração entre regiões. Para mais informações, consulte Fazer backup de uma instância do ApsaraDB RDS for MySQL entre regiões e Restaurar os dados de uma instância do ApsaraDB RDS for MySQL entre regiões.
Antes de chamar esta operação, verifique se a instância utiliza 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
Parâmetros de requisição
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DescribeCrossBackupMetaList | A operação a ser executada. Defina o valor como DescribeCrossBackupMetaList. |
| BackupSetId | String | Yes | 123456 | O ID do arquivo de backup entre regiões a ser usado. Chame a operação DescribeCrossRegionBackups para consultar o ID do arquivo de backup entre regiões. |
| GetDbName | String | No | testdb1 | O nome do banco de dados a ser consultado. O sistema aplica correspondência exata com base no valor deste parâmetro e retorna o nome do banco de dados correspondente e os nomes das tabelas contidas nele. |
| Pattern | String | No | test | O nome do banco de dados a ser consultado. O sistema aplica correspondência parcial com base no valor deste parâmetro e retorna apenas o nome do banco de dados correspondente. Nota É possível combinar correspondência parcial com correspondência exata. Por exemplo, defina o parâmetro Pattern como test para consultar os bancos de dados testdb1 e testdb2. Em seguida, especifique o parâmetro GetDbName para consultar apenas o banco de dados correspondente e as tabelas contidas nele. |
| PageSize | String | No | 30 | O número de entradas a retornar por página. Valor padrão: 1. Nota Este parâmetro é válido apenas quando o parâmetro PageIndex for especificado. |
| PageIndex | String | No | 1 | O número da página a retornar. Valores válidos: qualquer número inteiro positivo diferente de zero. Nota Este parâmetro é válido apenas quando o parâmetro PageSize for especificado. |
| Region | String | No | cn-hangzhou | O ID da região da instância. |
| ResourceGroupId | String | No | rg-acfmy***** | O ID do grupo de recursos. |
Parâmetros de resposta
|
Parameter |
Type |
Example |
Description |
|
DBInstanceName |
String |
rm-uf6wjk5xxxxxxx |
A instância à qual o arquivo de backup entre regiões pertence. |
|
TotalPageCount |
Integer |
1 |
O número total de páginas retornadas. |
|
RequestId |
String |
60F9A12A-16B8-4728-B099-4CA38D32C31C |
O ID da requisição. |
|
PageRecordCount |
Integer |
1 |
O número de entradas retornadas na página atual. |
|
TotalRecordCount |
Integer |
1 |
O número total de entradas retornadas. |
|
PageNumber |
Integer |
1 |
O número da página retornada. |
|
Items |
Array of Meta |
Um array com informações sobre os bancos de dados e as tabelas cujos dados estão incluídos no arquivo de backup entre regiões. |
|
|
Meta |
|||
|
Tables |
String |
test1,test2 |
Um array com os nomes das tabelas contidas no banco de dados. Se o banco de dados contiver mais de uma tabela, os nomes serão separados por vírgulas (,). |
|
Database |
String |
testdb1 |
O nome do banco de dados. |
|
Size |
String |
1000 |
O tamanho da tabela. Unidade: KB. Se o banco de dados contiver mais de uma tabela, os nomes serão separados por vírgulas (,). |
Exemplos
Exemplos de requisição
http(s)://rds.aliyuncs.com/?Action=DescribeCrossBackupMetaList
&BackupSetId=123456
&GetDbName=testdb1
&PageSize=30
&PageIndex=1
&<Common request parameters>Exemplos de resposta bem-sucedida
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeCrossBackupMetaListResponse>
<TotalRecordCount>1</TotalRecordCount>
<TotalPageCount>1</TotalPageCount>
<RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
<PageNumber>1</PageNumber>
<Items>
<Meta>
<Size>4320</Size>
<Size>5</Size>
<Database>testdb1</Database>
<Tables>test1</Tables>
<Tables>test2</Tables>
</Meta>
</Items>
<DBInstanceName>rm-uf6wjk5xxxxxxx</DBInstanceName>
</DescribeCrossBackupMetaListResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"TotalRecordCount" : 1,
"TotalPageCount" : 1,
"RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C",
"PageNumber" : 1,
"Items" : {
"Meta" : [ {
"Size" : [ 4320, 5 ],
"Database" : "testdb1",
"Tables" : [ "test1", "test2" ]
} ]
},
"DBInstanceName" : "rm-uf6wjk5xxxxxxx"
}Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
400 |
InvalidPageSize |
The page size is invalid |
O erro foi retornado porque o valor do parâmetro PageSize é inválido. Especifique um valor válido para o parâmetro PageSize. |
|
400 |
InvalidRestoreTime.Format |
Specified restore time is not valid. |
O erro foi retornado porque o valor do parâmetro RestoreTime é inválido. Especifique um valor válido para o parâmetro RestoreTime. |
|
403 |
InvalidMeta.Empty |
Meta information is empty. |
O erro foi retornado porque o valor do parâmetro Meta está vazio. |
|
403 |
IncorrectDBInstanceType |
Current DB instance type does not support this operation. |
O erro foi retornado porque esta operação não é compatível com a instância no estado atual. |
|
403 |
IncorrectEngineVersion |
Current engine version does not support operations. |
O erro foi retornado porque esta operação não é compatível com a versão do mecanismo de banco de dados em execução na instância. |
|
403 |
InvalidBackupLogStatus |
Current backup log enable status does not support this operation. |
O erro foi retornado porque o recurso de backup de log está desabilitado e, por isso, os dados não podem ser restaurados para um ponto específico no tempo. |
|
404 |
InvalidBackupSetID.NotFound |
Specified backup set ID does not exist. |
O erro foi retornado porque o arquivo de backup de dados especificado não existe. Especifique um arquivo de backup de dados válido. |
|
404 |
Request.NotFound |
The requested resource is not available. |
O erro foi retornado porque o recurso solicitado não está disponível. |
Para obter a lista de códigos de erro, acesse o API Error Center.