awscli 1.36.25__py3-none-any.whl → 1.36.26__py3-none-any.whl

awscli/examples/cognito-idp/get-device.rst

@@ -0,0 +1,50 @@
+**To get a device**
+
+The following ``get-device`` example displays one device for currently signed-in user. ::
+
+    aws cognito-idp get-device \
+        --access-token eyJra456defEXAMPLE \
+        --device-key us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
+
+Output::
+
+    {
+        "Device": {
+            "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+            "DeviceAttributes": [
+                {
+                    "Name": "device_status",
+                    "Value": "valid"
+                },
+                {
+                    "Name": "device_name",
+                    "Value": "MyDevice"
+                },
+                {
+                    "Name": "dev:device_arn",
+                    "Value": "arn:aws:cognito-idp:us-west-2:123456789012:owner/diego.us-west-2_EXAMPLE/device/us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
+                },
+                {
+                    "Name": "dev:device_owner",
+                    "Value": "diego.us-west-2_EXAMPLE"
+                },
+                {
+                    "Name": "last_ip_used",
+                    "Value": "192.0.2.1"
+                },
+                {
+                    "Name": "dev:device_remembered_status",
+                    "Value": "remembered"
+                },
+                {
+                    "Name": "dev:device_sdk",
+                    "Value": "aws-sdk"
+                }
+            ],
+            "DeviceCreateDate": 1715100742.022,
+            "DeviceLastModifiedDate": 1723233651.167,
+            "DeviceLastAuthenticatedDate": 1715100742.0
+        }
+    }
+
+For more information, see `Working with user devices in your user pool <https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html>`__ in the *Amazon Cognito Developer Guide*.

awscli/examples/cognito-idp/get-group.rst

@@ -1,19 +1,22 @@
 **To get information about a group**
 
-This example gets information about a group named MyGroup.
+The following ``get-group`` example lists the properties of the user group named ``MyGroup``. This group has a precedence and an IAM role associated with it. ::
 
-Command::
-
-  aws cognito-idp get-group --user-pool-id us-west-2_aaaaaaaaa --group-name MyGroup
+    aws cognito-idp get-group \
+        --user-pool-id us-west-2_EXAMPLE \
+        --group-name MyGroup
 
 Output::
 
-  {
-    "Group": {
-        "GroupName": "MyGroup",
-        "UserPoolId": "us-west-2_aaaaaaaaa",
-        "Description": "A sample group.",
-        "LastModifiedDate": 1548270073.795,
-        "CreationDate": 1548270073.795
+    {
+        "Group": {
+            "GroupName": "MyGroup",
+            "UserPoolId": "us-west-2_EXAMPLE",
+            "RoleArn": "arn:aws:iam::123456789012:role/example-cognito-role",
+            "Precedence": 7,
+            "LastModifiedDate": 1697211218.305,
+            "CreationDate": 1611685503.954
+        }
     }
-  }
+
+For more information, see `Adding groups to a user pool <https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-user-groups.html>`__ in the *Amazon Cognito Developer Guide*.

awscli/examples/cognito-idp/list-devices.rst

@@ -0,0 +1,53 @@
+**To list devices for a user**
+
+The following ``list-devices`` example lists devices for the currently sign-in user. ::
+
+    aws cognito-idp admin-list-devices \
+        --user-pool-id us-west-2_EXAMPLE \
+        --access-token eyJra456defEXAMPLE \
+        --limit 1
+
+Output::
+
+    {
+        "Devices": [
+            {
+                "DeviceKey": "us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+                "DeviceAttributes": [
+                    {
+                        "Name": "device_status",
+                        "Value": "valid"
+                    },
+                    {
+                        "Name": "device_name",
+                        "Value": "MyDevice"
+                    },
+                    {
+                        "Name": "dev:device_arn",
+                        "Value": "arn:aws:cognito-idp:us-west-2:123456789012:owner/diego.us-west-2_EXAMPLE/device/us-west-2_a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
+                    },
+                    {
+                        "Name": "dev:device_owner",
+                        "Value": "diego.us-west-2_EXAMPLE"
+                    },
+                    {
+                        "Name": "last_ip_used",
+                        "Value": "192.0.2.1"
+                    },
+                    {
+                        "Name": "dev:device_remembered_status",
+                        "Value": "remembered"
+                    },
+                    {
+                        "Name": "dev:device_sdk",
+                        "Value": "aws-sdk"
+                    }
+                ],
+                "DeviceCreateDate": 1715100742.022,
+                "DeviceLastModifiedDate": 1723233651.167,
+                "DeviceLastAuthenticatedDate": 1715100742.0
+            }
+        ]
+    }
+
+For more information, see `Working with user devices in your user pool <https://docs.aws.amazon.com/cognito/latest/developerguide/amazon-cognito-user-pools-device-tracking.html>`__ in the *Amazon Cognito Developer Guide*.

awscli/examples/ec2/describe-capacity-reservation-fleets.rst

