CreateAccount - PolarDB: Central de Documentação do Alibaba Cloud

Cria uma conta de banco de dados PolarDB.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

polardb:CreateAccount

create

*dbcluster.

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
DBClusterId	string	Sim	O ID do cluster.	pc-**************
AccountName	string	Sim	O nome da conta. O nome deve atender aos seguintes requisitos: Começa com uma letra minúscula e termina com uma letra ou dígito. Contém apenas letras minúsculas, dígitos ou underscores (_). Tem de 2 a 16 caracteres de comprimento. Não pode usar certos nomes de usuário reservados, como root ou admin.	testacc
AccountPassword	string	Sim	A senha da conta. A senha deve atender aos seguintes requisitos: Contém pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Tem de 8 a 32 caracteres de comprimento. Os caracteres especiais incluem `!@#$%^&*()_+-=`.	Test1111
AccountType	string	Não	O tipo de conta. Valores válidos: Normal: conta padrão. Super: conta privilegiada. DynamoDB: conta DynamoDB. Nota Se este parâmetro for deixado vazio, uma conta Super será criada por padrão. Se o cluster for um PolarDB para PostgreSQL (Compatível com Oracle) ou PolarDB para PostgreSQL, você pode criar várias contas privilegiadas para cada cluster. Contas privilegiadas têm mais permissões do que contas padrão. Para mais informações, consulte Criar uma conta de banco de dados. Se o cluster for um PolarDB para MySQL, você pode criar no máximo uma conta privilegiada para cada cluster. Contas privilegiadas têm mais permissões do que contas padrão. Para mais informações, consulte Criar uma conta de banco de dados. Contas DynamoDB são contas dedicadas criadas para o recurso de compatibilidade DynamoDB do PolarDB para PostgreSQL. Para mais informações, consulte Instruções de uso do DynamoDB.	Normal
AccountDescription	string	Não	A descrição da conta. A descrição deve atender aos seguintes requisitos: Não pode começar com `http://` ou `https://`. Tem de 2 a 256 caracteres de comprimento.	testdes
DBName	string	Não	O nome do banco de dados que a conta está autorizada a acessar. Você pode especificar vários nomes de banco de dados separados por vírgulas (,). Nota Este parâmetro é suportado apenas para contas padrão de clusters PolarDB para MySQL.	testdb
AccountPrivilege	string	Não	As permissões da conta. Valores válidos: ReadWrite: leitura e gravação ReadOnly: somente leitura DMLOnly: somente DML DDLOnly: somente DDL ReadIndex: somente leitura e índice Nota O parâmetro DBName deve ser especificado para que AccountPrivilege tenha efeito. Se você especificar vários nomes de banco de dados para o parâmetro DBName, deverá conceder as permissões correspondentes a cada banco de dados. Separe várias permissões com vírgulas (,) e certifique-se de que o comprimento total da string AccountPrivilege não exceda 900 caracteres. Por exemplo, para conceder permissões de leitura e gravação no banco de dados DB1 e permissões somente leitura no banco de dados DB2, defina DBName como `DB1,DB2` e defina AccountPrivilege como `ReadWrite,ReadOnly`. Este parâmetro é suportado apenas para contas padrão de clusters PolarDB para MySQL.	ReadWrite
ClientToken	string	Não	O token do cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o valor. Certifique-se de que o valor seja único entre diferentes solicitações. O token diferencia maiúsculas de minúsculas e não pode exceder 64 caracteres ASCII de comprimento.	6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
PrivForAllDB	string	Não	Especifica se deve conceder permissões em todos os bancos de dados existentes e todos os novos bancos de dados no cluster atual. Valores válidos: 0 ou vazio: não concede permissões. 1: concede permissões. Nota O parâmetro AccountPrivilege deve ser especificado para que este parâmetro tenha efeito. Se este parâmetro for definido como `1`, as permissões especificadas por AccountPrivilege serão concedidas em todos os bancos de dados.	0
NodeType	string	Não	O tipo de nó. Valores válidos: Search: obrigatório ao criar uma conta para um nó PolarDB Search	Search

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	CED079B7-A408-41A1-BFF1-EC608E******

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "CED079B7-A408-41A1-BFF1-EC608E******"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	LockTimeout	The request processing has failed due to lock timeout.	A solicitação falhou ao ser processada devido a um timeout de bloqueio.
400	EngineMigration.ActionDisabled	Specified action is disabled while custins is in engine migration.	A operação especificada está desativada enquanto a instância está passando por migração de engine.
400	InvalidAccountPassword.Malformed	The specified parameter AccountPassword is not valid.	O parâmetro AccountPassword especificado é inválido.
400	InvalidAccountType.Malformed	The specified parameter AccountType is not valid.	O parâmetro AccountType especificado é inválido.
400	InvalidAccountDescription.Malformed	The specified parameter AccountDescription is not valid.	O parâmetro AccountDescription especificado é inválido.
400	InvalidAccountPrivilege.Malformed	The specified parameter AccountPrivilege is not valid.	O parâmetro AccountPrivilege especificado é inválido.
400	InvalidAccountName.Malformed	The specified parameter AccountName is not valid.	O parâmetro AccountName especificado é inválido.
404	InvalidDBClusterId.NotFound	The DBClusterId provided does not exist in our records.	O DBClusterId especificado não existe nos registros atuais.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	O DBClusterId especificado não existe em nossos registros.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.