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.