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/ Criação de uma conta de banco de dados
Atualizado em 2024-09-29 GMT+08:00
Ver PDF
Compartilhar

Criação de uma conta de banco de dados

Função

Esta API é usada para criar uma conta de banco de dados para uma instância do GaussDB(for MySQL). Antes de chamar essa API:

URI

POST /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 em uma região.

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

instance_id

Sim

String

ID da instância.

Parâmetros de solicitação

Tabela 2 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
Tabela 3 Parâmetro do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

users

Sim

Array of CreateDatabaseUserList objects

Lista de usuários do banco de dados. A lista contém até 50 usuários de banco de dados.
Tabela 4 CreateDatabaseUserList

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome de usuário do banco de dados. O valor pode conter de 1 a 32 caracteres, incluindo letras, dígitos e sublinhados (_).

comment

Não

String

Observações do banco de dados. O valor pode consistir em até 512 caracteres e não pode conter os caracteres de retorno de carro ou caracteres especiais (!<"='>&).

Esse campo é adequado apenas para instâncias 2.0.13.0 ou posterior. Para atualizar uma instância para a versão mais recente, consulte Atualização da versão do kernel de uma instância de BD.

password

Sim

String

Senha do usuário do banco de dados. Não pode ser igual ao nome de usuário. O valor não pode estar vazio e deve consistir de 8 a 32 caracteres e conter pelo menos três dos seguintes tipos: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais (~!@#$%^*-_=+?,()&).

É aconselhável inserir uma senha forte para melhorar a segurança e evitar riscos de segurança, como quebra de força bruta.

hosts

Não

Array of strings

Endereço IP do host. O valor padrão é %, indicando que todos os endereços IP têm permissão para acessar sua instância do GaussDB(for MySQL). Se seu valor for 10.10.10. %, todos os endereços IP 10.10.10.X podem acessar sua instância do GaussDB(for MySQL). Você pode adicionar até 50 endereços IP e separá-los com vírgula (,), por exemplo, 192.168.0.1,172.16.213.9 (sem espaços antes e depois da vírgula).

databases

Não

Array of CreateDatabaseList objects

Lista dos bancos de dados. A lista contém até 50 bancos de dados. Ao criar um usuário de banco de dados, você pode autorizar as permissões de bancos de dados na lista para o usuário. Se não houver um banco de dados na lista, você poderá invocar uma API para autorizar permissões de banco de dados para o usuário do banco de dados.
Tabela 5 CreateDatabaseList

Parâmetro

Obrigatório

Tipo

Descrição

name

Sim

String

Nome do banco de dados.

readonly

Sim

Boolean

Se a permissão é somente leitura.

Valor:

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

Parâmetros de resposta

Código de status: 201

Tabela 6 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

job_id

String

ID da tarefa para criar uma conta de banco de dados.

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

Criação de um usuário de banco de dados com permissão de leitura/gravação (o endereço IP do host é 127.0.0.1.)

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/db-users
{
  "users" : [ {
    "name" : "gaussdb_mysql_user1",
    "password" : "Rds_1234",
    "hosts" : [ "127.0.0.1" ],
    "comment" : "database_user_comment", 
    "databases" : [ {
      "name" : "test",
      "readonly" : false
    } ]
  } ]
}

Exemplo de resposta

Código de status: 201

Bem-sucedido.

{
  "job_id" : "dff1d289-4d03-4942-8b9f-463ea07c000d"
}

Código de status

Para mais detalhes, consulte Códigos de status.

Código de erro

Para mais detalhes, consulte Códigos de erro.