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/ Document Database Service/ Referência de API/ APIs V3.0 (recomendada)/ Gerenciamento de bancos de dados e usuários/ Criação de um usuário do banco de dados

Atualizado em 2023-05-06 GMT+08:00

Ver PDF

Criação de um usuário do banco de dados

Descrição

Essa API é usada para criar um usuário de banco de dados para uma instância especificada.

Restrições

Esta API aplica-se apenas ao DDS Community Edition.
Esta operação não é permitida se a instância de banco de dados estiver em qualquer um dos seguintes status: criação, alteração da classe da instância, alteração da porta, congelada, reiniciando ou anormal.

Depuração

Você pode depurar essa API no API Explorer.

URI

Formato de URI
POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/db-user
Exemplo de URI
https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/f032c0db12d147ef87317efdfacbbe15in02/db-user

**Tabela 1** Parâmetros de solicitação
Nome	Tipo	IN	Obrigatório	Descrição
x-auth-token	string	header	Sim	Token do usuário
project_id	string	path	Sim	ID do projeto de um locatário em uma região. Para obter o ID do projeto, consulte Obtenção de um ID de projeto.
instance_id	string	path	Sim	ID da instância, que pode ser obtido chamando a API descrita em Consulta de instâncias e detalhes. Se você não tiver uma instância, chame a API descrita em Criação de uma instância de banco de dados para criar uma.

Solicitações

Descrição do parâmetro

**Tabela 2** Descrição do parâmetro
Nome	Tipo	Obrigatório	Descrição
user_name	String	Sim	O nome de usuário do banco de dados. O valor deve ser de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9), hífens (-) e pontos (.). O nome de usuário não pode ser um nome de usuário reservado interno, como drsFull ou drsIncremental.
user_pwd	String	Sim	A senha do usuário do banco de dados. O valor deve ter de 8 a 32 caracteres e conter letras maiúsculas (A a Z), minúsculas (a a z), dígitos (0 a 9) e caracteres especiais, como ~!@#%^*-_=+? Digite uma senha forte para melhorar a segurança, evitando riscos de segurança, como cracking de força bruta.
roles	Array of Object	Sim	A função do usuário do banco de dados. Para mais detalhes, consulte Tabela 3.
db_name	String	Não	O banco de dados onde o novo usuário está localizado. O valor padrão é "admin". O valor deve ter de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9) e sublinhados (_).

**Tabela 3** Descrição da estrutura de dados do campo roles
Nome	Tipo	Obrigatório	Descrição
role_db_name	String	Sim	O nome do banco de dados ao qual pertence a atribuição concedida ao novo usuário. O valor deve ter de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9) e sublinhados (_).
role_name	String	Sim	O nome da função concedida ao novo usuário. O valor deve conter de 1 a 64 caracteres e pode conter apenas letras (de A a Z ou de a a z), dígitos (de 0 a 9), hífens (-) e pontos (.).

Exemplo de solicitação

{ 
    "user_name":"test" ,
    "user_pwd":"******",
    "roles":[{
        "role_db_name":"testDb" ,
        "role_name":"testRole"
     }],
    "db_name":"test_db"
}

Respostas

Exemplo de resposta
```
{}
```

SDK

Clique em SDK do Document Database Service DDS para fazer download do SDK ou exibir o documento do SDK. Para saber como instalar e autenticar um SDK, leia a seção Uso.