Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Backup e restauração/ Obtenção da lista de bancos de dados que podem ser restaurados
Atualizado em 2023-05-06 GMT+08:00

Obtenção da lista de bancos de dados que podem ser restaurados

Descrição

Esta API é usada para obter a lista de bancos de dados que podem ser restaurados.

Restrições

Essa API se aplica somente a conjuntos de réplicas.

Depuração

Você pode depurar essa API no API Explorer.

URI

  • Formato de URI

    GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/restore-database?restore_time={restore_time}&offset={offset}&limit={limit}

  • Exemplo de URI

    https://dds.ap-southeast-1.myhuaweicloud.com/v3/056538411200d4cd2f79c003c7606412/instances/d5833c2854a4486cb7960f829269e211in02/restore-database?restore_time=1607689584000&limit=10&offset=1

Tabela 1 Parâmetros de solicitação

Nome

Tipo

Obrigatório

Descrição

x-auth-token

String

Sim

Token do usuário

X-Language

String

Não

Língua

project_id

String

Sim

ID do projeto. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.

instance_id

String

Sim

ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

restore_time

String

Sim

Especifica o ponto de tempo de restauração.

O valor é um carimbo de data/hora UNIX, em milissegundos. O fuso horário é UTC.

offset

Integer

Não

Especifica a posição do índice.

  • O valor deve ser superior ou igual a 0.
  • Se este parâmetro não for transferido, o valor é 0 por padrão.

limit

Integer

Não

Especifica o limite superior do número de registros consultados.

  • O valor varia de 1 a 100.
  • Se esse parâmetro não for transferido, os primeiros 100 registros serão consultados por padrão.

Solicitações

Nenhuma

Respostas

  • Descrição do parâmetro
    Tabela 2 Descrição do parâmetro

    Nome

    Tipo

    Obrigatório

    Descrição

    databases

    Array of String

    Sim

    Indica a lista do banco de dados. Cada elemento da lista indica um banco de dados.

    total_count

    Integer

    Sim

    Indica o número total de bancos de dados.

  • Exemplo de resposta
    {
      "databases": [
        "test_db"
      ],
      "total_count": 1
    }

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.

Código de status

Para obter mais informações, consulte Código de status.

Código de erro

Para obter mais informações, consulte Código de erro.