Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Create roles automatically with role manager

Many Amazon services depend on IAM roles to perform actions on your behalf. IAM role manager is an optional account setting that automatically provisions such roles, so you don't have to set them up yourself. Role manager is designed to help you get started building with Amazon services without additional manual IAM configuration.

Role manager is available in select Amazon service consoles, listed in Amazon service consoles that support role manager on this page.

How role manager works

When role manager is enabled, it provides roles appropriate to the service and the resource as part of the relevant console workflow. Supported service consoles will indicate when role manager is available. No additional action is required to accept the role that role manager provides. For example, when you create an Amazon Lambda function in the console, Lambda uses role manager to create the function's execution role by default. To use a different role, choose an existing role or manually create a new one.

Role manager works by applying a role template, a definition of a role's trust policy and permissions for a service and use case. To learn more about the template that each service uses, see Overview of role templates. A template for a defined task grants only the actions that task needs. A template for open-ended work, such as running your own code, grants broad access to Amazon APIs so you can build without granting access to each service yourself.

IAM roles created by role manager behave like any other role you create. You can view, edit, or delete them. Each role also records the role template it came from, so you can identify the roles that role manager created. Amazon CloudTrail logs when role manager creates roles so you can audit when and how each role was created. Role manager role creation appears in CloudTrail as the AcquireRole event.

Prerequisites

Enabling role manager requires the iam:PutAccountProperties and iam:CreateServiceLinkedRole permissions. Disabling role manager requires the iam:PutAccountProperties permission. Viewing the current setting requires the iam:GetAccountProperties permission. The Amazon managed policy IAMFullAccess includes all of these permissions. For all the permissions that role manager requires, see Manage access to role manager.

How to enable and disable role manager

You can enable or disable role manager using the Amazon Web Services Management Console, Amazon CLI, or Amazon API. Role manager is controlled by the account-level property RoleManager/Enabled, which you set using the PutAccountProperties API. A value of true enables role manager; false disables it.

To enable or disable role manager (console)

Role manager may be enabled or disabled on the Account settings page in the IAM console. That page also shows whether role manager is enabled for the account.

Roles created by role manager are not deleted when you disable role manager.

To enable or disable role manager (Amazon CLI)

Set the RoleManager/Enabled property to true to enable role manager, or false to disable it.

To enable or disable role manager (Amazon API)

For more information, see PutAccountProperties and GetAccountProperties in the IAM API Reference.

Amazon service consoles that support role manager

Role manager supports role creation for the following Amazon service consoles:

Amazon will continue adding service support over time. To learn more about the role template that each service uses, see Overview of role templates.

Related information