awscli 1.37.4__py3-none-any.whl → 1.37.6__py3-none-any.whl

awscli/examples/ec2/describe-capacity-reservations.rst

@@ -10,35 +10,45 @@ Output::
         "CapacityReservations": [
             {
                 "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
-                "EndDateType": "unlimited",
-                "AvailabilityZone": "eu-west-1a",
-                "InstanceMatchCriteria": "open",
-                "Tags": [],
-                "EphemeralStorage": false,
-                "CreateDate": "2019-08-16T09:03:18.000Z",
-                "AvailableInstanceCount": 1,
+                "OwnerId": "123456789111",
+                "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-1234abcd56EXAMPLE",
+                "AvailabilityZoneId": "use1-az2",
+                "InstanceType": "c5.large",
                 "InstancePlatform": "Linux/UNIX",
-                "TotalInstanceCount": 1,
-                "State": "active",
+                "AvailabilityZone": "us-east-1a",
                 "Tenancy": "default",
+                "TotalInstanceCount": 1,
+                "AvailableInstanceCount": 1,
                 "EbsOptimized": true,
-                "InstanceType": "a1.medium"
-            },
-            {
-                "CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
+                "EphemeralStorage": false,
+                "State": "active",
+                "StartDate": "2024-10-23T15:00:24+00:00",
                 "EndDateType": "unlimited",
-                "AvailabilityZone": "eu-west-1a",
                 "InstanceMatchCriteria": "open",
+                "CreateDate": "2024-10-23T15:00:24+00:00",
                 "Tags": [],
-                "EphemeralStorage": false,
-                "CreateDate": "2019-08-07T11:34:19.000Z",
-                "AvailableInstanceCount": 3,
+                "CapacityAllocations": []
+            },
+            {
+                "CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
+                "OwnerId": "123456789111",
+                "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-abcdEXAMPLE9876ef",
+                "AvailabilityZoneId": "use1-az2",
+                "InstanceType": "c4.large",
                 "InstancePlatform": "Linux/UNIX",
-                "TotalInstanceCount": 3,
-                "State": "cancelled",
+                "AvailabilityZone": "us-east-1a",
                 "Tenancy": "default",
+                "TotalInstanceCount": 1,
+                "AvailableInstanceCount": 1,
                 "EbsOptimized": true,
-                "InstanceType": "m5.large"
+                "EphemeralStorage": false,
+                "State": "cancelled",
+                "StartDate": "2024-10-23T15:01:03+00:00",
+                "EndDateType": "unlimited",
+                "InstanceMatchCriteria": "open",
+                "CreateDate": "2024-10-23T15:01:02+00:00",
+                "Tags": [],
+                "CapacityAllocations": []
             }
         ]
     }
@@ -55,20 +65,25 @@ Output::
     {
         "CapacityReservations": [
             {
-                "CapacityReservationId": "cr-1234abcd56EXAMPLE",
-                "EndDateType": "unlimited",
-                "AvailabilityZone": "eu-west-1a",
-                "InstanceMatchCriteria": "open",
-                "Tags": [],
-                "EphemeralStorage": false,
-                "CreateDate": "2019-08-16T09:03:18.000Z",
-                "AvailableInstanceCount": 1,
+                "CapacityReservationId": "cr-abcdEXAMPLE9876ef ",
+                "OwnerId": "123456789111",
+                "CapacityReservationArn": "arn:aws:ec2:us-east-1:123456789111:capacity-reservation/cr-abcdEXAMPLE9876ef",
+                "AvailabilityZoneId": "use1-az2",
+                "InstanceType": "c4.large",
                 "InstancePlatform": "Linux/UNIX",
-                "TotalInstanceCount": 1,
-                "State": "active",
+                "AvailabilityZone": "us-east-1a",
                 "Tenancy": "default",
+                "TotalInstanceCount": 1,
+                "AvailableInstanceCount": 1,
                 "EbsOptimized": true,
-                "InstanceType": "a1.medium"
+                "EphemeralStorage": false,
+                "State": "active",
+                "StartDate": "2024-10-23T15:01:03+00:00",
+                "EndDateType": "unlimited",
+                "InstanceMatchCriteria": "open",
+                "CreateDate": "2024-10-23T15:01:02+00:00",
+                "Tags": [],
+                "CapacityAllocations": []
             }
         ]
     }

