Consultar um arquivo de backup de dados para bancos de dados e tabelas - : Central de Documentação do Alibaba Cloud

Antes de chamar a operação RestoreTable para restaurar bancos de dados ou tabelas individuais de uma instância do ApsaraDB RDS for MySQL, use esta operação para obter informações sobre quais bancos de dados e tabelas podem ser restaurados. Para mais detalhes, consulte Restaurar bancos de dados e tabelas individuais de uma instância do ApsaraDB RDS for MySQL.

Nota

Esta operação é compatível apenas com instâncias que executam MySQL 8.0, MySQL 5.7 ou MySQL 5.6 no RDS High-availability Edition com SSDs locais.

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 da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeMetaList	Operação a ser executada. Defina o valor como DescribeMetaList.
ClientToken	String	Não	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Token de cliente usado para garantir a idempotência da solicitação. Gere o valor pelo cliente, mas garanta que o token seja exclusivo entre diferentes solicitações. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.
DBInstanceId	String	Sim	rm-uf6wjk5xxxxxxx	ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.
RestoreType	String	Não	BackupSetID	Método de restauração de dados. Valores válidos: BackupSetID: restaura dados de um arquivo de backup. Ao usar este valor, especifique também o parâmetro BackupSetID. RestoreTime: restaura dados até um ponto específico no tempo. Ao usar este valor, especifique também o parâmetro RestoreTime. Valor padrão: BackupSetID.
BackupSetID	Integer	Não	14358	ID do arquivo de backup de dados de origem da restauração. Chame a operação DescribeBackups para consultar os IDs dos arquivos de backup de dados. Nota Este parâmetro é obrigatório quando o parâmetro RestoreType é definido como BackupSetID.
RestoreTime	String	Não	2019-05-30T03:29:10Z	Ponto no tempo até o qual restaurar os dados. O ponto especificado deve ser anterior à hora atual. Especifique a hora no padrão ISO 8601, no formato aaaa-MM-ddTHH:mm:ssZ, em UTC. Chame a operação DescribeBackups para consultar o intervalo de tempo restaurável. Nota Este parâmetro é obrigatório quando o parâmetro RestoreType é definido como RestoreTime.
GetDbName	String	Não	testdb1	Nome do banco de dados a consultar. O ApsaraDB RDS faz uma correspondência exata com base neste parâmetro e retorna o nome do banco de dados correspondente, além dos nomes de todas as tabelas nele contidas. Nota Se este parâmetro estiver vazio, o ApsaraDB RDS retornará todos os bancos de dados criados na instância.
Pattern	String	Não	test	Nome do banco de dados a consultar. O ApsaraDB RDS faz uma correspondência aproximada com base neste parâmetro e retorna apenas os nomes dos bancos de dados correspondentes. Nota Por exemplo, se definir o valor como `test`, o ApsaraDB RDS retornará `testdb1` e `testdb2`. Em seguida, especifique o parâmetro GetDbName para consultar as tabelas no banco de dados desejado.
PageSize	Integer	Não	1	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 é especificado.
PageIndex	Integer	Não	1	Número da página a retornar. Valores válidos: qualquer inteiro positivo diferente de zero. Valor padrão: 1. Nota Este parâmetro é válido apenas quando o parâmetro PageSize é especificado.
ResourceGroupId	String	Não	rg-acfmy*****	ID do grupo de recursos.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
DBInstanceName	String	rm-uf6wjk5xxxxxxx	Nome da instância.
TotalPageCount	Integer	1	Número total de páginas retornadas.
RequestId	String	60F9A12A-16B8-4728-B099-4CA38D32C31C	ID da solicitação.
PageRecordCount	Integer	1	Número de entradas retornadas na página atual.
TotalRecordCount	Integer	1	Número total de entradas retornadas.
PageNumber	Integer	1	Número da página retornada.
Items	Array of Meta		Matriz com informações sobre os bancos de dados e as tabelas cujos dados estão incluídos no arquivo de backup de dados.
Meta
Tables	String	test1	Nome da tabela.
Database	String	testdb1	Nome do banco de dados.
Size	String	64	Tamanho da tabela. Unidade: KB.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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

<DescribeMetaList>
    <TotalPageCount>1</TotalPageCount>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>1</PageRecordCount>
    <RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <Meta>
            <Size>64</Size>
            <Database>testdb1</Database>
            <Tables>test1</Tables>
        </Meta>
    </Items>
    <DBInstanceName>rm-uf6wjk5xxxxxxx</DBInstanceName>
</DescribeMetaList>

Formato JSON

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

{
  "TotalPageCount" : "1",
  "TotalRecordCount" : "1",
  "PageRecordCount" : "1",
  "RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C",
  "PageNumber" : "1",
  "Items" : {
    "Meta" : [ {
      "Size" : "64",
      "Database" : "testdb1",
      "Tables" : "test1"
    } ]
  },
  "DBInstanceName" : "rm-uf6wjk5xxxxxxx"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidPageSize	The page size is invalid	O valor do parâmetro pageSize é inválido. Insira um número válido.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	O tempo de restauração especificado é inválido. Insira um horário válido.
403	InvalidMeta.Empty	Meta information is empty.	As informações de metadados estão nulas.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Esta operação não é compatível com o estado atual da instância.
403	IncorrectEngineVersion	Current engine version does not support operations.	Esta operação não é compatível com a versão do mecanismo de banco de dados da instância.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	O recurso de backup de logs está desativado e os dados não podem ser restaurados até um ponto específico no tempo.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	O arquivo de backup de dados especificado não foi encontrado. Verifique os arquivos de backup de dados existentes.

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