@@ -1,6 +1,6 @@
 **To view a Capacity Reservation Fleet**
 
-The following ``describe-capacity-reservation-fleets`` example lists configuration and capacity information for the specified Capacity Reservation Fleet. It also lists details about the individual Capacity Reservations that are inside the Fleet.::
+The following ``describe-capacity-reservation-fleets`` example lists configuration and capacity information for the specified Capacity Reservation Fleet. It also lists details about the individual Capacity Reservations that are inside the Fleet. ::
 
     aws ec2 describe-capacity-reservation-fleets \
         --capacity-reservation-fleet-ids crf-abcdef01234567890
@@ -10,7 +10,7 @@ Output::
     {
         "CapacityReservationFleets": [
             {
-                "Status": "active", 
+                "State": "active", 
                 "EndDate": "2022-12-31T23:59:59.000Z", 
                 "InstanceMatchCriteria": "open", 
                 "Tags": [], 
@@ -38,4 +38,4 @@ Output::
         ]
     }
 
-For more information about Capacity Reservation Fleets, see `Capacity Reservation Fleets <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html>`__ in the *Amazon EC2 User Guide*.
+For more information about Capacity Reservation Fleets, see `Capacity Reservation Fleets <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cr-fleets.html>`__ in the *Amazon EC2 User Guide*.

awscli/examples/ec2/import-snapshot.rst

@@ -4,7 +4,7 @@ The following ``import-snapshot`` example imports the specified disk as a snapsh
 
     aws ec2 import-snapshot \
         --description "My server VMDK" \
-        --disk-container Format=VMDK,UserBucket={S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.vmdk}
+        --disk-container Format=VMDK,UserBucket={'S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.vmdk'}
 
 Output::
 

awscli/examples/ecr-public/batch-delete-image.rst

@@ -0,0 +1,92 @@
+**Example 1: To delete an image by using image digest ids, the image and all of its tags are deleted within a repository in a public registry**
+
+The following ``batch-delete-image`` example deletes an image by specifying the image digest.::
+
+    aws ecr-public batch-delete-image \
+        --repository-name project-a/nginx-web-app \
+        --image-ids imageDigest=sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2 
+
+Output::
+
+    {
+    "imageIds": [
+        {
+            "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2",
+            "imageTag": "latest"
+        }
+    ],
+    "failures": []
+    }
+
+For more information, see `Deleting an image in a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html>`__ in the *Amazon ECR Public User Guide*.
+
+**Example 2: To delete any image by specifying the tag associated with the image you want to delete from the repository.**
+
+The following ``batch-delete-image`` example deletes an image by specifying the tag associated with the image repository named ``project-a/nginx-web-app`` in a public registry. If you have only one tag and execute this command, it will remove the image. Otherwise, if you have multiple tags for the same image, specify one, and only the tag is removed from repository and not the image. ::
+
+    aws ecr-public batch-delete-image \
+        --repository-name project-a/nginx-web-app \
+        --image-ids imageTag=_temp
+
+Output::
+
+    {
+        "imageIds": [
+            {
+                "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0",
+                "imageTag": "_temp"
+            }
+        ],
+        "failures": []
+    }
+
+For more information, see `Deleting an image in a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html>`__ in the *Amazon ECR Public User Guide*.
+
+**Example 3: To delete multiple images, you can specify multiple image tags or image digests in the request for a repository in a public registry.**
+
+The following ``batch-delete-image`` example delete multiple images from a repository named `project-a/nginx-web-app` by specifying multiple image tags or image digests in the request. ::
+
+    aws ecr-public batch-delete-image \
+        --repository-name project-a/nginx-web-app \
+        --image-ids imageTag=temp2.0  imageDigest=sha256:47ba980bc055353d9c0af89b1894f68faa43ca93856917b8406316be86f01278
+
+Output::
+
+   {
+        "imageIds": [
+            {
+                "imageDigest": "sha256:47ba980bc055353d9c0af89b1894f68faa43ca93856917b8406316be86f01278"
+            },
+            {
+                "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0",
+                "imageTag": "temp2.0"
+            }
+        ],
+        "failures": []
+    }
+
+For more information, see `Deleting an image in a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html>`__ in the *Amazon ECR Public User Guide*.
+
+**Example 4: To delete an image in cross AWS Account using registry-id and imagedigest ids, the image and all of its tags are deleted within a repository in a public registry**
+
+The following ``batch-delete-image`` example deletes an image by specifying the image digest in the cross AWS Account.::
+
+    aws ecr-public batch-delete-image \
+        --registry-id 123456789098 \
+        --repository-name project-a/nginx-web-app \
+        --image-ids imageDigest=sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2 \
+        --region us-east-1
+
+Output::
+
+    {
+        "imageIds": [
+            {
+                "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2",
+                "imageTag": "temp2.0"
+            }
+        ],
+        "failures": []
+    }
+
+For more information, see `Deleting an image in a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-image-delete.html>`__ in the *Amazon ECR Public User Guide*.

awscli/examples/ecr-public/create-repository.rst

@@ -1,6 +1,6 @@
 **Example 1: To create a repository in a public registry**
 
-The following ``create-repository`` example creates a repository named ``project-a/nginx-web-app`` in a public registry. ::
+The following ``create-repository`` example creates a repository named `project-a/nginx-web-app` in a public registry. ::
 
     aws ecr-public create-repository \
         --repository-name project-a/nginx-web-app
@@ -22,12 +22,13 @@ For more information, see `Creating a public repository <https://docs.aws.amazon
 
 **Example 2: To create a repository in a public registry with short description of the contents of the repository, system and operating architecture that the images in the repository are compatible with**
 
-The following ``create-repository`` example creates a repository named ``project-a/nginx-web-app`` in a public registry with short description of the contents of the repository, system and operating architecture that the images in the repository are compatible with. ::
+The following ``create-repository`` example creates a repository named `project-a/nginx-web-app` in a public registry with short description of the contents of the repository, system and operating architecture that the images in the repository are compatible with. ::
 
     aws ecr-public create-repository \
         --repository-name project-a/nginx-web-app \
         --catalog-data 'description=My project-a ECR Public Repository,architectures=ARM,ARM 64,x86,x86-64,operatingSystems=Linux'
 
+
 Output::
 
     {

awscli/examples/ecr-public/delete-repository-policy.rst

@@ -0,0 +1,17 @@
+**To delete a repository policy in a public registry**
+
+The following ``delete-repository-policy`` example delete repository policy for the ECR Public repository in your AWS account. ::
+
+    aws ecr-public delete-repository-policy \
+         --repository-name project-a/nginx-web-app \
+         --region us-east-1
+
+Output::
+
+    {
+        "registryId": "123456789012",
+        "repositoryName": "project-a/nginx-web-app",
+        "policyText": "{\n  \"Version\" : \"2008-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"AllowPush\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"AWS\" : [ \"arn:aws:iam:"123456789012":user/eksuser1\", \"arn:aws:iam:"123456789012":user/admin\" ]\n    },\n    \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n  } ]\n}"
+    }
+
+For more information, see `Deleting a public repository policy statement <https://docs.aws.amazon.com/AmazonECR/latest/public/delete-public-repository-policy.html>`__ in the *Amazon ECR Public User Guide*.

awscli/examples/ecr-public/delete-repository.rst

@@ -17,4 +17,4 @@ Output::
         }
     }
 
