Todos os produtos
Search
Central de documentação

:Criar uma conta de banco de dados

Última atualização: Jun 26, 2026

Chame a operação CreateAccount para crie uma conta usada no gerenciamento de bancos de dados em uma instância do ApsaraDB RDS.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

  • A instância está no estado Running.

  • O banco de dados está no estado running.

  • O número de contas criadas na instância não excede o limite máximo de contas por instância. Para mais informações sobre esse limite, consulte Limits.

Nota
  • Esta operação é compatível com instâncias que executam MySQL, MariaDB, PostgreSQL e SQL Server. No entanto, não há suporte para instâncias que executam SQL Server 2017 ou SQL Server 2019 no RDS Cluster Edition.

  • É possível crie múltiplas contas privilegiadas e múltiplas contas padrão em cada instância do ApsaraDB RDS que executa PostgreSQL.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior praticidade, recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de requisição

ParameterTypeRequiredExampleDescription
ActionStringYesCreateAccount

A operação a ser execute. Defina o valor como CreateAccount.

DBInstanceIdStringYesrm-uf6wjk5xxxxxxx

O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.

AccountNameStringYestest1

O nome de usuário da conta.

Nota
  • O nome de usuário deve ser exclusivo.
  • O nome de usuário deve começar com uma letra minúscula e terminar com uma letra minúscula ou dígito.
  • O nome de usuário pode conter letras minúsculas, dígitos e underscores (_).
  • O comprimento do nome de usuário deve atender aos seguintes requisitos:
    • Em instâncias que executam MySQL 5.7 ou MySQL 8.0, o nome de usuário deve ter entre 2 e 32 caracteres.
    • Em instâncias que executam MySQL 5.6, o nome de usuário deve ter entre 2 e 16 caracteres.
    • Em instâncias que executam SQL Server, o nome de usuário deve ter entre 2 e 64 caracteres.
    • Em instâncias que executam PostgreSQL com SSDs padrão ou ESSDs, o nome de usuário deve ter entre 2 e 63 caracteres.
    • Em instâncias que executam PostgreSQL com SSDs locais, o nome de usuário deve ter entre 2 e 16 caracteres.
    • Em instâncias que executam MariaDB, o nome de usuário deve ter entre 2 e 16 caracteres.
  • Para mais informações sobre caracteres inválidos, consulte Forbidden keywords table.
AccountPasswordStringYesTest123456

A senha da conta.

Nota
  • A senha da conta deve ter entre 8 e 32 caracteres.
  • A senha da conta deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais.
  • A senha pode conter qualquer um dos seguintes caracteres:

    ! @ # $ % ^ & * ( ) _ + - =

AccountDescriptionStringNoTest account A

A descrição da conta. A descrição 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://.
AccountTypeStringNoNormal

O tipo da conta. Valores válidos:

  • Normal: conta padrão
  • Super: conta privilegiada

Valor padrão: Normal.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId

String

D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD

O ID da requisição.

Exemplos

Exemplos de requisição

http(s)://rds.aliyuncs.com/?Action=CreateAccount
&DBInstanceId=rm-uf6wjk5xxxxxxx
&AccountName=test1
&AccountPassword=Test123456
&<Common request parameters>

Exemplos de resposta bem-sucedida

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateAccountResponse>
       <RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</RequestId>
</CreateAccountResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

GeneralIns.Creating

The general instance is creating.

O erro indica que uma instância está sendo criada. Tente novamente mais tarde.

400

GeneralIns.Maintaining

The general instance is maintaining.

O erro indica que uma instância está sendo migrada ou mantida. Tente novamente mais tarde.

400

GeneralIns.Switching

The general instance is Switching.

O erro indica que uma alternância primária/secundária está sendo execute para garantir alta disponibilidade. Tente novamente mais tarde.

400

InvalidEngineVersion.NotSupported

Current db instance does not support sysadmin.

O erro indica que a instância atual não oferece suporte à criação de uma conta sysAdmin.

400

Database.ConnectError

Database connect error. please check instance status and database processlist

O erro indica que 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.

400

Account.AddError

Create Account failed, please check your input value or may your input value not satisfy instance current policy

O erro indica que a criação da conta falhou. Verifique se os parâmetros da requisição atendem aos requisitos de configuração.

Para obter uma lista de códigos de erro, acesse o API Error Center.