awscli/examples/ec2/describe-instance-image-metadata.rst

@@ -0,0 +1,186 @@
+**Example 1: To describe the AMI metadata for all instances**
+
+The following ``describe-instance-image-metadata`` example describes the AMI metadata of all the instances in your AWS account in the specified Region. ::
+
+    aws ec2 describe-instance-image-metadata \
+        --region us-east-1
+
+Output::
+
+    {
+        "InstanceImageMetadata": [
+            {
+                "InstanceId": "i-1234567890EXAMPLE",
+                "InstanceType": "t2.micro",
+                "LaunchTime": "2024-08-28T11:25:45+00:00",
+                "AvailabilityZone": "us-east-1a",
+                "State": {
+                    "Code": 16,
+                    "Name": "running"
+                },
+                "OwnerId": "123412341234",
+                "Tags": [
+                    {
+                        "Key": "MyTagName",
+                        "Value": "my-tag-value"
+                    }
+                ],
+                "ImageMetadata": {
+                    "ImageId": "ami-0b752bf1df193a6c4",
+                    "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64",
+                    "OwnerId": "137112412989",
+                    "State": "available",
+                    "ImageOwnerAlias": "amazon",
+                    "CreationDate": "2023-01-25T17:20:40Z",
+                    "DeprecationTime": "2025-01-25T17:20:40Z",
+                    "IsPublic": true
+                }
+            }
+        ],
+        "NextToken": "...EXAMPLEwIAABAA2JHaFxLnEXAMPLE..."
+    }
+
+For more information, see `Amazon Machine Images in Amazon EC2 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.
+
+**Example 2: To describe the AMI metadata for the specified instances**
+
+The following ``describe-instance-image-metadata`` example describes the AMI metadata for the specified instances. ::
+
+    aws ec2 describe-instance-image-metadata \
+        --region us-east-1 \
+        --instance-ids i-1234567890EXAMPLE i-0987654321EXAMPLE
+
+Output::
+
+    {
+        "InstanceImageMetadata": [
+            {
+                "InstanceId": "i-1234567890EXAMPLE",
+                "InstanceType": "t2.micro",
+                "LaunchTime": "2024-08-28T11:25:45+00:00",
+                "AvailabilityZone": "us-east-1a",
+                "State": {
+                    "Code": 16,
+                    "Name": "running"
+                },
+                "OwnerId": "123412341234",
+                "Tags": [
+                    {
+                        "Key": "MyTagName",
+                        "Value": "my-tag-value"
+                    }
+                ],
+                "ImageMetadata": {
+                    "ImageId": "ami-0b752bf1df193a6c4",
+                    "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64",
+                    "OwnerId": "137112412989",
+                    "State": "available",
+                    "ImageOwnerAlias": "amazon",
+                    "CreationDate": "2023-01-25T17:20:40Z",
+                    "DeprecationTime": "2025-01-25T17:20:40Z",
+                    "IsPublic": true
+                }
+            },
+            {
+                "InstanceId": "i-0987654321EXAMPLE",
+                "InstanceType": "t2.micro",
+                "LaunchTime": "2024-08-28T11:25:45+00:00",
+                "AvailabilityZone": "us-east-1a",
+                "State": {
+                    "Code": 16,
+                    "Name": "running"
+                },
+                "OwnerId": "123412341234",
+                "Tags": [
+                    {
+                        "Key": "MyTagName",
+                        "Value": "my-tag-value"
+                    }
+                ],
+                "ImageMetadata": {
+                    "ImageId": "ami-0b752bf1df193a6c4",
+                    "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64",
+                    "OwnerId": "137112412989",
+                    "State": "available",
+                    "ImageOwnerAlias": "amazon",
+                    "CreationDate": "2023-01-25T17:20:40Z",
+                    "DeprecationTime": "2025-01-25T17:20:40Z",
+                    "IsPublic": true
+                }
+            }
+        ]
+    }
+
+For more information, see `Amazon Machine Images in Amazon EC2 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.
+
+**Example 3: To describe the AMI metadata for instances based on filters**
+
+The following ``describe-instance-image-metadata`` example describes the AMI metadata for ``t2.nano`` and ``t2.micro`` instances in the ``us-east-1a`` Availability Zone. ::
+
+    aws ec2 describe-instance-image-metadata \
+        --region us-east-1 \
+        --filters Name=availability-zone,Values=us-east-1a Name=instance-type,Values=t2.nano,t2.micro
+
+Output::
+
+    {
+        "InstanceImageMetadata": [
+            {
+                "InstanceId": "i-1234567890EXAMPLE",
+                "InstanceType": "t2.micro",
+                "LaunchTime": "2024-08-28T11:25:45+00:00",
+                "AvailabilityZone": "us-east-1a",
+                "State": {
+                    "Code": 16,
+                    "Name": "running"
+                },
+                "OwnerId": "123412341234",
+                "Tags": [
+                    {
+                        "Key": "MyTagName",
+                        "Value": "my-tag-value"
+                    }
+                ],
+                "ImageMetadata": {
+                    "ImageId": "ami-0b752bf1df193a6c4",
+                    "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64",
+                    "OwnerId": "137112412989",
+                    "State": "available",
+                    "ImageOwnerAlias": "amazon",
+                    "CreationDate": "2023-01-25T17:20:40Z",
+                    "DeprecationTime": "2025-01-25T17:20:40Z",
+                    "IsPublic": true
+                }
+            },
+            {
+                "InstanceId": "i-0987654321EXAMPLE",
+                "InstanceType": "t2.micro",
+                "LaunchTime": "2024-08-28T11:25:45+00:00",
+                "AvailabilityZone": "us-east-1a",
+                "State": {
+                    "Code": 16,
+                    "Name": "running"
+                },
+                "OwnerId": "123412341234",
+                "Tags": [
+                    {
+                        "Key": "MyTagName",
+                        "Value": "my-tag-value"
+                    }
+                ],
+                "ImageMetadata": {
+                    "ImageId": "ami-0b752bf1df193a6c4",
+                    "Name": "al2023-ami-2023.5.20240819.0-kernel-6.1-x86_64",
+                    "OwnerId": "137112412989",
+                    "State": "available",
+                    "ImageOwnerAlias": "amazon",
+                    "CreationDate": "2023-01-25T17:20:40Z",
+                    "DeprecationTime": "2025-01-25T17:20:40Z",
+                    "IsPublic": true
+                }
+            }
+        ],
+        "NextToken": "...EXAMPLEV7ixRYHwIAABAA2JHaFxLnDAzpatfEXAMPLE..."
+    }
+
+For more information, see `Amazon Machine Images in Amazon EC2 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.

awscli/examples/ec2/describe-spot-datafeed-subscription.rst

@@ -12,7 +12,7 @@ Output::
       "SpotDatafeedSubscription": {
           "OwnerId": "123456789012",
           "Prefix": "spotdata",
-          "Bucket": "my-s3-bucket",
+          "Bucket": "amzn-s3-demo-bucket",
           "State": "Active"
       }
   }

awscli/examples/ec2/register-image.rst

@@ -1,32 +1,32 @@
-**Example 1: To register an AMI using a manifest file**
-
-The following ``register-image`` example registers an AMI using the specified manifest file in Amazon S3. ::
-
-    aws ec2 register-image \
-        --name my-image \
-        --image-location my-s3-bucket/myimage/image.manifest.xml
-
-Output::
-
-    {
-        "ImageId": "ami-1234567890EXAMPLE"
-    }
-
-For more information, see `Amazon Machine Images (AMI) <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.
-
-**Example 2: To register an AMI using a snapshot of a root device**
-
-The following ``register-image`` example registers an AMI using the specified snapshot of an EBS root volume as device ``/dev/xvda``. The block device mapping also includes an empty 100 GiB EBS volume as device ``/dev/xvdf``. ::
-
-    aws ec2 register-image \
-        --name my-image \
-        --root-device-name /dev/xvda \
-        --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0db2cf683925d191f} DeviceName=/dev/xvdf,Ebs={VolumeSize=100}
-
-Output::
-
-    {
-        "ImageId": "ami-1a2b3c4d5eEXAMPLE"
-    }
-
-For more information, see `Amazon Machine Images (AMI) <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.
+**Example 1: To register an AMI using a manifest file**
+
+The following ``register-image`` example registers an AMI using the specified manifest file in Amazon S3. ::
+
+    aws ec2 register-image \
+        --name my-image \
+        --image-location amzn-s3-demo-bucket/myimage/image.manifest.xml
+
+Output::
+
+    {
+        "ImageId": "ami-1234567890EXAMPLE"
+    }
+
+For more information, see `Amazon Machine Images (AMI) <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.
+
+**Example 2: To register an AMI using a snapshot of a root device**
+
+The following ``register-image`` example registers an AMI using the specified snapshot of an EBS root volume as device ``/dev/xvda``. The block device mapping also includes an empty 100 GiB EBS volume as device ``/dev/xvdf``. ::
+
+    aws ec2 register-image \
+        --name my-image \
+        --root-device-name /dev/xvda \
+        --block-device-mappings DeviceName=/dev/xvda,Ebs={SnapshotId=snap-0db2cf683925d191f} DeviceName=/dev/xvdf,Ebs={VolumeSize=100}
+
+Output::
+
+    {
+        "ImageId": "ami-1a2b3c4d5eEXAMPLE"
+    }
+
+For more information, see `Amazon Machine Images (AMI) <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html>`__ in the *Amazon EC2 User Guide*.

