Todos os produtos
Search
Central de documentação

Resource Management:AttachPolicy

Última atualização: Oct 27, 2026

Invoca AttachPolicy para anexar uma política de acesso a um objeto de autorização, como um usuário do Resource Access Management (RAM), grupo de usuários do RAM ou função do RAM, para conceder permissões. Após a conclusão da autorização, o objeto autorizado obtém permissões de acesso a recursos no grupo de recursos ou na conta da Alibaba Cloud especificada.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ResourceGroupId

string

Sim

O escopo de autorização. Valores válidos:

  • ID do grupo de recursos: A política entra em vigor apenas no grupo de recursos especificado.

  • ID da conta da Alibaba Cloud: O ID da conta da Alibaba Cloud à qual o principal pertence. A política entra em vigor na conta da Alibaba Cloud.

rg-9gLOoK****

PolicyType

string

Sim

O tipo de política de acesso. Valores válidos:

  • Custom: política de acesso personalizada.

  • System: política de acesso do sistema.

System

PolicyName

string

Sim

O nome da política.

O nome deve ter entre 1 e 128 caracteres e pode conter letras, dígitos e hifens (-).

AdministratorAccess

PrincipalType

string

Sim

O tipo de objeto de autorização. Valores válidos:

  • IMSUser: usuário do Resource Access Management (RAM).

  • IMSGroup: grupo de usuários do RAM.

  • ServiceRole: função do RAM.

IMSUser

PrincipalName

string

Sim

O nome do principal. O formato varia de acordo com o tipo de principal:

  • Usuário do RAM: @.onaliyun.com. indica o usuário do Resource Access Management (RAM) e indica o alias da conta.

  • Grupo de usuários do RAM: @group..onaliyun.com. indica o grupo de usuários do Resource Access Management (RAM) e indica o alias da conta.

  • Função do RAM: @role..onaliyunservice.com. indica o nome da função do RAM e indica o alias da conta.

Nota

O alias da conta é uma parte do nome de domínio padrão. Você pode chamar a operação GetDefaultDomain para obter o alias da conta.

alice@demo.onaliyun.com

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

697852FB-50D7-44D9-9774-530C31EAC572

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.PolicyType The specified policy type is invalid. O tipo de política de acesso é inválido.
404 EntityNotExist.Policy The policy does not exist. A política de acesso não existe.
404 EntityNotExists.ResourceGroup The specified resource group does not exist. You must first create a resource group. O grupo de recursos não existe. Crie um grupo de recursos primeiro.
409 Invalid.ResourceGroup.Status You cannot perform an operation on a resource group that is being created or deleted. As operações não são permitidas enquanto o grupo de recursos está sendo criado ou excluído.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.