awscli 1.38.7__py3-none-any.whl → 1.38.9__py3-none-any.whl

awscli/examples/ecs/put-account-setting.rst

@@ -1,16 +1,19 @@
 **To modify the account setting for your IAM user account**
 
-The following ``put-account-setting`` example enables the ``serviceLongArnFormat`` account setting for your IAM user account. ::
+The following ``put-account-setting`` example sets the ``containerInsights`` account setting to ``enhanced`` for your IAM user account. This turns on Container Insights with enhanced observability. ::
 
-    aws ecs put-account-setting --name serviceLongArnFormat --value enabled
+    aws ecs put-account-setting \
+        --name containerInsights \
+        --value enhanced
 
 Output::
 
     {
         "setting": {
-            "name": "serviceLongArnFormat",
-            "value": "enabled",
-            "principalArn": "arn:aws:iam::130757420319:user/your_username"
+            "name": "containerInsights",
+            "value": "enhanced",
+            "principalArn": "arn:aws:iam::123456789012:user/johndoe",
+            "type": "user"
         }
     }
 

awscli/examples/ecs/update-cluster-settings.rst

@@ -1,16 +1,16 @@
 **To modify the settings for your cluster**
 
-The following ``update-cluster-settings`` example enables CloudWatch Container Insights for the ``default`` cluster. ::
+The following ``update-cluster-settings`` example enables CloudWatch Container Insights with enhanced observability for the ``MyCluster`` cluster. ::
 
     aws ecs update-cluster-settings \
-        --cluster default \
-        --settings name=containerInsights,value=enabled
+        --cluster MyCluster \
+        --settings name=containerInsights,value=enhanced
 
 Output::
 
     {
         "cluster": {
-            "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster",
+            "clusterArn": "arn:aws:ecs:us-esat-1:123456789012:cluster/MyCluster",
             "clusterName": "default",
             "status": "ACTIVE",
             "registeredContainerInstancesCount": 0,
@@ -22,10 +22,10 @@ Output::
             "settings": [
                 {
                     "name": "containerInsights",
-                    "value": "enabled"
+                    "value": "enhanced"
                 }
             ]
         }
     }
 
-For more information, see `Modifying Account Settings <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-modifying-longer-id-settings.html>`__ in the *Amazon ECS Developer Guide*.
+For more information, see `Modifying Account Settings <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-modifying-longer-id-settings.html>`__ in the *Amazon ECS Developer Guide*.

awscli/examples/ecs/update-service.rst

@@ -1,13 +1,241 @@
-**Example 1: To change the task definition used in a service**
+**Example 1: To change the number of instantiations in a service**
 
-The following ``update-service`` example updates the ``my-http-service`` service to use the ``amazon-ecs-sample`` task definition. ::
+The following ``update-service`` example updates the desired task count of the service ``my-http-service`` to 2. ::
 
-    aws ecs update-service --service my-http-service --task-definition amazon-ecs-sample
+    aws ecs update-service \
+       --cluster MyCluster
+       --service my-http-service \
+       --desired-count 2
 
-**Example 2: To change the number of tasks in a service**
+Output::
 
