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)/ HTAP (edição padrão)/ Criação de uma conta de banco de dados
Atualizado em 2025-05-23 GMT+08:00
Ver PDF
Compartilhar

Criação de uma conta de banco de dados

Função

Essa API é usada para criar uma conta de banco de dados. Antes de chamar essa API:

URI

POST /v3/{project_id}/instances/{instance_id}/starrocks/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 numa região.

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

instance_id

Sim

String

ID da instância do StarRocks, que é compatível com o formato UUID.

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.

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:

  • en-us
  • zh-cn
Tabela 3 Parâmetros do corpo da solicitação

Parâmetro

Obrigatório

Tipo

Descrição

user_name

Sim

String

Nome de usuário da conta do banco de dados. O nome de usuário pode ter de 2 a 32 caracteres. Deve começar com uma letra minúscula e terminar com uma letra minúscula ou dígito. Apenas letras minúsculas, dígitos e sublinhados (_) são permitidos.

password

Sim

String

Senha da conta. A senha deve:

  • Consistir de 8 a 32 caracteres.
  • Ser diferente do nome de usuário ou do nome de usuário escrito ao contrário.
  • Conter pelo menos três tipos dos seguintes caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais ~!@#%^*-_=+?,

databases

Sim

Array of strings

Lista de bancos de dados.

dml

Não

Integer

Permissões DML. O valor padrão é 2. Valores:

  • 0: permissão de leitura/gravação
  • 1: permissão somente leitura
  • 2: permissões somente leitura e de configuração
  • 3: permissões de leitura/gravação e configuração

ddl

Não

Integer

Se as permissões DDL são concedidas. O valor padrão é 0. Valores:

  • 0: não
  • 1: sim

Parâmetros de resposta

Código de status: 200

Tabela 4 Parâmetros do corpo de resposta

Parâmetro

Tipo

Descrição

result

String

Resultado da solicitação.

Código de status: 400

Tabela 5 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 6 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 uma conta de banco de dados

POST https://{endpoint}/v3/23a50154cf494ec9ad6883979a12db0a/instances/54e42160670e48e789af7075e1efea1fin16/starrocks/users

{
  "userName" : "user_test",
  "dml" : 2,
  "ddl" : 0,
  "passWord" : "Rds_1234",
  "dataBases" : [ "INFORMATION_SCHEMA", "default" ]
}

Exemplo de resposta

Código de status: 200

Bem-sucedido.

{
  "result" : "SUCCESS"
}

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: HTAP (edição padrão)