Todos os produtos
Search
Central de documentação

:Conceder permissões a uma conta

Última atualização: Jun 26, 2026

Chame a operação GrantAccountPrivilege para conceder permissões de acesso a um banco de dados em uma instância do ApsaraDB RDS.

É possível conceder permissões em um ou mais bancos de dados para cada conta. Antes de chamar esta operação, verifique se a instância está no estado de execução.

Nota

Esta operação não é compatível com instâncias que executam SQL Server 2017 (cluster edition) ou PostgreSQL com SSDs locais.

Depuração

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

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimGrantAccountPrivilege

A operação a ser executada. Defina o valor como GrantAccountPrivilege.

DBInstanceIdStringSimrm-uf6wjk5xxxxxxxxxx

O ID da instância.

AccountNameStringSimtest1

O nome de usuário da conta.

DBNameStringSimtestDB1

O nome do banco de dados ao qual você deseja conceder permissões. Separe vários nomes de bancos de dados com vírgulas (,).

AccountPrivilegeStringSimReadWrite

As permissões que você deseja conceder à conta. A quantidade de permissões deve corresponder ao número de bancos de dados especificados no parâmetro DBName. Especifique este parâmetro conforme suas necessidades de negócios. Valores válidos:

  • ReadWrite: permissões de leitura e gravação
  • ReadOnly: permissões somente de leitura
  • DDLOnly: permissões apenas para DDL
  • DMLOnly: permissões apenas para DML
  • DBOwner: permissões de proprietário do banco de dados
Nota
  • Para instâncias MySQL ou MariaDB, defina este parâmetro como ReadWrite, ReadOnly, DDLOnly ou DMLOnly.
  • Em instâncias SQL Server, utilize ReadWrite, ReadOnly ou DBOwner.
  • Caso a instância execute PostgreSQL com SSDs padrão ou SSDs aprimorados (ESSDs), a única opção disponível é DBOwner.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

81BC9559-7B22-4B7F-B705-5F56DEECDEA7

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=GrantAccountPrivilege
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&AccountName=test1
&DBName=testDB1
&AccountPrivilege=ReadWrite
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<GrantAccountPrivilegeResponse>
    <RequestId>81BC9559-7B22-4B7F-B705-5F56DEECDEA7</RequestId>
</GrantAccountPrivilegeResponse>

Formato JSON

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

{
  "RequestId" : "81BC9559-7B22-4B7F-B705-5F56DEECDEA7"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

Account.UpdateError

Update Account failed, please check your input value

Erro retornado quando a atualização da conta falha. Verifique as configurações dos parâmetros da solicitação ou a política de parâmetros da instância.

400

Database.ConnectError

Database connect error. please check instance status and database processlist

Indica uma conexão anormal com o banco de dados. Verifique o status da instância e o pool de conexões do banco de dados.

400

DbRestoring

Database is in restoring state.

Ocorre quando o banco de dados está em estado de restauração.

400

InvalidAccountPrivilege.Malformed

Specified account privilege is not valid.

Retornado caso sua conta Alibaba Cloud não possua as permissões necessárias.

400

IncorrectAccountStatus

Current account status does not support this operation.

Sinaliza que o status atual da conta não permite esta operação.

400

IncorrectAccount

Current DB instance account does not support this operation.

A conta atual da instância não oferece suporte a esta operação.

403

IncorrectDBInstanceType

Current DB instance type does not support this operation.

Este tipo de instância não é compatível com a operação solicitada.

403

IncorrectDBInstanceState

Current DB instance state does not support this operation.

A operação não é permitida no estado atual da instância.

403

IncorrectAccountType

Current account type does not support this operation.

O tipo de conta atual não suporta esta ação. Verifique o tipo da conta.

403

IncorrectAccountPrivilegeType

the current account privilege type does not support this operation.

O tipo de permissão da conta atual é incompatível com esta operação.

403

OperationDenied.AccountMode

The operation is not permitted due to account mode of instance.

O modo de conta da instância atual impede a execução desta operação.

403

IncorrectDBInstanceCharacterType

Current DB Instance character_type does not support this operation.

O tipo de caractere (character_type) da instância atual não suporta esta operação.

404

IncorrectDBInstanceLockMode

Current DB instance lock mode does not support this operation.

Retornado quando a instância está bloqueada.

404

InvalidAccountName.NotFound

Specified account name does not exist.

Não foi possível encontrar o nome de usuário da conta especificado. Verifique o nome de usuário.

Para obter uma lista completa de códigos de erro, consulte os Códigos de erro do serviço.