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 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
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. |
Parâmetros 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:
|
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. |
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 (_). |
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 conter de 8 a 32 caracteres e conter pelo menos três tipos dos seguintes: 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. |
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 os seguintes 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. |
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 o endereço IP estiver definido como 10.10.10.%, todos os endereços IP na sub-rede 10.10.10.X terão permissão para 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 conceder 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 conceder permissões de banco de dados para o usuário do banco de dados. |
Parâmetros de resposta
Código de status: 201
Parâmetro | Tipo | Descrição |
|---|---|---|
job_id | String | ID da tarefa para criar uma conta de banco de dados. |
Código de status: 400
Parâmetro | Tipo | Descrição |
|---|---|---|
error_code | String | Código de erro. |
error_msg | String | Mensagem de erro. |
Código de status: 500
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.
