Resource identifiers for APIs and controls

Each control in AWS Control Tower has a unique identifier for use with the control APIs. A different identifier is given for each Region in which AWS Control Tower operates. The identifier for each control is shown in the API controlIdentifier field, on the Control details page in the AWS Control Tower console, and in the Tables of control metadata.

Note

This identifier is distinct from the ControlID field, which is a classification system for controls.

View the control identifiers for all controls

To view the tables of control metadata, including the controlIdentifier ARN for each control and Region, see Tables of control metadata. The tables also include the identifiers for Security Hub controls that are part of the AWS Security Hub Service-Managed Standard:AWS Control Tower.

View control identifiers in the console

To view the control identifiers and other details about AWS Control Tower controls in the console, navigate to the Control details page in the AWS Control Tower console. You can find the identifier in the API controlIdentifier field.

Example forms of Identifiers

When you look in the AWS Control Tower console, here are examples of identifiers you may see.

• Security Hub example API controlIdentifier: arn:aws:controltower:us-east-1::control/OOTDCUSIKIZZ

• Legacy control example API controlIdentifier: arn:aws:controltower:us-east-1::control/AWS-GR_LOG_GROUP_POLICY

• Proactive control example API controlIdentifier: arn:aws:controltower:us-east-1::control/EHSOKSSMVFWF

Older controls (legacy controls) include the name of the control in the ARN, but newer controls have a different identifier, and that is expected.

Old example: arn:aws:controltower:us-east-1::control/AWS-GR_CLOUDTRAIL_CHANGE_PROHIBITED

New example: arn:aws:controltower:us-east-1::control/WTDSMKDKDNLE

The following list contains the API controlIdentifier designations of the (legacy) Strongly recommended and Elective, preventive and detective, controls that are owned by AWS Control Tower, including the elective Data residency controls. Mandatory controls cannot be deactivated by the control APIs.

Each item in the list that follows serves as a link, which provides more information about these individual (legacy) controls that are owned by AWS Control Tower, as given in The AWS Control Tower controls library.

Designations for legacy Elective controls

• arn:aws:controltower:REGION::control/AWS-GR_AUDIT_BUCKET_ENCRYPTION_ENABLED

• arn:aws:controltower:REGION::control/AWS-GR_AUDIT_BUCKET_LOGGING_ENABLED

• arn:aws:controltower:REGION::control/AWS-GR_AUDIT_BUCKET_POLICY_CHANGES_PROHIBITED

• arn:aws:controltower:REGION::control/AWS-GR_AUDIT_BUCKET_RETENTION_POLICY

• arn:aws:controltower:REGION::control/AWS-GR_IAM_USER_MFA_ENABLED

• arn:aws:controltower:REGION::control/AWS-GR_MFA_ENABLED_FOR_IAM_CONSOLE_ACCESS

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICT_S3_CROSS_REGION_REPLICATION

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICT_S3_DELETE_WITHOUT_MFA

• arn:aws:controltower:REGION::control/AWS-GR_S3_VERSIONING_ENABLED

Designations for legacy Data residency controls (elective)

• arn:aws:controltower:REGION::control/AWS-GR_SUBNET_AUTO_ASSIGN_PUBLIC_IP_DISABLED

• arn:aws:controltower:REGION::control/AWS-GR_AUTOSCALING_LAUNCH_CONFIG_PUBLIC_IP_DISABLED

• arn:aws:controltower:REGION::control/AWS-GR_DISALLOW_CROSS_REGION_NETWORKING

• arn:aws:controltower:REGION::control/AWS-GR_DISALLOW_VPC_INTERNET_ACCESS

• arn:aws:controltower:REGION::control/AWS-GR_DISALLOW_VPN_CONNECTIONS

• arn:aws:controltower:REGION::control/AWS-GR_DMS_REPLICATION_NOT_PUBLIC

• arn:aws:controltower:REGION::control/AWS-GR_EBS_SNAPSHOT_PUBLIC_RESTORABLE_CHECK

• arn:aws:controltower:REGION::control/AWS-GR_EC2_INSTANCE_NO_PUBLIC_IP

• arn:aws:controltower:REGION::control/AWS-GR_EKS_ENDPOINT_NO_PUBLIC_ACCESS

• arn:aws:controltower:REGION::control/AWS-GR_ELASTICSEARCH_IN_VPC_ONLY

• arn:aws:controltower:REGION::control/AWS-GR_EMR_MASTER_NO_PUBLIC_IP

• arn:aws:controltower:REGION::control/AWS-GR_LAMBDA_FUNCTION_PUBLIC_ACCESS_PROHIBITED

• arn:aws:controltower:REGION::control/AWS-GR_NO_UNRESTRICTED_ROUTE_TO_IGW

