Enabling and disabling policy
types
AWS Organizations is introducing a new version of the Organizations
management console. You can switch between the old console and the new console by
choosing the
link in the notice boxes at the top of the console. We encourage you to try the new
version and
let us know what you think. We want your feedback and read each submission.
Enabling a policy type
Before you can create and attach a policy to your organization, you must enable that
policy type for use. Enabling a policy type is a one-time task on the organization
root.
You can enable a policy type from only the organization's management account.
To enable a policy type, you need permission to run the following actions:
-
organizations:EnablePolicyType
-
organizations:DescribeOrganization
– required only when using the Organizations console
-
organizations:ListRoots
– required only when using the Organizations console
- Old console
-
To enable a policy type
-
Sign in to the AWS Organizations console. You must sign in as an IAM
user, assume an IAM role, or sign in as the root user (not
recommended) in the organization’s management account.
-
On the Policies tab, choose the name of policy type that you
want to enable.
-
On the policy type page, choose Enable
policy type
.
The page is replaced by a list of the available policies of the
specified type.
You can alternatively use the following steps.
To enable a policy type (alternate method)
-
Sign in to the AWS Organizations console. You must sign in as an IAM
user, assume an IAM role, or sign in as the root user (not
recommended) in the organization’s management account.
-
On the Organize accounts tab, in the navigation pane, choose
the Root OU.
-
On the Root page, in the details pane on the
right, under ENABLE/DISABLE POLICY TYPES, next
to the relevant policy type, choose
Enable.
A light blue box appears around the policy type's name to indicate
that shows it is enabled.
- New console
-
To enable a policy type
-
Sign in to the AWS Organizations console. You must sign in as an IAM
user, assume an IAM role, or sign in as the root user (not
recommended) in the organization’s management account.
-
On the Policies page, choose the name of the policy type that
you want to enable.
-
On the policy type page, choose Enable
policy type
.
The page is replaced by a list of the available policies of the
specified type.
- AWS CLI & AWS SDKs
-
To enable a policy type
You can use one of the following commands to enable a policy
type:
-
AWS CLI: aws
organizations enable-policy-type
The following example shows how to enable backup policies for your
organization. Note that you must specify the ID of your
organization's root.
$
aws organizations enable-policy-type \
--root-id r-a1b2 \
--policy-type BACKUP_POLICY
{
"Root": {
"Id": "r-a1b2",
"Arn": "arn:aws:organizations::123456789012:root/o-aa111bb222/r-a1b2",
"Name": "Root",
"PolicyTypes": [
{
"Type": "BACKUP_POLICY",
"Status": "ENABLED"
}
]
}
}
The list of PolicyTypes
in the output now includes
the specified policy type with the Status
of
ENABLED
.
-
AWS SDKs: EnablePolicyType
Disabling a policy type
If you no longer want to use a certain policy type in your organization, you can
disable that type to prevent its accidental use. You can disable a policy type from
only
the organization's management account.
-
When you disable a policy type, all policies of the specified type are
automatically detached from all entities in the organization root. The
policies are not deleted.
-
(Service control policy type only) If you re-enable the SCP policy type
later, all entities in the organization root are initially attached to only
the default FullAWSAccess
SCP. Attachments of SCPs to entities
are lost when the SCPs are disabled in the organization. If you later want
to re-enable SCPs, you must reattach them to the organization's root, OUs,
and accounts, as appropriate.
To disable SCPs, you need permission to run the following actions:
-
organizations:DisablePolicyType
-
organizations:DescribeOrganization
– required only when using the Organizations console
-
organizations:ListRoots
– required only when using the Organizations console
- Old console
-
To disable a policy type
-
Sign in to the AWS Organizations console. You must sign in as an IAM
user, assume an IAM role, or sign in as the root user (not
recommended) in the organization’s management account.
-
On the Organize accounts tab, choose Root in the left navigation pane.
-
In the details pane on the right side, under ENABLE/DISABLE POLICY TYPES, and next to the policy
type you want to disable, choose Disable.
- New console
-
To disable a policy type
-
Sign in to the AWS Organizations console. You must sign in as an IAM
user, assume an IAM role, or sign in as the root user (not
recommended) in the organization’s management account.
-
On the Policies page, choose the name of the policy type that
you want to disable.
-
On the policy type page, choose Disable
policy type
.
-
On the confirmation dialog box, enter the word
disable
, and then choose
Disable.
The list of available policies of the specified type
disappears.
- AWS CLI & AWS SDKs
-
To disable a policy type
You can use one of the following commands to disable a policy
type:
-
AWS CLI: aws
organizations disable-policy-type
The following example shows how to disable backup policies for
your organization. Note that you must specify the ID of your
organization's root.
$
aws organizations disable-policy-type \
--root-id r-a1b2 \
--policy-type BACKUP_POLICY
{
"Root": {
"Id": "r-a1b2",
"Arn": "arn:aws:organizations::123456789012:root/o-aa111bb222/r-a1b2",
"Name": "Root",
"PolicyTypes": []
}
}
The list of PolicyTypes
in the output no longer
includes the specified policy type.
-
AWS SDKs: DisablePolicyType