-For more information, see `Deleting a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-delete.html>`__ in the *Amazon ECR Public User Guide*.
+For more information, see `Deleting a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-delete.html>`__ in the *Amazon ECR Public*.

awscli/examples/ecr-public/describe-image-tags.rst

@@ -0,0 +1,25 @@
+**Example 1: To describe image tag details in public repository**
+
+The following ``describe-image-tags`` example describe imagetags in the ``project-a/nginx-web-app`` sample repository. ::
+
+    aws ecr-public describe-image-tags \
+        --repository-name project-a/nginx-web-app \
+        --region us-east-1
+
+Output::
+
+    {
+        "imageTagDetails": [
+            {
+                "imageTag": "latest",
+                "createdAt": "2024-07-10T22:29:00-05:00",
+                "imageDetail": {
+                    "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2",
+                    "imageSizeInBytes": 121956548,
+                    "imagePushedAt": "2024-07-10T22:29:00-05:00",
+                    "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json",
+                    "artifactMediaType": "application/vnd.docker.container.image.v1+json"
+                }
+            }
+        ]
+    }

awscli/examples/ecr-public/describe-images.rst

@@ -0,0 +1,82 @@
+**Example 1: To describe images in a public registry repository**
+
+The following ``describe-images`` example describes imagesDetails in a repository named ``project-a/nginx-web-app`` in a public registry. ::
+
+    aws ecr-public describe-images \
+        --repository-name project-a/nginx-web-app \
+        --region us-east-1
+
+Output::
+
+    {
+        "imageDetails": [
+            {
+                "registryId": "123456789012",
+                "repositoryName": "project-a/nginx-web-app",
+                "imageDigest": "sha256:0d8c93e72e82fa070d49565c00af32abbe8ddfd7f75e39f4306771ae0628c7e8",
+                "imageTags": [
+                    "temp1.0"
+                ],
+                "imageSizeInBytes": 123184716,
+                "imagePushedAt": "2024-07-23T11:32:49-05:00",
+                "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json",
+                "artifactMediaType": "application/vnd.docker.container.image.v1+json"
+            },
+            {
+                "registryId": "123456789012",
+                "repositoryName": "project-a/nginx-web-app",
+                "imageDigest": "sha256:b1f9deb5fe3711a3278379ebbcaefbc5d70a2263135db86bd27a0dae150546c2",
+                "imageTags": [
+                    "temp2.0"
+                ],
+                "imageSizeInBytes": 121956548,
+                "imagePushedAt": "2024-07-23T11:39:38-05:00",
+                "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json",
+                "artifactMediaType": "application/vnd.docker.container.image.v1+json"
+            },
+            {
+                "registryId": "123456789012",
+                "repositoryName": "project-a/nginx-web-app",
+                "imageDigest": "sha256:f7a86a0760e2f8d7eff07e515fc87bf4bac45c35376c06f9a280f15ecad6d7e0",
+                "imageTags": [
+                    "temp3.0",
+                    "latest"
+                ],
+                "imageSizeInBytes": 232108879,
+                "imagePushedAt": "2024-07-22T00:54:34-05:00",
+                "imageManifestMediaType": "application/vnd.docker.distribution.manifest.v2+json",
+                "artifactMediaType": "application/vnd.docker.container.image.v1+json"
+            }
+        ]
+    }
+
+For more information, see `Describe an image in a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/docker-push-multi-architecture-image.html>`__ in the *Amazon ECR Public*.
+
+**Example 2: To describe images from the repository by sort imageTags & imagePushedAt**
+
+The following ``describe-images`` example describe images within repository named `project-a/nginx-web-app` in a public registry. ::
+
+    aws ecr-public describe-images \
+        --repository-name project-a/nginx-web-app \
+        --query 'sort_by(imageDetails,& imagePushedAt)[*].imageTags[*]' \
+        --output text
+
+Output::
+
+    temp3.0 latest
+    temp1.0
+    temp2.0
+
+**Example 3: To describe images from the repository to generate the last 2 image tags pushed in the repository**
+
+The following ``describe-images`` example gets imagetags details from the repository named ``project-a/nginx-web-app`` in a public registry and queries the result to display only the first two records. ::
+
+    aws ecr-public describe-images \
+        --repository-name project-a/nginx-web-app  \
+        --query 'sort_by(imageDetails,& imagePushedAt)[*].imageTags[*] | [0:2]' \
+        --output text
+
+Output::
+
+    temp3.0 latest
+    temp1.0