• arn:aws:controltower:REGION::control/AWS-GR_REDSHIFT_CLUSTER_PUBLIC_ACCESS_CHECK

• arn:aws:controltower:REGION::control/AWS-GR_S3_ACCOUNT_LEVEL_PUBLIC_ACCESS_BLOCKS_PERIODIC

• arn:aws:controltower:REGION::control/AWS-GR_SAGEMAKER_NOTEBOOK_NO_DIRECT_INTERNET_ACCESS

• arn:aws:controltower:REGION::control/AWS-GR_SSM_DOCUMENT_NOT_PUBLIC

Designations for legacy Strongly recommended controls

• arn:aws:controltower:REGION::control/AWS-GR_ENCRYPTED_VOLUMES

• arn:aws:controltower:REGION::control/AWS-GR_EBS_OPTIMIZED_INSTANCE

• arn:aws:controltower:REGION::control/AWS-GR_EC2_VOLUME_INUSE_CHECK

• arn:aws:controltower:REGION::control/AWS-GR_RDS_INSTANCE_PUBLIC_ACCESS_CHECK

• arn:aws:controltower:REGION::control/AWS-GR_RDS_SNAPSHOTS_PUBLIC_PROHIBITED

• arn:aws:controltower:REGION::control/AWS-GR_RDS_STORAGE_ENCRYPTED

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICTED_COMMON_PORTS

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICTED_SSH

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICT_ROOT_USER

• arn:aws:controltower:REGION::control/AWS-GR_RESTRICT_ROOT_USER_ACCESS_KEYS

• arn:aws:controltower:REGION::control/AWS-GR_ROOT_ACCOUNT_MFA_ENABLED

• arn:aws:controltower:REGION::control/AWS-GR_S3_BUCKET_PUBLIC_READ_PROHIBITED

• arn:aws:controltower:REGION::control/AWS-GR_S3_BUCKET_PUBLIC_WRITE_PROHIBITED

• arn:aws:controltower:REGION::control/AWS-GR_DETECT_CLOUDTRAIL_ENABLED_ON_MEMBER_ACCOUNTS

Controls that cannot be changed with the AWS Control Tower APIs

The following controls cannot be activated or deactivated by means of the AWS Control Tower APIs. Except for the Region deny control, all of these are mandatory controls. In general, mandatory controls cannot be deactivated. The Region deny control must be changed in the console.

• AWS-GR_REGION_DENY

• AWS-GR_AUDIT_BUCKET_DELETION_PROHIBITED

• AWS-GR_AUDIT_BUCKET_PUBLIC_READ_PROHIBITED

• AWS-GR_AUDIT_BUCKET_PUBLIC_WRITE_PROHIBITED

• AWS-GR_CLOUDTRAIL_CHANGE_PROHIBITED

• AWS-GR_CLOUDTRAIL_CLOUDWATCH_LOGS_ENABLED

• AWS-GR_CLOUDTRAIL_ENABLED

• AWS-GR_CLOUDTRAIL_VALIDATION_ENABLED

• AWS-GR_CLOUDWATCH_EVENTS_CHANGE_PROHIBITED

• AWS-GR_CONFIG_AGGREGATION_AUTHORIZATION_POLICY

• AWS-GR_CONFIG_AGGREGATION_CHANGE_PROHIBITED

• AWS-GR_CONFIG_CHANGE_PROHIBITED

• AWS-GR_CONFIG_ENABLED

• AWS-GR_CONFIG_RULE_CHANGE_PROHIBITED

• AWS-GR_CT_AUDIT_BUCKET_ENCRYPTION_CHANGES_PROHIBITED

• AWS-GR_CT_AUDIT_BUCKET_LIFECYCLE_CONFIGURATION_CHANGES_PROHIBITED

• AWS-GR_CT_AUDIT_BUCKET_LOGGING_CONFIGURATION_CHANGES_PROHIBITED

• AWS-GR_CT_AUDIT_BUCKET_POLICY_CHANGES_PROHIBITED

• AWS-GR_IAM_ROLE_CHANGE_PROHIBITED

• AWS-GR_LAMBDA_CHANGE_PROHIBITED

• AWS-GR_LOG_GROUP_POLICY

• AWS-GR_SNS_CHANGE_PROHIBITED

• AWS-GR_SNS_SUBSCRIPTION_CHANGE_PROHIBITED

• AWS-GR_ENSURE_CLOUDTRAIL_ENABLED_ON_SHARED_ACCOUNTS

Find identifiers for OUs

For more information about how to find the resource identifier for an OU and its resources, see Resource types defined by AWS Organizations.

To learn more about how to get information from an OU, see the AWS Organizations API Reference.

Note

The control State and status information is available in the console only. It is not available from the public API. To view the status of a control, navigate to the Control details page in the AWS Control Tower console.