awscli/examples/ecr-public/get-registry-catalog-data.rst

@@ -0,0 +1,14 @@
+**To retrieve catalog metadata for a public ECR registry**
+
+The following ``get-registry-catalog-data`` retrieves catalog metadata for an ECR public registry. ::
+
+    aws ecr-public get-registry-catalog-data \
+        --region us-east-1
+
+Output::
+
+    {
+        "registryCatalogData": {
+            "displayName": "YourCustomPublicRepositoryalias"
+        }
+    }

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

@@ -0,0 +1,29 @@
+**To retrieve catalog metadata for a repository in a public registry**
+
+The following ``get-repository-catalog-data`` example lists the catalog metadata for the repository ``project-a/nginx-web-app`` in a public registry. ::
+
+    aws ecr-public get-repository-catalog-data \
+        --repository-name project-a/nginx-web-app \
+        --region us-east-1
+
+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\n\nMaintained <truncated>",
+            "usageText": "## Supported architectures\n\namd64, arm64v8\n\n## <truncated>"
+        }
+    }
+
+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*.

awscli/examples/ecr-public/list-tags-for-resource.rst

@@ -0,0 +1,28 @@
+**To list tags for a public repository in a public registry**
+
+The following ``list-tags-for-resource`` example lists the tags for a resource named ``project-a/nginx-web-app`` in a public registry. ::
+
+    aws ecr-public list-tags-for-resource \
+        --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \
+        --region us-east-1
+
+Output::
+
+    {
+        "tags": [
+            {
+                "Key": "Environment",
+                "Value": "Prod"
+            },
+            {
+                "Key": "stack",
+                "Value": "dev1"
+            },
+            {
+                "Key": "Name",
+                "Value": "project-a/nginx-web-app"
+            }
+        ]
+    }
+
+For more information, see `List tags for a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html>`__ in the *Amazon ECR Public*.

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

