Criação de um banco de dados
Função
Essa API é usada para criar um banco de dados para uma instância do GaussDB(for MySQL). 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 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
|
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:
|
|
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 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). |
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.
