EnableOrganizationsRootCredentialsManagement
Enables the management of privileged root user credentials across member accounts in your organization. When you enable root credentials management for centralized root access, the management account and the delegated administrator for IAM can manage root user credentials for member accounts in your organization.
Before you enable centralized root access, you must have an account configured with the following settings:
-
You must manage your AWS accounts in AWS Organizations.
-
Enable trusted access for AWS Identity and Access Management in AWS Organizations. For details, see IAM and AWS Organizations in the AWS Organizations User Guide.
Response Elements
The following elements are returned by the service.
- EnabledFeatures.member.N
-
The features you have enabled for centralized root access.
Type: Array of strings
Valid Values:
RootCredentialsManagement | RootSessions - OrganizationId
-
The unique identifier (ID) of an organization.
Type: String
Length Constraints: Maximum length of 34.
Pattern:
^o-[a-z0-9]{10,32}$
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccountNotManagementOrDelegatedAdministrator
-
The request was rejected because the account making the request is not the management account or delegated administrator account for centralized root access.
HTTP Status Code: 400
- CallerIsNotManagementAccount
-
The request was rejected because the account making the request is not the management account for the organization.
HTTP Status Code: 400
- OrganizationNotFound
-
The request was rejected because no organization is associated with your account.
HTTP Status Code: 400
- OrganizationNotInAllFeaturesMode
-
The request was rejected because your organization does not have All features enabled. For more information, see Available feature sets in the AWS Organizations User Guide.
HTTP Status Code: 400
- ServiceAccessNotEnabled
-
The request was rejected because trusted access is not enabled for IAM in AWS Organizations. For details, see IAM and AWS Organizations in the AWS Organizations User Guide.
HTTP Status Code: 400
Examples
Example
This example illustrates one usage of EnableOrganizationsRootCredentialsManagement.
Sample Request
https://iam.amazonaws.com/?Action=EnableOrganizationsRootCredentialsManagement
&Version=2010-05-08
&AUTHPARAMSSample Response
<EnableOrganizationsRootCredentialsManagementResponse xmlns="https://iam.amazonaws.com/doc/2024-11-03/">
<ResponseMetadata>
<EnabledFeatures>
<member><RootCredentialsManagement></member>
<member><RootSessions></member>
</EnabledFeatures>
<OrganizationId>o111122223333</OrganizationId>
</ResponseMetadata>
</EnableOrganizationsRootCredentialsManagementResponse>See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
