attach_role_policy - Boto3 1.34.74 documentation

Publish date: 2024-05-09

Attaches the specified managed policy to the specified IAM role. When you attach a managed policy to a role, the managed policy becomes part of the role’s permission (access) policy.

Note

You cannot use a managed policy as the role’s trust policy. The role’s trust policy is created at the same time as the role, using CreateRole. You can update a role’s trust policy using UpdateAssumerolePolicy.

Use this operation to attach a managed policy to a role. To embed an inline policy in a role, use PutRolePolicy. For more information about policies, see Managed policies and inline policies in the IAM User Guide.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

See also: AWS API Documentation

Request Syntax

response = client.attach_role_policy( RoleName='string', PolicyArn='string' ) 
Parameters:Returns:

None

Exceptions

Examples

The following command attaches the AWS managed policy named ReadOnlyAccess to the IAM role named ReadOnlyRole.

response = client.attach_role_policy( PolicyArn='arn:aws:iam::aws:policy/ReadOnlyAccess', RoleName='ReadOnlyRole', ) print(response) 

Expected Output:

{ 'ResponseMetadata': { '...': '...', }, } 

ncG1vNJzZmian6m8dHrAppizp56WxLR6wqikaK5hZLGwr9SmnKeskam2sLqOmqeiZ5yWwaa%2F02ipnp6Vp7Kvr8Roqp6qpp6wpr%2BOopimZ5Ohtqa602iYrayRmLWgvs6lnJion6G2pMWNoaumpA%3D%3D