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.

Nesta página

Mostrar todos

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

Criação de uma conta de banco de dados

Atualizado em 2025-02-07 GMT+08:00

Ver PDF

Função

Esta API é usada para criar uma conta de banco de dados para uma instância do TaurusDB. Antes de chamar essa API:

Saiba como autorizá-la e autenticá-la.
Obtenha a região e o ponto de extremidade necessários.

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 TaurusDB. Se seu valor for 10.10.10. %, todos os endereços IP 10.10.10.X podem acessar sua instância do TaurusDB. 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.

Tópico principal: Gerenciamento de usuários de banco de dados

Tópico anterior: Gerenciamento de usuários de banco de dados

Próximo tópico: Consulta de usuários do banco de dados

Feedback

Esta página foi útil?

Sim Não

Deixar um comentário

Obrigado por seus comentários. Estamos trabalhando para melhorar a documentação.

O sistema está ocupado. Tente novamente mais tarde.

Quais dos seguintes problemas você encontrou?

O conteúdo é inconsistente com a UI do produto

Descrições pouco claras

Falta de exemplos ou código

Passos incorretos

Não encontro o que preciso

Falta de melhores práticas

Feedback (opcional)

0/500

Selecione pelo menos um tipo de problema e insira seus comentários ou sugestões.

Insira um máximo de 500 caracteres.

Enviar Cancelar