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/ GaussDB(for MySQL)/ Referência de API/ APIs (recomendadas)/ Gerenciamento de logs/ Obtenção do link temporário para download do SQL completo
Atualizado em 2024-09-29 GMT+08:00
Ver PDF
Compartilhar

Obtenção do link temporário para download do SQL completo

Função

Essa API é usada para obter o link temporário para baixar o SQL completo. Antes de chamar essa API:

URI

GET /v3/{project_id}/instance/{instance_id}/auditlog/download-link

Tabela 1 Parâmetros de URI

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

ID do projeto de um locatário numa região.

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

instance_id

Sim

String

ID da instância, que é compatível com o formato UUID.
Tabela 2 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

node_id

Não

String

ID do nó.

  • Se esse parâmetro for especificado, o link será usado apenas para baixar o SQL completo do nó.
  • Se esse parâmetro não for especificado, o link será usado para baixar o SQL completo de todos os nós da instância.

last_file_name

Não

String

Nome do último arquivo consultado da última vez.

  • Se este parâmetro for especificado, a consulta começará a partir do nome do arquivo em ordem alfabética.
  • Se este parâmetro não for especificado, a consulta será iniciada a partir do primeiro arquivo.

limit

Não

Integer

Número de arquivos retornados numa consulta.

Valor padrão: 10. Valor: um número inteiro que varia de 1 a 50

start_time

Sim

String

Hora de início, que não pode ser anterior à hora de criação da instância. O formato é aaaa-mm-ddThh:mm:ssZ.

T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.

end_time

Sim

String

Hora de término, que não pode ser posterior à hora atual. O formato é aaaa-mm-ddThh:mm:ssZ.

T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.

Parâmetros de solicitação

Tabela 3 Parâmetros de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

Se o corpo de resposta a seguir for retornado para chamar a API usada para obter um token de usuário, a solicitação será bem-sucedida.

Depois que a solicitação é processada, o valor de X-Subject-Token no cabeçalho da mensagem é o valor do token.

X-Language

Não

String

Tipo de linguagem da solicitação. O valor padrão é en-us.

Valor:

  • en-us
  • zh-cn

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

files

Array of FileInfo objects

Informações do arquivo SQL completo obtidas.
Tabela 5 FileInfo

Parâmetro

Tipo

Descrição

name

String

Nome de arquivo.

size

Long

Tamanho do arquivo, em KB.

updated_time

String

Hora da última modificação do arquivo SQL. O formato é aaaa-mm-ddThh:mm:ssZ.

T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.

download_link

String

Link para download do arquivo.

link_expired_time

String

Tempo de expiração do link. O formato é aaaa-mm-ddThh:mm:ssZ.

T é o separador entre o calendário e a notação horária do tempo. Z indica o deslocamento do fuso horário. Por exemplo, se o deslocamento de fuso horário for de uma hora, o valor de Z será +0100.

Código de status: 400

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Código de status: 500

Tabela 7 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

error_code

String

Código de erro.

error_msg

String

Mensagem de erro.

Exemplo de solicitação

Obtenção do link temporário para download do SQL completo

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instance/669a94abef9f4979b2dfba92f48f4042in07/auditlog/download-link?node_id=2e723b45786148fc94c8737f5980786cno07&last_file_name=20230724160316_99b1d48896bb44178b715d64b68603f9in07_6a21d5df9bb24f5db83121c5fec0b1d2no07_SQLAudit_8b4b53d2-29f8-11ee-92aa-fa163ef00f0d&limit=10&start_time=2023-07-24T09:27:00+0800&end_time=2023-07-25T15:00:14+0800

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "files" : [ {
    "name" : "20230706023359_669a94abef9f4979b2dfba92f48f4042in07_b051c8f7b98f4deeaf88ba97c8daba9dno07_SQLAudit_903bdbb6-1ba5-11ee-8b97-fa163ef0f8c2",
    "size" : 928,
    "updated_time" : "2023-07-06T02:43:57+0800",
    "download_link" : "https://obs.obs.domainname.com/bucketname/userid_instanceid/20230706/SQLAudit/xxxxxx",
    "link_expired_time" : "2023-07-13T012:30:36+0800"
  } ]
}

Código de status

Código de status

Descrição

200

Bem-sucedido.

400

Erro do cliente.

500

Erro no servidor.

Código de erro

Para obter detalhes, consulte Códigos de erro.

Tópico principal: Gerenciamento de logs