Skip to main content

policy

Gets an individual policy resource

Overview

Namepolicy
TypeResource
Descriptionpolicy
Idawscc.organizations.policy

Fields

NameDatatypeDescription
namestringName of the Policy
typestringThe type of policy to create. You can specify one of the following values: AISERVICES_OPT_OUT_POLICY, BACKUP_POLICY, SERVICE_CONTROL_POLICY, TAG_POLICY
contentobjectThe Policy text content. For AWS CloudFormation templates formatted in YAML, you can provide the policy in JSON or YAML format. AWS CloudFormation always converts a YAML policy to JSON format before submitting it.
descriptionstringHuman readable description of the policy
target_idsarrayList of unique identifiers (IDs) of the root, OU, or account that you want to attach the policy to
tagsarrayA list of tags that you want to attach to the newly created policy. For each tag in the list, you must specify both a tag key and a value. You can set the value to an empty string, but you can't set it to null.
idstringId of the Policy
arnstringARN of the Policy
aws_managedbooleanA boolean value that indicates whether the specified policy is an AWS managed policy. If true, then you can attach the policy to roots, OUs, or accounts, but you cannot edit it.
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
name,
type,
content,
description,
target_ids,
tags,
id,
arn,
aws_managed
FROM awscc.organizations.policy
WHERE data__Identifier = '<Id>';

Permissions

To operate on the policy resource, the following permissions are required:

Read

organizations:DescribePolicy,
organizations:ListTargetsForPolicy,
organizations:ListTagsForResource

Update

organizations:AttachPolicy,
organizations:DetachPolicy,
organizations:UpdatePolicy,
organizations:ListTagsForResource,
organizations:ListTargetsForPolicy,
organizations:TagResource,
organizations:UntagResource,
organizations:DescribePolicy

Delete

organizations:DetachPolicy,
organizations:DeletePolicy