awscli/examples/ecr-public/get-authorization-token.rst

@@ -0,0 +1,32 @@
+**Example 1: To retrieve an authorization token for any Amazon ECR public registry that the IAM principal has access**
+
+The following ``get-authorization-token`` example gets an authorization token with the AWS CLI and sets it to an environment variable. ::
+
+      aws ecr-public get-authorization-token \
+          --region us-east-1
+
+Output::
+
+    {
+        "authorizationData": {
+            "authorizationToken": "QVdTOmV5SndZWGxzYjJKJFHDSFKJHERWUY65IOU36TRYEGFNSDLRIUOTUYTHJKLDFGOcmFUQk9OSFV2UVV4a0x6Sm1ZV0Z6TDFndlZtUjJSVmgxVEVObU9IZEdTWEZxU210c1JUQm5RWGxOUVV4NlNFUnROWG92ZWtGbWJFUjRkbWMyV0U5amFpczRNWGxTVkM5Tk5qWkVUM2RDYm05TVJqSkxjV3BsUVZvMmFYSm5iV1ZvVFdGSVRqVlFMMHN4VnpsTGVXbDFRWGRoTmpsbWFuQllhbVl6TkdGaGMwUjJha2xsYUhscWRscHZTRUpFVkVnNVQwNUdOVFpPY2xZclVFNVFVWGRSVFZvd04xUkhjVGxZZFVkQ1ZFZHBPRUptUzBVclYxQldMMjVMVkRsd2VFVlNSa1EzTWpWSlIxRkVWakJGZFZOVWEzaFBSVk5FWWpSc1lWZHZWMHBSYmxaMlJYWmhZekpaWVVOeFppdFlUa2xKU1RCdFUwdElVbXRJYlhGRk1WaFhNVTVRTkdwc1FYRlVNVWxZZUhkV05Xa3ZXWGd3ZUVZMWIyeE5VRU5QZEdSaWRHOU9lakZOZVdwTVZEUkNRVzlvYzNKSlpsRXhhR2cwWjJwRVJFVjNWalEzYjNCUmRIcEZUR1pYU1Rsc1kxSlNNbU5hUW5wRE1tOUpRMHR5Y1hkeGNXNDVMMmx4Um5GUlVGQnhjMVpQZG5WYUswOW9SQ3RPY0hwSlRsUk5lVXQyY0c1b1FsQjVZVEprVmtSdmJsQklOM05RU3pkNmQydERhMkZ5VmxSRmFVUndWVlE1ZGtsVWFXUkJWMFZEWVhoSFdXTk5VMXBTYTFreVRHZEVlVVZ0ZFRWRk4xTTVjRXBDUjBRMlYyTkdPVWhGWkVweVVGcEVaRFJxZUVablkwNXFaamh5YkVKWmJGSTNOVzFXSzFjdllXSTVTMWx2YUZacksxSnJWSFJ0Wml0T1NFSnpWVFZvV204eVFYbzFWRU5SYjNaR01Va3hPR3h2TWxkNVJsSmpUbTVSTjNjemJsUkdVRlZKVDBjeE9VeHlXVEpGVFRSS2NWbFdkVEJrV0VreFVsSktXbkpCVGtsMFdVZEJOMjltWjFFNGVHRktNbGRuWlVoUlNXNXdZV3A0VjI5M2FYZGljbE5tZGpkQ1ZYTmhOVFUyTDBzeVpteDBka0pUTVdkNGJ6TkxkSEJDYml0cE0waGhTbVpEZEZkQ00yOU1TM1pXTDNSVFlWaFpWelZXVWxjNFRXNXdhR3BhUmpoU1FuWnFkRlJMVW5abGRYRlNjVVJKZDBaSFpXUTRabEZUTUdOTVQwcFFkVXAyYjA5Tk9UaFlZMjEwVnpFMlpXdE9hMnBWV0hST1owUkpVV3R1VFU1dGJXWjNNVGc0VTAxUlNHZE9TbXRMY2tWYWJVeFljVVk0ZWpsTFdWWlRNbEZMVDJkMk1FaFBTMDl5YzJSM1NqTlplRGhUWVVOQlJGWnRlbkU1WTBKVFdqTktSR05WTkd0RGNEVjZNalJHVXpkVk9HTnVSa2xLUVd4SVJDODJXbGcyYldGemJVczJPRVp6TDBoNFMwWkRUMmdyYldGa1QwWjVhMlZQTm5SQ1l6QkpNbFpyVUhSaGVIbFVOR296VjFGVlQyMHpNeTlPWVVoSk1FdDBWalZFU2pneU5rcHNLemQxZDNwcVp6RlNja3AwVm10VU0yRnRWWGMzZDJnMFduSnFjVXczWTBjclNXeHFUVlUyVkZwWGNWY3ZSV0V6WW1oT2JIRklZVlJHU1RrMGEyOVJiMHBPVUhORk9FdERjbFJZY0daS2VVdHRZa2x5YjFORE4zSkJaWEJPZUU5eGR6WnhZMlY1WXprM1JtSkZhVFZFYkVFck5EUk9ZMWRyVEVNd1dqa2lMQ0prWVhSaGEyVjVJam9pWlhsS1VWSkdaMmxQYVVwV1ZXeENhVk5YVm14WFdFWk5VMjFrV21SRE9YaGFhWFF4VkhwS1MyTkljSHBVUms0MFlWaHNTbUpIYUhsWFZHdDZZVWhqZDFKRmFETldNbFYyWTJ0cmVVMUlTbHBWUjJONFRURlJNMDlHYUd4U01uaHVWRVJzUWxaV1pGZFJibkJLV1RCYU5HTXpUakpXTUhoWFRrWndhRTVyTVVwVFZFSkdWV3RzTUZaVVpEQlRSVGxyVkVkb2FGUlVVWHBaTVhCSFQxWmFOVlJxU20xaVZXUnVTM3BaTlZaV2NIcFdWMlJGVkcwMVRHSXdSakpXUnpoNlVsUm5kbUpzUmpGT2FUazFWVzFTY0dWR1FtOVdiVEZoVmpKc1NWRllhRmRTUkZwc1V6SkdSbUpWYkhCVlNFbDJWVzB4Ym1OVk1IWmFhelZ3WkZoa1FtVnFUa3BpTTJoTVRWVk9jMVo2V2t4aWJFWnJWRVUxVW1ONlp6QldWVFZPWW14c01sZFlZekprUjFwVFkxaE9kRnBXWkhaVFZWcGhWa2MxU2xWRlVtdFRiWE16WWpOVmVrNXFSa2RVTTJSd1QwaGtXbVJIVVhsbGJYQkRaRlp2ZGxvd1ZqWmlNbEl4Vkc1T2FtSldjRU5VU0ZVd1kwZDRjbU14WkhaVVYwNTRaRzV2TWxSVlVsQmpiSEJPVkc1VmVsZEZPVzVYYkVwWlUyNWtVbGRZWkZWaVdFWlNUVzF3VFZSSVFraE9XRnBwWVZoak0xUnJXak5OYm04eFpEQk9XbEZzYkhSTmEyaHpaRmRTUTJORVFUQlpWMk01VUZOSmMwbHJiRUpTUTBrMlNXNUZlbHA2U1RGVVZXeFVZekIwYVU5RWFEVmtiRVpzVVZWc2QxbHJWbmxOYW13MVZWaG9UazVzVWpWbFJHaDZZMjFHVkZVeFFubFZXRTVLVGpCMGFXSlZNWGhpUjBwTVlUSTVNRTVVYXpCTE0wVnlWakF4VG1WSE5VcGtSa0pRVld4V1UwOVdVWGhqTVc4eVZraFdlVnA2VGsxV01tUnhVV3Q0ZEdGcVRsUk5hMnN5V2tSV2FtUkdVakZqVm5CUFVrUlNjR0pHUm1GbGFscDRXV2x6Y2xFd1VYcGhSRnBZVmtaU2FVNXVSVFZYYlVaVFpXdHdkVmRZVGpaVGEyaDBWMnhDVlU0elZrWlRSRUpIVlVWa2MwNVlhRFZsUkVwelQwWkNSbE5WY0ZGWFNFWXhaVmMxVEZsVE9VeFdhMGt4V1ROS1Rrd3pXazFpYkhCdFVrUldWRlJHVlhaTmJVazBZbFZzUkV3d2N6UldSV2MxVDBWa05tSXpiM2hXVms1V1ZtMDFiRkZUT1hoUFJVcHpUMGRzU2xaSVJrTkxNVTVFWWtaa05WWnViRmRYVjJRd1RXcG5kMVJWUmpCa1JYQkdZVlYwZFZNeU1VVlpWVTVQV25wa1ExZHFVbE5sUjBaRVlWVTFXbVZwY3pSTE1HTTFVbFZGTlZwRll6UlRSMVoxVFcxb05XTnJkRUpWZWxsM1RETmplbUV4WkdGU1JsWm9ZVVpzZEdWR2JFTlVNblJYVkRCNE5HUXlkRXhaTWxKTlYxZDBWRTB5YUZwaFJsazFVMGR3Y0ZGVk9YaGxhekV6VVZRd09VbHVNRDBpTENKMlpYSnphVzl1SWpvaU15SXNJblI1Y0dVaU9pSkVRVlJCWDB0RldTSXNJbVY0Y0dseVlYUnBiMjRpT2pFM01qRTVOVGMzTmpKOQ==",
+            "expiresAt": "2024-07-25T21:37:26.301000-04:00"
+        }
+    }
+
+For more information, see `Amazon ECR public registries <https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#registry_auth_http>`__ in the *Amazon ECR Public*.
+
+**Example 2: To retrieve an authorization token for any Amazon ECR public registry that the IAM principal has access**
+
+The following ``get-authorization-token`` example gets an authorization token with the AWS CLI and sets it to an environment variable. ::
+
+    aws ecr-public get-authorization-token \
+        --region us-east-1 \
+        --output=text \
+        --query 'authorizationData.authorizationToken'
+
+Output::
+
+    QVdTOmV5SndZWGxzYjJKJFHDSFKJHERWUY65IOU36TRYEGFNSDLRIUOTUYTHJKLDFGOcmFUQk9OSFV2UVV4a0x6Sm1ZV0Z6TDFndlZtUjJSVmgxVEVObU9IZEdTWEZxU210c1JUQm5RWGxOUVV4NlNFUnROWG92ZWtGbWJFUjRkbWMyV0U5amFpczRNWGxTVkM5Tk5qWkVUM2RDYm05TVJqSkxjV3BsUVZvMmFYSm5iV1ZvVFdGSVRqVlFMMHN4VnpsTGVXbDFRWGRoTmpsbWFuQllhbVl6TkdGaGMwUjJha2xsYUhscWRscHZTRUpFVkVnNVQwNUdOVFpPY2xZclVFNVFVWGRSVFZvd04xUkhjVGxZZFVkQ1ZFZHBPRUptUzBVclYxQldMMjVMVkRsd2VFVlNSa1EzTWpWSlIxRkVWakJGZFZOVWEzaFBSVk5FWWpSc1lWZHZWMHBSYmxaMlJYWmhZekpaWVVOeFppdFlUa2xKU1RCdFUwdElVbXRJYlhGRk1WaFhNVTVRTkdwc1FYRlVNVWxZZUhkV05Xa3ZXWGd3ZUVZMWIyeE5VRU5QZEdSaWRHOU9lakZOZVdwTVZEUkNRVzlvYzNKSlpsRXhhR2cwWjJwRVJFVjNWalEzYjNCUmRIcEZUR1pYU1Rsc1kxSlNNbU5hUW5wRE1tOUpRMHR5Y1hkeGNXNDVMMmx4Um5GUlVGQnhjMVpQZG5WYUswOW9SQ3RPY0hwSlRsUk5lVXQyY0c1b1FsQjVZVEprVmtSdmJsQklOM05RU3pkNmQydERhMkZ5VmxSRmFVUndWVlE1ZGtsVWFXUkJWMFZEWVhoSFdXTk5VMXBTYTFreVRHZEVlVVZ0ZFRWRk4xTTVjRXBDUjBRMlYyTkdPVWhGWkVweVVGcEVaRFJxZUVablkwNXFaamh5YkVKWmJGSTNOVzFXSzFjdllXSTVTMWx2YUZacksxSnJWSFJ0Wml0T1NFSnpWVFZvV204eVFYbzFWRU5SYjNaR01Va3hPR3h2TWxkNVJsSmpUbTVSTjNjemJsUkdVRlZKVDBjeE9VeHlXVEpGVFRSS2NWbFdkVEJrV0VreFVsSktXbkpCVGtsMFdVZEJOMjltWjFFNGVHRktNbGRuWlVoUlNXNXdZV3A0VjI5M2FYZGljbE5tZGpkQ1ZYTmhOVFUyTDBzeVpteDBka0pUTVdkNGJ6TkxkSEJDYml0cE0waGhTbVpEZEZkQ00yOU1TM1pXTDNSVFlWaFpWelZXVWxjNFRXNXdhR3BhUmpoU1FuWnFkRlJMVW5abGRYRlNjVVJKZDBaSFpXUTRabEZUTUdOTVQwcFFkVXAyYjA5Tk9UaFlZMjEwVnpFMlpXdE9hMnBWV0hST1owUkpVV3R1VFU1dGJXWjNNVGc0VTAxUlNHZE9TbXRMY2tWYWJVeFljVVk0ZWpsTFdWWlRNbEZMVDJkMk1FaFBTMDl5YzJSM1NqTlplRGhUWVVOQlJGWnRlbkU1WTBKVFdqTktSR05WTkd0RGNEVjZNalJHVXpkVk9HTnVSa2xLUVd4SVJDODJXbGcyYldGemJVczJPRVp6TDBoNFMwWkRUMmdyYldGa1QwWjVhMlZQTm5SQ1l6QkpNbFpyVUhSaGVIbFVOR296VjFGVlQyMHpNeTlPWVVoSk1FdDBWalZFU2pneU5rcHNLemQxZDNwcVp6RlNja3AwVm10VU0yRnRWWGMzZDJnMFduSnFjVXczWTBjclNXeHFUVlUyVkZwWGNWY3ZSV0V6WW1oT2JIRklZVlJHU1RrMGEyOVJiMHBPVUhORk9FdERjbFJZY0daS2VVdHRZa2x5YjFORE4zSkJaWEJPZUU5eGR6WnhZMlY1WXprM1JtSkZhVFZFYkVFck5EUk9ZMWRyVEVNd1dqa2lMQ0prWVhSaGEyVjVJam9pWlhsS1VWSkdaMmxQYVVwV1ZXeENhVk5YVm14WFdFWk5VMjFrV21SRE9YaGFhWFF4VkhwS1MyTkljSHBVUms0MFlWaHNTbUpIYUhsWFZHdDZZVWhqZDFKRmFETldNbFYyWTJ0cmVVMUlTbHBWUjJONFRURlJNMDlHYUd4U01uaHVWRVJzUWxaV1pGZFJibkJLV1RCYU5HTXpUakpXTUhoWFRrWndhRTVyTVVwVFZFSkdWV3RzTUZaVVpEQlRSVGxyVkVkb2FGUlVVWHBaTVhCSFQxWmFOVlJxU20xaVZXUnVTM3BaTlZaV2NIcFdWMlJGVkcwMVRHSXdSakpXUnpoNlVsUm5kbUpzUmpGT2FUazFWVzFTY0dWR1FtOVdiVEZoVmpKc1NWRllhRmRTUkZwc1V6SkdSbUpWYkhCVlNFbDJWVzB4Ym1OVk1IWmFhelZ3WkZoa1FtVnFUa3BpTTJoTVRWVk9jMVo2V2t4aWJFWnJWRVUxVW1ONlp6QldWVFZPWW14c01sZFlZekprUjFwVFkxaE9kRnBXWkhaVFZWcGhWa2MxU2xWRlVtdFRiWE16WWpOVmVrNXFSa2RVTTJSd1QwaGtXbVJIVVhsbGJYQkRaRlp2ZGxvd1ZqWmlNbEl4Vkc1T2FtSldjRU5VU0ZVd1kwZDRjbU14WkhaVVYwNTRaRzV2TWxSVlVsQmpiSEJPVkc1VmVsZEZPVzVYYkVwWlUyNWtVbGRZWkZWaVdFWlNUVzF3VFZSSVFraE9XRnBwWVZoak0xUnJXak5OYm04eFpEQk9XbEZzYkhSTmEyaHpaRmRTUTJORVFUQlpWMk01VUZOSmMwbHJiRUpTUTBrMlNXNUZlbHA2U1RGVVZXeFVZekIwYVU5RWFEVmtiRVpzVVZWc2QxbHJWbmxOYW13MVZWaG9UazVzVWpWbFJHaDZZMjFHVkZVeFFubFZXRTVLVGpCMGFXSlZNWGhpUjBwTVlUSTVNRTVVYXpCTE0wVnlWakF4VG1WSE5VcGtSa0pRVld4V1UwOVdVWGhqTVc4eVZraFdlVnA2VGsxV01tUnhVV3Q0ZEdGcVRsUk5hMnN5V2tSV2FtUkdVakZqVm5CUFVrUlNjR0pHUm1GbGFscDRXV2x6Y2xFd1VYcGhSRnBZVmtaU2FVNXVSVFZYYlVaVFpXdHdkVmRZVGpaVGEyaDBWMnhDVlU0elZrWlRSRUpIVlVWa2MwNVlhRFZsUkVwelQwWkNSbE5WY0ZGWFNFWXhaVmMxVEZsVE9VeFdhMGt4V1ROS1Rrd3pXazFpYkhCdFVrUldWRlJHVlhaTmJVazBZbFZzUkV3d2N6UldSV2MxVDBWa05tSXpiM2hXVms1V1ZtMDFiRkZUT1hoUFJVcHpUMGRzU2xaSVJrTkxNVTVFWWtaa05WWnViRmRYVjJRd1RXcG5kMVJWUmpCa1JYQkdZVlYwZFZNeU1VVlpWVTVQV25wa1ExZHFVbE5sUjBaRVlWVTFXbVZwY3pSTE1HTTFVbFZGTlZwRll6UlRSMVoxVFcxb05XTnJkRUpWZWxsM1RETmplbUV4WkdGU1JsWm9ZVVpzZEdWR2JFTlVNblJYVkRCNE5HUXlkRXhaTWxKTlYxZDBWRTB5YUZwaFJsazFVMGR3Y0ZGVk9YaGxhekV6VVZRd09VbHVNRDBpTENKMlpYSnphVzl1SWpvaU15SXNJblI1Y0dVaU9pSkVRVlJCWDB0RldTSXNJbVY0Y0dseVlYUnBiMjRpT2pFM01qRTVOVGMzTmpKOQ
+
+For more information, see `Amazon ECR public registries <https://docs.aws.amazon.com/AmazonECR/latest/public/public-registries.html#registry_auth_http>`__ in the *Amazon ECR Public*.