-The following ``update-service`` example updates the desired task count of the service ``my-http-service`` to 3. ::
+    {
+        "service": {
+            "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/MyCluster/my-http-service",
+            "serviceName": "my-http-service",
+            "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster",
+            "loadBalancers": [],
+            "serviceRegistries": [],
+            "status": "ACTIVE",
+            "desiredCount": 2,
+            "runningCount": 1,
+            "pendingCount": 0,
+            "capacityProviderStrategy": [
+                {
+                    "capacityProvider": "FARGATE",
+                    "weight": 1,
+                    "base": 0
+                }
+            ],
+            "platformVersion": "LATEST",
+            "platformFamily": "Linux",
+            "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition",
+            "deploymentConfiguration": {
+                "deploymentCircuitBreaker": {
+                    "enable": true,
+                    "rollback": true
+                },
+                "maximumPercent": 200,
+                "minimumHealthyPercent": 100,
+                "alarms": {
+                    "alarmNames": [],
+                    "rollback": false,
+                    "enable": false
+                }
+            },
+            "deployments": [
+                {
+                    "id": "ecs-svc/1976744184940610707",
+                    "status": "PRIMARY",
+                    "taskkDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition",
+                    "desiredCount": 1,
+                    "pendingCount": 0,
+                    "runningCount": 1,
+                    "failedTasks": 0,
+                    "createdAt": "2024-12-03T16:24:25.225000-05:00",
+                    "updatedAt": "2024-12-03T16:25:15.837000-05:00",
+                    "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"
+                        }
+                    },
+                    "rolloutState": "COMPLETED",
+                    "rolloutStateReason": "ECS deployment ecs-svc/1976744184940610707 completed."
+                }
+            ],
+            "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
+            "events": [
+                {
+                    "id": "f27350b9-4b2a-4e2e-b72e-a4b68380de45",
+                    "createdAt": "2024-12-30T13:24:07.345000-05:00",
+                    "message": "(service my-http-service) has reached a steady state."
+                },
+                {
+                    "id": "e764ec63-f53f-45e3-9af2-d99f922d2957",
+                    "createdAt": "2024-12-30T12:32:21.600000-05:00",
+                    "message": "(service my-http-service) has reached a steady state."
+                },          
+                {
+                    "id": "28444756-c2fa-47f8-bd60-93a8e05f3991",
+                    "createdAt": "2024-12-08T19:26:10.367000-05:00",
+                    "message": "(service my-http-service) has reached a steady state."
+                }
+            ],
+            "createdAt": "2024-12-03T16:24:25.225000-05:00",
+            "placementConstraints": [],
+            "placementStrategy": [],
+            "networkConfiguration": {
+                "awsvpcConfiguration": {
+                    "subnets": [
+                        "subnet-0d0eab1bb38d5ca64",
+                        "subnet-0db5010045995c2d5"
+                    ],
+                    "securityGroups": [
+                        "sg-02556bf85a191f59a"
+                    ],
+                    "assignPublicIp": "ENABLED"
+                }
+            },
+            "healthCheckGracePeriodSeconds": 0,
+            "schedulingStrategy": "REPLICA",
+            "deploymentController": {
+                "type": "ECS"
+            },
+            "createdBy": "arn:aws:iam::123456789012:role/Admin",
+            "enableECSManagedTags": true,
+            "propagateTags": "NONE",
+            "enableExecuteCommand": false,
+            "availabilityZoneRebalancing": "ENABLED"
+        }
+    }
 