@@ -0,0 +1,15 @@
+**To create or update catalog metadata for a public ECR registry**
+
+The following ``put-registry-catalog-data`` creates or updates catalog metadata for an ECR public registry. Only accounts that have the verified account badge can have a registry display name. ::
+
+    aws ecr-public put-registry-catalog-data \
+        --region us-east-1 \
+        --display-name <YourCustomPublicRepositoryalias>
+
+Output::
+
+    {
+        "registryCatalogData": {
+            "displayName": "YourCustomPublicRepositoryalias"
+        }
+    }

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

@@ -1,4 +1,4 @@
-**Example 1: To creates or updates the catalog data for a repository in a public registry.**
+**To create or update 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. ::
 
@@ -10,6 +10,7 @@ The following ``put-repository-catalog-data`` example creates or update catalog
 Contents of ``repository-catalog-data.json``::
 
     {
+        "repositoryName": "project-a/nginx-web-app",
         "catalogData": {
             "description": "My project-a ECR Public Repository",
             "architectures": [
@@ -21,9 +22,9 @@ Contents of ``repository-catalog-data.json``::
             "operatingSystems": [
                 "Linux"
             ],
-            "logoImageBlob": "iVBORw0KGgoAAAANSUhEUgAAAYYAAAGGCAMAAABIXtbXAAAAq1BMVEVHcEz// <abbreviated>",
+            "logoImageBlob": "iVBORw0KGgoA<<truncated-for-better-reading>>ErkJggg==",
             "aboutText": "## Quick reference.",
-            "usageText": "## Supported architectures are as follows"
+            "usageText": "## Supported architectures are as follows."
         }
     }
 
@@ -41,7 +42,7 @@ Output::
             "operatingSystems": [
                 "Linux"
             ],
-            "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/491d3846-8f33-4d8b-a10c-c2ce271e6c0d/4f09d87c-2569-4916-a932-5c296bf6f88a.png",
+            "logoUrl": "https://d3g9o9u8re44ak.cloudfront.net/logo/df86cf58-ee60-4061-b804-0be24d97ccb1/4a9ed9b2-69e4-4ede-b924-461462d20ef0.png",
             "aboutText": "## Quick reference.",
             "usageText": "## Supported architectures are as follows."
         }

