接口描述

为指定角色附加授权

请求参数

Action
  • 类型:String
  • 必须:是
  • 描述:系统规定参数,取值:AttachPolicyToRole
PolicyType
  • 类型:String
  • 必须:是
  • 描述:指定Policy的类型, 取值System或Custom
PolicyName
  • 类型:String
  • 必须:是
  • 描述:指定授权策略名称
RoleName
  • 类型:String
  • 必须:是
  • 描述:指定角色名。例:dev

返回参数

只有公共返回参数,详见公共参数

需要的权限

Action
ram:AttachPolicyToRole
Resource
acs:ram:*:${AccountId}:role/${RoleName}

acs:ram:*:${AccountId} or system:policy/${PolicyName}

错误信息

InvalidParameter.RoleName.InvalidChars
  • HTTP Status:400
  • Error Message:The parameter - "RoleName" contains invalid chars.
InvalidParameter.RoleName.Length
  • HTTP Status:400
  • Error Message:The parameter - "RoleName" beyond the length limit.
InvalidParameter.PolicyType
  • HTTP Status:400
  • Error Message:The parameter - "PolicyType" is incorrect.
InvalidParameter.PolicyName.InvalidChars
  • HTTP Status:400
  • Error Message:The parameter - "PolicyNam" contains invalid chars.
InvalidParameter.PolicyName.Length
  • HTTP Status:400
  • Error Message:The parameter - "PolicyName" beyond the length limit.
EntityNotExist.Role
  • HTTP Status:404
  • Error Message:The role does not exist.
EntityNotExist.Policy
  • HTTP Status:404
  • Error Message:The policy does not exist.
EntityAlreadyExists.Role.Policy
  • HTTP Status:409
  • Error Message:The role has already been attached this policy.
LimitExceeded.Role.Policy
  • HTTP Status:409
  • Error Message:The policy count of the role beyond the current limits.

操作示例

请求示例

https://ram.aliyuncs.com/?Action=AttachPolicyToRole
&PolicyType=Custom
&PolicyName=OSS-Administrator
&RoleName=OSSAdminRole
&<公共请求参数>

返回示例

  • XML格式
    <AttachPolicyToRoleResponse>
        <RequestId>697852FB-50D7-44D9-9774-530C31EAC572</RequestId>
    </AttachPolicyToRoleResponse>
  • JSON格式
    {
        "RequestId": "697852FB-50D7-44D9-9774-530C31EAC572"
    }