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 banco de dados/ Criação de um banco de dados

Criação de um banco de dados

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

Ver PDF

Função

Essa API é usada para criar um 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}/databases

**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
databases	Sim	Array of CreateGaussMySqlDatabase objects	Lista de informações do banco de dados. A lista contém até 50 bancos de dados.

**Tabela 4** CreateGaussMySqlDatabase
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Nome do banco de dados. O nome pode conter de 1 a 64 caracteres. Somente letras, dígitos, hifens (-) e sublinhados (_) são permitidos. O número total de hifens (-) não pode exceder 10.
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 (!<"='>&).
character_set	Sim	String	Conjunto de caracteres do banco de dados, por exemplo, utf8mb4 ou gbk.
users	Não	Array of GaussMySqlDatabaseUser objects	Lista de usuários do banco de dados. A lista contém até 50 usuários de banco de dados. Ao criar um banco de dados, você pode autorizar as permissões do banco de dados para os usuários da lista. Se não houver nenhum usuário de banco de dados na lista, você não poderá autorizar as permissões de banco de dados para usuários de banco de dados ao criar um banco de dados. Se você precisar autorizar as permissões do banco de dados a um usuário do banco de dados posteriormente, chame a API (Concessão de permissões a um usuário de banco de dados).

**Tabela 5** GaussMySqlDatabaseUser
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Nome de usuário do banco de dados.
host	Sim	String	Endereço IP do host.
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 um 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 banco de dados (com utf8mb4 como conjunto de caracteres e permissão de leitura/gravação)

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/a23fb62bd61e4e9e9636fd2225f395bein07/databases
{
  "databases" : [ {
    "name" : "test",
    "comment" : "database_comment",
    "character_set" : "utf8mb4",
    "users" : [ {
      "name" : "gaussdb_mysql_user1",
      "host" : "127.0.0.1",
      "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 banco de dados

Tópico anterior: Consulta de conjuntos de caracteres de banco de dados disponíveis

Próximo tópico: Modificação de observações 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