awscli/examples/ecr-public/tag-resource.rst

@@ -0,0 +1,21 @@
+**Example 1: To tags an existing public repository in a public registry**
+
+The following ``tag-resource`` example tags a repository named ``project-a/nginx-web-app`` in a public registry. ::
+
+    aws ecr-public tag-resource \
+        --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \
+        --tags Key=stack,Value=dev \
+        --region us-east-1
+
+For more information, see `Using Tags for a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html>`__ in the *Amazon ECR Public*.
+
+**Example 2: To tag an existing public repository with multiple tags in a public registry.**
+
+The following ``tag-resource`` example tags an existing repository with multiple tags. ::
+
+    aws ecr-public tag-resource \
+        --resource-arn arn:aws:ecr-public::890517186334:repository/project-a/nginx-web-app  \
+        --tags Key=key1,Value=value1 Key=key2,Value=value2 Key=key3,Value=value3 \
+        --region us-east-1
+
+For more information, see `Using Tags for a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html>`__ in the *Amazon ECR Public*.

awscli/examples/ecr-public/untag-resource.rst

@@ -0,0 +1,12 @@
+**Example 1: To untags an existing public repository in a public registry**
+
+The following ``untag-resource`` example tags a repository named ``project-a/nginx-web-app`` in a public registry. ::
+
+    aws ecr-public untag-resource \
+        --resource-arn arn:aws:ecr-public::123456789012:repository/project-a/nginx-web-app \
+        --tag-keys stack \
+        --region us-east-1
+
+This command produces no output.
+
+For more information, see `Using Tags for a public repository <https://docs.aws.amazon.com/AmazonECR/latest/public/ecr-public-using-tags.html>`__ in the *Amazon ECR Public*.

awscli/examples/ecs/describe-service-deployments.rst