awscli/examples/ecr-public/get-repository-policy.rst

@@ -0,0 +1,17 @@
+**To get a repository policy associated with the repository**
+
+The following ``get-repository-policy`` example gets a repository policy associated with the repository. ::
+
+    aws ecr-public get-repository-policy \
+        --repository-name project-a/nginx-web-app \
+        --region us-east-1
+
+Output::
+
+    {
+        "registryId": "123456789012",
+        "repositoryName": "project-a/nginx-web-app",
+        "policyText": "{\n  \"Version\" : \"2008-10-17\",\n  \"Statement\" : [ {\n    \"Sid\" : \"AllowPush\",\n    \"Effect\" : \"Allow\",\n    \"Principal\" : {\n      \"AWS\" : [ \"arn:aws:iam::123456789012:user/eksuser1\", \"arn:aws:iam::123456789012:user/admin\" ]\n    },\n    \"Action\" : [ \"ecr-public:BatchCheckLayerAvailability\", \"ecr-public:PutImage\", \"ecr-public:InitiateLayerUpload\", \"ecr-public:UploadLayerPart\", \"ecr-public:CompleteLayerUpload\" ]\n  } ]\n}"
+    }
+
+For more information, see `Use GetRepositoryPolicy with an AWS SDK or CLI <https://docs.aws.amazon.com/AmazonECR/latest/userguide/example_ecr_GetRepositoryPolicy_section.html>`__ in the *Amazon ECR Public User Guide*.

