Chame a operação CreateDatabase para criar um banco de dados em uma instância.
Para executar tarefas de gerenciamento de dados, como alteração de dados e design de schema, utilize o Data Management (DMS). Para mais informações, consulte Lista de operações por função do DMS.
Antes de chamar esta operação, verifique se os seguintes requisitos são atendidos:
A instância está no estado Running.
O número máximo de bancos de dados para a instância não foi atingido. Chame a operação DescribeDBInstanceAttribute para consultar o número máximo de bancos de dados.
-
A instância não é uma instância somente leitura.
NotaEsta operação não é compatível com instâncias que executam SQL Server 2017 EE (edição cluster) nem com instâncias que executam PostgreSQL com SSDs locais. Nesses casos, execute a instrução CREATE DATABASE para criar um banco de dados.
Depuração
Parâmetros de requisição
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | CreateDatabase | A operação a ser executada. Defina o valor como CreateDatabase. |
| DBInstanceId | String | Yes | rm-uf6wjk5xxxxxxxxxx | O ID da instância. |
| DBName | String | Yes | rds_mysql | O nome do banco de dados. Nota
|
| CharacterSetName | String | Yes | gbk | O conjunto de caracteres.
|
| DBDescription | String | No | Test database | A descrição do banco de dados. Deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, underscores (_) e hífens (-). A descrição deve começar com uma letra. Nota A descrição não pode começar com http:// ou https://. |
| ResourceGroupId | String | No | rg-acfmy***** | O ID do grupo de recursos. |
Parâmetros de resposta
|
Parameter |
Type |
Example |
Description |
|
RequestId |
String |
5A77D650-27A1-4E08-AD9E-59008EDB6927 |
O ID da requisição. |
Exemplos
Exemplos de requisição
http(s)://rds.aliyuncs.com/?Action=CreateDatabase
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&DBName=rds_mysql
&CharacterSetName=gbk
&<Common request parameters>
Exemplos de resposta com sucesso
XML formato
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateDatabaseResponse>
<RequestId>5A77D650-27A1-4E08-AD9E-59008EDB6927</RequestId>
</CreateDatabaseResponse>
JSON formato
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestID" : "5A77D650-27A1-4E08-AD9E-59008EDB6927"
}
Códigos de erro
|
HTTP status code |
Error code |
Error message |
Description |
|
400 |
EngineMigration.ActionDisabled |
Specified action is disabled while custins is in engine migration. |
O erro é retornado porque a operação especificada está desabilitada durante a migração de engine da instância. |
|
400 |
Database.AddError |
Create Db failed, please check input value and instance status |
O erro é retornado porque a criação do banco de dados falhou. Verifique os parâmetros de entrada e o status da instância. |
|
400 |
Database.ConnectError |
Database connect error. please check instance status and database processlist |
O erro é retornado porque a conexão com o banco de dados está anormal. Verifique o status da instância e o pool de conexões do banco de dados. |
Para uma lista de códigos de erro, acesse o API Error Center.