@@ -0,0 +1,54 @@
+**To describe service deployment details**
+
+The following ``describe-service-deployments`` example returns the service deployment details for the service deployment with the ARN ``arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe``. ::
+
+    aws ecs describe-service-deployments \
+        --service-deployment-arn arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe
+
+Output::
+
+    {
+        "serviceDeployments": [
+            {
+                "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/example-cluster/example-service/ejGvqq2ilnbKT9qj0vLJe",
+                "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service",
+                "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster",
+                "createdAt": "2024-10-31T08:03:30.917000-04:00",
+                "startedAt": "2024-10-31T08:03:32.510000-04:00",
+                "finishedAt": "2024-10-31T08:05:04.527000-04:00",
+                "updatedAt": "2024-10-31T08:05:04.527000-04:00",
+                "sourceServiceRevisions": [],
+                "targetServiceRevision": {
+                    "arn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678",
+                    "requestedTaskCount": 1,
+                    "runningTaskCount": 1,
+                    "pendingTaskCount": 0
+                },
+                "status": "SUCCESSFUL",
+                "deploymentConfiguration": {
+                    "deploymentCircuitBreaker": {
+                        "enable": true,
+                        "rollback": true
+                    },
+                    "maximumPercent": 200,
+                    "minimumHealthyPercent": 100,
+                    "alarms": {
+                        "alarmNames": [],
+                        "rollback": false,
+                        "enable": false
+                    }
+                },
+                "deploymentCircuitBreaker": {
+                    "status": "MONITORING_COMPLETE",
+                    "failureCount": 0,
+                    "threshold": 3
+                },
+                "alarms": {
+                    "status": "DISABLED"
+                }
+            }
+        ],
+        "failures": []
+    }
+
+For more information, see `View service history using Amazon ECS service deployments <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-deployment.html>`_ in the *Amazon ECS Developer Guide*.

awscli/examples/ecs/describe-service-revisions.rst

@@ -0,0 +1,60 @@
+**To describe service revision details**
+
+The following ``describe-service-revisions`` example returns the service revision details for the service revision with the ARN ``arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678``. ::
+
+    aws ecs describe-service-revisions \
+        --service-revision-arns arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678
+
+Output::
+
+    {
+        "serviceRevisions": [
+            {
+                "serviceRevisionArn": "arn:aws:ecs:us-east-1:123456789012:service-revision/example-cluster/example-service/1485800978477494678",
+                "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/example-cluster/example-service",
+                "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/example-cluster",
+                "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/webserver:5",
+                "capacityProviderStrategy": [
+                    {
+                        "capacityProvider": "FARGATE",
+                        "weight": 1,
+                        "base": 0
+                    }
+                ],
+                "platformVersion": "1.4.0",
+                "platformFamily": "Linux",
+                "networkConfiguration": {
+                    "awsvpcConfiguration": {
+                        "subnets": [
+                            "subnet-0d0eab1bb38d5ca64",
+                            "subnet-0db5010045995c2d5"
+                        ],
+                        "securityGroups": [
+                            "sg-02556bf85a191f59a"
+                        ],
+                        "assignPublicIp": "ENABLED"
+                    }
+                },
+                "containerImages": [
+                    {
+                        "containerName": "aws-otel-collector",
+                        "imageDigest": "sha256:7a1b3560655071bcacd66902c20ebe9a69470d5691fe3bd36baace7c2f3c4640",
+                        "image": "public.ecr.aws/aws-observability/aws-otel-collector:v0.32.0"
+                    },
+                    {
+                        "containerName": "web",
+                        "imageDigest": "sha256:28402db69fec7c17e179ea87882667f1e054391138f77ffaf0c3eb388efc3ffb",
+                        "image": "nginx"
+                    }
+                ],
+                "guardDutyEnabled": false,
+                "serviceConnectConfiguration": {
+                    "enabled": false
+                },
+                "createdAt": "2024-10-31T08:03:29.302000-04:00"
+            }
+        ],
+        "failures": []
+    }
+
+For more information, see `Amazon ECS service revisions <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-revision.html>`_ in the *Amazon ECS Developer Guide*.