awscli/examples/ecr-public/put-repository-catalog-data.rst

@@ -0,0 +1,50 @@
+**Example 1: To creates or updates the catalog data for a repository in a public registry.**
+
+The following ``put-repository-catalog-data`` example creates or update catalog data for reposiotry named `project-a/nginx-web-app` in a public registry, along with logoImageBlob, aboutText, usageText and tags information. ::
+
+    aws ecr-public put-repository-catalog-data \
+        --repository-name project-a/nginx-web-app \
+        --cli-input-json file://repository-catalog-data.json \
+        --region us-east-1
+
+Contents of ``repository-catalog-data.json``::
+
+    {
+        "catalogData": {
+            "description": "My project-a ECR Public Repository",
+            "architectures": [
+                "ARM",
+                "ARM 64",
+                "x86",
+                "x86-64"
+            ],
+            "operatingSystems": [
+                "Linux"
+            ],
+            "logoImageBlob": "iVBORw0KGgoAAAANSUhEUgAAAYYAAAGGCAMAAABIXtbXAAAAq1BMVEVHcEz// <abbreviated>",
+            "aboutText": "## Quick reference.",
+            "usageText": "## Supported architectures are as follows"
+        }
+    }
+
+Output::
+
+    {
+        "catalogData": {
+            "description": "My project-a ECR Public Repository",
+            "architectures": [
+                "ARM",
+                "ARM 64",
+                "x86",
+                "x86-64"
+            ],
+            "operatingSystems": [
+                "Linux"
+            ],
+            "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/491d3846-8f33-4d8b-a10c-c2ce271e6c0d/4f09d87c-2569-4916-a932-5c296bf6f88a.png",
+            "aboutText": "## Quick reference.",
+            "usageText": "## Supported architectures are as follows."
+        }
+    }
+
+For more information, see `Repository catalog data <https://docs.aws.amazon.com/AmazonECR/latest/public/public-repository-catalog-data.html>`__ in the *Amazon ECR Public*.