HEX
Server: Apache
System: Linux pdx1-shared-a1-38 6.6.104-grsec-jammy+ #3 SMP Tue Sep 16 00:28:11 UTC 2025 x86_64
User: mmickelson (3396398)
PHP: 8.1.31
Disabled: NONE
Upload Files
File: //usr/lib/python3/dist-packages/awscli/examples/organizations/update-policy.rst
**Example 1: To rename a policy**

The following ``update-policy`` example renames a policy and gives it a new description. ::

    aws organizations update-policy \
        --policy-id p-examplepolicyid111 \
        --name Renamed-Policy \
        --description "This description replaces the original."

The output shows the new name and description. ::

    {
        "Policy": {
            "Content": "{\n  \"Version\":\"2012-10-17\",\n  \"Statement\":{\n    \"Effect\":\"Allow\",\n    \"Action\":\"ec2:*\",\n    \"Resource\":\"*\"\n  }\n}\n",
            "PolicySummary": {
                "Id": "p-examplepolicyid111",
                "AwsManaged": false,
                "Arn":"arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
                "Description": "This description replaces the original.",
                "Name": "Renamed-Policy",
                "Type": "SERVICE_CONTROL_POLICY"
            }    
        }
    }

**Example 2: To replace a policy's JSON text content**

The following example shows you how to replace the JSON text of the SCP in the previous example with a new JSON policy text string that allows S3 instead of EC2: ::

    aws organizations update-policy \
        --policy-id p-examplepolicyid111 \
        --content "{\"Version\":\"2012-10-17\",\"Statement\":{\"Effect\":\"Allow\",\"Action\":\"s3:*\",\"Resource\":\"*\"}}"

The output shows the new content::

    {
        "Policy": {
            "Content": "{ \"Version\": \"2012-10-17\", \"Statement\": { \"Effect\": \"Allow\", \"Action\": \"s3:*\", \"Resource\": \"*\" } }",
            "PolicySummary": {    
                "Arn": "arn:aws:organizations::111111111111:policy/o-exampleorgid/service_control_policy/p-examplepolicyid111",
                "AwsManaged": false;
                "Description": "This description replaces the original.",
                "Id": "p-examplepolicyid111",
                "Name": "Renamed-Policy",
                "Type": "SERVICE_CONTROL_POLICY"
            }
        }
    }