Criação de um banco de dados
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
|
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 |
|---|---|---|---|
|
databases |
Sim |
Array of CreateGaussMySqlDatabase objects |
Lista de informações do banco de dados. A lista contém até 50 bancos de dados. |
|
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 os seguintes 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 conceder permissões de 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á conceder as permissões de banco de dados para usuários de banco de dados ao criar um banco de dados. Se você precisar conceder 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). |
Parâmetros de resposta
Código de status: 201
|
Parâmetro |
Tipo |
Descrição |
|---|---|---|
|
job_id |
String |
ID da tarefa para criar um 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 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.
