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/TaurusDB/Referência de API/APIs (recomendadas)/Gerenciamento de usuários de banco de dados/Consulta de usuários do banco de dados
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Consulta de usuários do banco de dados

Função

Essa API é usada para consultar usuários de banco de dados de uma instância do TaurusDB. Antes de chamar essa API:

URI

GET /v3/{project_id}/instances/{instance_id}/db-users

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

offset

Não

Integer

Deslocamento do índice. Se offset for definido como N, a consulta de recursos será iniciada a partir da parte N+1 dos dados. O valor é 0 por padrão, indicando que a consulta começa a partir da primeira parte dos dados. O valor não pode ser um número negativo.

limit

Não

Integer

Número de registros a serem consultados. O valor padrão é 100. O valor deve ser um número inteiro positivo. O valor mínimo é 1 e o valor máximo é 100.

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.

Para obter esse valor, chame a API do IAM para obter um token de usuário.

O valor de X-Subject-Token no cabeçalho da resposta é o valor do token.

X-Language

Não

String

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

Valores:

  • 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

users

Array of ListGaussMySqlDatabaseUser objects

Lista de usuários do banco de dados.

total_count

Integer

Número total de usuários do banco de dados de uma instância de banco de dados.

Tabela 5 ListGaussMySqlDatabaseUser

Parâmetro

Tipo

Descrição

name

String

Nome de usuário do banco de dados.

host

String

Endereço IP do host.

comment

String

Observações da conta do banco de dados.

databases

Array of ListGaussMySqlDatabase objects

Lista de bancos de dados.

Tabela 6 ListGaussMySqlDatabase

Parâmetro

Tipo

Descrição

name

String

Nome do banco de dados.

readonly

Boolean

Se a permissão é somente leitura.

  • true: somente leitura
  • false: leitura/gravação

Código de status: 400

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.

Código de status: 500

Tabela 8 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

Consulta de usuários do banco de dados

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users?offset=0&limit=100

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "users" : [ {
    "name" : "gaussdb_mysql_user1",
    "host" : "127.0.0.1",
    "comment" : "database_user_comment", 
    "databases" : [ {
      "name" : "test",
      "readonly" : false
    } ]
  } ],
  "total_count" : 1
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.