-    aws ecs update-service --service my-http-service --desired-count 3
+For more information, see `Updating an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.
 
-For more information, see `Updating a Service <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service.html>`_ in the *Amazon ECS Developer Guide*.
+**Example 2: To turn on Availability Zone rebalancing for a service**
+
+The following ``update-service`` example turns on Availability Zone rebalancing for the service ``my-http-service``. ::
+
+    aws ecs update-service \
+        --cluster MyCluster \
+        --service my-http-service \
+        --availability-zone-rebalancing ENABLED
+
+Output::
+
+    {
+        "service": {
+            "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/MyCluster/my-http-service",
+            "serviceName": "my-http-service",
+            "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster",
+            "loadBalancers": [],
+            "serviceRegistries": [],
+            "status": "ACTIVE",
+            "desiredCount": 2,
+            "runningCount": 1,
+            "pendingCount": 0,
+            "capacityProviderStrategy": [
+                {
+                    "capacityProvider": "FARGATE",
+                    "weight": 1,
+                    "base": 0
+                }
+            ],
+            "platformVersion": "LATEST",
+            "platformFamily": "Linux",
+            "taskDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition",
+            "deploymentConfiguration": {
+                "deploymentCircuitBreaker": {
+                    "enable": true,
+                    "rollback": true
+                },
+                "maximumPercent": 200,
+                "minimumHealthyPercent": 100,
+                "alarms": {
+                    "alarmNames": [],
+                    "rollback": false,
+                    "enable": false
+                }
+            },
+            "deployments": [
+                {
+                    "id": "ecs-svc/1976744184940610707",
+                    "status": "PRIMARY",
+                    "taskkDefinition": "arn:aws:ecs:us-east-1:123456789012:task-definition/MyTaskDefinition",
+                    "desiredCount": 1,
+                    "pendingCount": 0,
+                    "runningCount": 1,
+                    "failedTasks": 0,
+                    "createdAt": "2024-12-03T16:24:25.225000-05:00",
+                    "updatedAt": "2024-12-03T16:25:15.837000-05:00",
+                    "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"
+                        }
+                    },
+                    "rolloutState": "COMPLETED",
+                    "rolloutStateReason": "ECS deployment ecs-svc/1976744184940610707 completed."
+                }
+            ],
+            "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/ecs.amazonaws.com/AWSServiceRoleForECS",
+            "events": [],
+            "createdAt": "2024-12-03T16:24:25.225000-05:00",
+            "placementConstraints": [],
+            "placementStrategy": [],
+            "networkConfiguration": {
+                "awsvpcConfiguration": {
+                    "subnets": [
+                        "subnet-0d0eab1bb38d5ca64",
+                        "subnet-0db5010045995c2d5"
+                    ],
+                    "securityGroups": [
+                        "sg-02556bf85a191f59a"
+                    ],
+                    "assignPublicIp": "ENABLED"
+                }
+            },
+            "healthCheckGracePeriodSeconds": 0,
+            "schedulingStrategy": "REPLICA",
+            "deploymentController": {
+                "type": "ECS"
+            },
+            "createdBy": "arn:aws:iam::123456789012:role/Admin",
+            "enableECSManagedTags": true,
+            "propagateTags": "NONE",
+            "enableExecuteCommand": false,
+            "availabilityZoneRebalancing": "ENABLED"
+        }
+    }
+
+For more information, see `Updating an Amazon ECS service using the console <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/update-service-console-v2.html>`__ in the *Amazon ECS Developer Guide*.

awscli/examples/emr/add-steps.rst

@@ -2,7 +2,7 @@
 
 - Command::
 
-    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://mybucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://mybucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3
+    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,Args=arg1,arg2,arg3 Type=CUSTOM_JAR,Name=CustomJAR,ActionOnFailure=CONTINUE,Jar=s3://amzn-s3-demo-bucket/mytest.jar,MainClass=mymainclass,Args=arg1,arg2,arg3
 
 - Required parameters::
 
@@ -25,7 +25,7 @@
 
 - Command::
 
-    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://mybucket/wordcount/output]
+    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://amzn-s3-demo-bucket/wordcount/output]
 
 - Required parameters::
 
@@ -40,7 +40,7 @@
     [
      {
        "Name": "JSON Streaming Step",
-       "Args": ["-files","s3://elasticmapreduce/samples/wordcount/wordSplitter.py","-mapper","wordSplitter.py","-reducer","aggregate","-input","s3://elasticmapreduce/samples/wordcount/input","-output","s3://mybucket/wordcount/output"],
+       "Args": ["-files","s3://elasticmapreduce/samples/wordcount/wordSplitter.py","-mapper","wordSplitter.py","-reducer","aggregate","-input","s3://elasticmapreduce/samples/wordcount/input","-output","s3://amzn-s3-demo-bucket/wordcount/output"],
        "ActionOnFailure": "CONTINUE",
        "Type": "STREAMING"
      }
@@ -72,15 +72,15 @@ NOTE: JSON arguments must include options and values as their own items in the l
         "ActionOnFailure": "CONTINUE",
         "Args": [
             "-files",
-            "s3://mybucket/mapper.py,s3://mybucket/reducer.py",
+            "s3://amzn-s3-demo-bucket/mapper.py,s3://amzn-s3-demo-bucket/reducer.py",
             "-mapper",
             "mapper.py",
             "-reducer",
             "reducer.py",
             "-input",
-            "s3://mybucket/input",
+            "s3://amzn-s3-demo-bucket/input",
             "-output",
-            "s3://mybucket/output"]
+            "s3://amzn-s3-demo-bucket/output"]
      }
    ]
 
@@ -109,7 +109,7 @@ NOTE: JSON arguments must include options and values as their own items in the l
 
 - Command::
 
-    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,Args=[-f,s3://mybucket/myhivescript.q,-d,INPUT=s3://mybucket/myhiveinput,-d,OUTPUT=s3://mybucket/myhiveoutput,arg1,arg2] Type=HIVE,Name='Hive steps',ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://mybucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs]
+    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,Args=[-f,s3://amzn-s3-demo-bucket/myhivescript.q,-d,INPUT=s3://amzn-s3-demo-bucket/myhiveinput,-d,OUTPUT=s3://amzn-s3-demo-bucket/myhiveoutput,arg1,arg2] Type=HIVE,Name='Hive steps',ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://amzn-s3-demo-bucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs]
 
 
 - Required parameters::
@@ -134,7 +134,7 @@ NOTE: JSON arguments must include options and values as their own items in the l
 
 - Command::
 
-    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://mybucket/mypigscript.pig,-p,INPUT=s3://mybucket/mypiginput,-p,OUTPUT=s3://mybucket/mypigoutput,arg1,arg2] Type=PIG,Name='Pig program',Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://mybucket/pig-apache/output,arg1,arg2]
+    aws emr add-steps --cluster-id j-XXXXXXXX --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://amzn-s3-demo-bucket/mypigscript.pig,-p,INPUT=s3://amzn-s3-demo-bucket/mypiginput,-p,OUTPUT=s3://amzn-s3-demo-bucket/mypigoutput,arg1,arg2] Type=PIG,Name='Pig program',Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://amzn-s3-demo-bucket/pig-apache/output,arg1,arg2]
 
 
 - Required parameters::

awscli/examples/emr/create-cluster-examples.rst

@@ -369,7 +369,7 @@ The following ``create-cluster`` examples add a streaming step to a cluster that
 The following example specifies the step inline. ::
 
     aws emr create-cluster \
-        --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://mybucket/wordcount/output] \
+        --steps Type=STREAMING,Name='Streaming Program',ActionOnFailure=CONTINUE,Args=[-files,s3://elasticmapreduce/samples/wordcount/wordSplitter.py,-mapper,wordSplitter.py,-reducer,aggregate,-input,s3://elasticmapreduce/samples/wordcount/input,-output,s3://amzn-s3-demo-bucket/wordcount/output] \
         --release-label emr-5.3.1 \
         --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \
         --auto-terminate
@@ -397,7 +397,7 @@ Contents of ``multiplefiles.json``::
                 "-input",
                 "s3://elasticmapreduce/samples/wordcount/input",
                 "-output",
-                "s3://mybucket/wordcount/output"
+                "s3://amzn-s3-demo-bucket/wordcount/output"
             ],
             "ActionOnFailure": "CONTINUE",
             "Type": "STREAMING"
@@ -409,7 +409,7 @@ Contents of ``multiplefiles.json``::
 The following example add Hive steps when creating a cluster. Hive steps require parameters ``Type`` and ``Args``. Hive steps optional parameters are ``Name`` and ``ActionOnFailure``. ::
 
     aws emr create-cluster \
-        --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://mybucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] \
+        --steps Type=HIVE,Name='Hive program',ActionOnFailure=CONTINUE,ActionOnFailure=TERMINATE_CLUSTER,Args=[-f,s3://elasticmapreduce/samples/hive-ads/libs/model-build.q,-d,INPUT=s3://elasticmapreduce/samples/hive-ads/tables,-d,OUTPUT=s3://amzn-s3-demo-bucket/hive-ads/output/2014-04-18/11-07-32,-d,LIBS=s3://elasticmapreduce/samples/hive-ads/libs] \
         --applications Name=Hive \
         --release-label emr-5.3.1 \
         --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large
@@ -419,7 +419,7 @@ The following example add Hive steps when creating a cluster. Hive steps require
 The following example adds Pig steps when creating a cluster. Pig steps required parameters are ``Type`` and ``Args``. Pig steps optional parameters are ``Name`` and ``ActionOnFailure``. ::
 
     aws emr create-cluster \
-        --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://mybucket/pig-apache/output] \
+        --steps Type=PIG,Name='Pig program',ActionOnFailure=CONTINUE,Args=[-f,s3://elasticmapreduce/samples/pig-apache/do-reports2.pig,-p,INPUT=s3://elasticmapreduce/samples/pig-apache/input,-p,OUTPUT=s3://amzn-s3-demo-bucket/pig-apache/output] \
         --applications Name=Pig \
         --release-label emr-5.3.1 \
         --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large
@@ -429,7 +429,7 @@ The following example adds Pig steps when creating a cluster. Pig steps required
 The following ``create-cluster`` example runs two bootstrap actions defined as scripts that are stored in Amazon S3. ::
 
     aws emr create-cluster \
-        --bootstrap-actions Path=s3://mybucket/myscript1,Name=BootstrapAction1,Args=[arg1,arg2] Path=s3://mybucket/myscript2,Name=BootstrapAction2,Args=[arg1,arg2] \
+        --bootstrap-actions Path=s3://amzn-s3-demo-bucket/myscript1,Name=BootstrapAction1,Args=[arg1,arg2] Path=s3://amzn-s3-demo-bucket/myscript2,Name=BootstrapAction2,Args=[arg1,arg2] \
         --release-label emr-5.3.1 \
         --instance-groups InstanceGroupType=MASTER,InstanceCount=1,InstanceType=m4.large InstanceGroupType=CORE,InstanceCount=2,InstanceType=m4.large \
         --auto-terminate

awscli/examples/rds/cancel-export-task.rst

@@ -1,23 +1,23 @@
-**To cancel a snapshot export to Amazon S3**
-
-The following ``cancel-export-task`` example cancels an export task in progress that is exporting a snapshot to Amazon S3. ::
-
-    aws rds cancel-export-task \
-        --export-task-identifier my-s3-export-1
-
-Output::
-
-    {
-        "ExportTaskIdentifier": "my-s3-export-1",
-        "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:publisher-final-snapshot",
-        "SnapshotTime": "2019-03-24T20:01:09.815Z",
-        "S3Bucket": "mybucket",
-        "S3Prefix": "",
-        "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/export-snap-S3-role",
-        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abcd0000-7bfd-4594-af38-aabbccddeeff",
-        "Status": "CANCELING",
-        "PercentProgress": 0,
-        "TotalExtractedDataInGB": 0
-    }
-
+**To cancel a snapshot export to Amazon S3**
+
+The following ``cancel-export-task`` example cancels an export task in progress that is exporting a snapshot to Amazon S3. ::
+
+    aws rds cancel-export-task \
+        --export-task-identifier my-s3-export-1
+
+Output::
+
+    {
+        "ExportTaskIdentifier": "my-s3-export-1",
+        "SourceArn": "arn:aws:rds:us-east-1:123456789012:snapshot:publisher-final-snapshot",
+        "SnapshotTime": "2019-03-24T20:01:09.815Z",
+        "S3Bucket": "amzn-s3-demo-bucket",
+        "S3Prefix": "",
+        "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/export-snap-S3-role",
+        "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/abcd0000-7bfd-4594-af38-aabbccddeeff",
+        "Status": "CANCELING",
+        "PercentProgress": 0,
+        "TotalExtractedDataInGB": 0
+    }
+
 For more information, see `Canceling a snapshot export task <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling>`__ in the *Amazon RDS User Guide* or `Canceling a snapshot export task <https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Canceling>`__ in the *Amazon Aurora User Guide*.

awscli/examples/rds/describe-export-tasks.rst

@@ -1,40 +1,40 @@
-**To describe snapshot export tasks**
-
-The following ``describe-export-tasks`` example returns information about snapshot exports to Amazon S3. ::
-
-    aws rds describe-export-tasks
-
-Output::
-
-    {
-        "ExportTasks": [
-            {
-                "ExportTaskIdentifier": "test-snapshot-export",
-                "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:test-snapshot",
-                "SnapshotTime": "2020-03-02T18:26:28.163Z",
-                "TaskStartTime": "2020-03-02T18:57:56.896Z",
-                "TaskEndTime": "2020-03-02T19:10:31.985Z",
-                "S3Bucket": "mybucket",
-                "S3Prefix": "",
-                "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
-                "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
-                "Status": "COMPLETE",
-                "PercentProgress": 100,
-                "TotalExtractedDataInGB": 0
-            },
-            {
-                "ExportTaskIdentifier": "my-s3-export",
-                "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
-                "SnapshotTime": "2020-03-27T20:48:42.023Z",
-                "S3Bucket": "mybucket",
-                "S3Prefix": "",
-                "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
-                "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
-                "Status": "STARTING",
-                "PercentProgress": 0,
-                "TotalExtractedDataInGB": 0
-            }
-        ]
-    }
-
-For more information, see `Monitoring Snapshot Exports <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Monitoring>`__ in the *Amazon RDS User Guide*.
+**To describe snapshot export tasks**
+
+The following ``describe-export-tasks`` example returns information about snapshot exports to Amazon S3. ::
+
+    aws rds describe-export-tasks
+
+Output::
+
+    {
+        "ExportTasks": [
+            {
+                "ExportTaskIdentifier": "test-snapshot-export",
+                "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:test-snapshot",
+                "SnapshotTime": "2020-03-02T18:26:28.163Z",
+                "TaskStartTime": "2020-03-02T18:57:56.896Z",
+                "TaskEndTime": "2020-03-02T19:10:31.985Z",
+                "S3Bucket": "amzn-s3-demo-bucket",
+                "S3Prefix": "",
+                "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
+                "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
+                "Status": "COMPLETE",
+                "PercentProgress": 100,
+                "TotalExtractedDataInGB": 0
+            },
+            {
+                "ExportTaskIdentifier": "my-s3-export",
+                "SourceArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-test",
+                "SnapshotTime": "2020-03-27T20:48:42.023Z",
+                "S3Bucket": "amzn-s3-demo-bucket",
+                "S3Prefix": "",
+                "IamRoleArn": "arn:aws:iam::123456789012:role/service-role/ExportRole",
+                "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/abcd0000-7fca-4128-82f2-aabbccddeeff",
+                "Status": "STARTING",
+                "PercentProgress": 0,
+                "TotalExtractedDataInGB": 0
+            }
+        ]
+    }
+
+For more information, see `Monitoring Snapshot Exports <https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.html#USER_ExportSnapshot.Monitoring>`__ in the *Amazon RDS User Guide*.