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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of awscli might be problematic. Click here for more details.

Files changed (64) hide show
  1. awscli/__init__.py +1 -1
  2. awscli/examples/cloudfront/create-distribution-with-tags.rst +9 -13
  3. awscli/examples/cloudfront/get-distribution.rst +6 -10
  4. awscli/examples/cloudtrail/put-event-selectors.rst +2 -2
  5. awscli/examples/deploy/batch-get-deployments.rst +2 -2
  6. awscli/examples/deploy/create-deployment.rst +1 -1
  7. awscli/examples/deploy/get-application-revision.rst +2 -2
  8. awscli/examples/deploy/get-deployment.rst +1 -1
  9. awscli/examples/deploy/list-application-revisions.rst +3 -3
  10. awscli/examples/deploy/push.rst +2 -2
  11. awscli/examples/deploy/register-application-revision.rst +1 -1
  12. awscli/examples/ec2/accept-address-transfer.rst +1 -1
  13. awscli/examples/ec2/allocate-hosts.rst +55 -55
  14. awscli/examples/ec2/associate-address.rst +44 -35
  15. awscli/examples/ec2/authorize-security-group-egress.rst +56 -23
  16. awscli/examples/ec2/authorize-security-group-ingress.rst +15 -15
  17. awscli/examples/ec2/cancel-capacity-reservation.rst +14 -14
  18. awscli/examples/ec2/cancel-spot-fleet-requests.rst +43 -46
  19. awscli/examples/ec2/copy-snapshot.rst +2 -4
  20. awscli/examples/ec2/create-capacity-reservation.rst +95 -95
  21. awscli/examples/ec2/create-replace-root-volume-task.rst +1 -3
  22. awscli/examples/ec2/create-restore-image-task.rst +2 -2
  23. awscli/examples/ec2/create-spot-datafeed-subscription.rst +1 -1
  24. awscli/examples/ec2/create-tags.rst +43 -43
  25. awscli/examples/ec2/create-traffic-mirror-filter-rule.rst +32 -32
  26. awscli/examples/ec2/create-traffic-mirror-filter.rst +22 -12
  27. awscli/examples/ec2/create-traffic-mirror-session.rst +31 -31
  28. awscli/examples/ec2/create-traffic-mirror-target.rst +45 -35
  29. awscli/examples/ec2/create-transit-gateway-prefix-list-reference.rst +27 -27
  30. awscli/examples/ec2/create-verified-access-endpoint.rst +1 -1
  31. awscli/examples/ec2/create-vpc-endpoint-service-configuration.rst +67 -65
  32. awscli/examples/ec2/create-vpc-endpoint.rst +4 -4
  33. awscli/examples/ec2/describe-vpc-endpoint-service-configurations.rst +62 -62
  34. awscli/examples/ec2/describe-vpc-endpoint-services.rst +132 -134
  35. awscli/examples/ec2/describe-vpc-endpoints.rst +89 -89
  36. awscli/examples/eks/describe-cluster.rst +1 -1
  37. awscli/examples/emr/create-cluster-examples.rst +4 -4
  38. awscli/examples/emr/schedule-hbase-backup.rst +23 -23
  39. awscli/examples/importexport/create-job.rst +2 -2
  40. awscli/examples/importexport/get-shipping-label.rst +1 -1
  41. awscli/examples/importexport/get-status.rst +1 -1
  42. awscli/examples/rds/download-db-log-file-portion.rst +7 -3
  43. awscli/examples/resourcegroupstaggingapi/untag-resources.rst +1 -1
  44. awscli/examples/s3/cp.rst +7 -7
  45. awscli/examples/s3/ls.rst +2 -2
  46. awscli/examples/s3/mv.rst +5 -5
  47. awscli/examples/s3/sync.rst +5 -5
  48. awscli/examples/securitylake/create-subscriber.rst +83 -0
  49. {awscli-1.37.2.dist-info → awscli-1.37.4.dist-info}/METADATA +2 -2
  50. {awscli-1.37.2.dist-info → awscli-1.37.4.dist-info}/RECORD +62 -63
  51. awscli/examples/securitylake/create-subscriber-data-access.rst +0 -41
  52. awscli/examples/securitylake/create-subscriber-query-access.rst +0 -41
  53. /awscli/examples/securitylake/{create-aws-logsource.rst → create-aws-log-source.rst} +0 -0
  54. /awscli/examples/securitylake/{create-custom-logsource.rst → create-custom-log-source.rst} +0 -0
  55. /awscli/examples/securitylake/{delete-aws-logsource.rst → delete-aws-log-source.rst} +0 -0
  56. /awscli/examples/securitylake/{delete-custom-logsource.rst → delete-custom-log-source.rst} +0 -0
  57. {awscli-1.37.2.data → awscli-1.37.4.data}/scripts/aws +0 -0
  58. {awscli-1.37.2.data → awscli-1.37.4.data}/scripts/aws.cmd +0 -0
  59. {awscli-1.37.2.data → awscli-1.37.4.data}/scripts/aws_bash_completer +0 -0
  60. {awscli-1.37.2.data → awscli-1.37.4.data}/scripts/aws_completer +0 -0
  61. {awscli-1.37.2.data → awscli-1.37.4.data}/scripts/aws_zsh_completer.sh +0 -0
  62. {awscli-1.37.2.dist-info → awscli-1.37.4.dist-info}/LICENSE.txt +0 -0
  63. {awscli-1.37.2.dist-info → awscli-1.37.4.dist-info}/WHEEL +0 -0
  64. {awscli-1.37.2.dist-info → awscli-1.37.4.dist-info}/top_level.txt +0 -0
@@ -1,46 +1,43 @@
1
- **Example 1: To cancel a Spot fleet request and terminate the associated instances**
2
-
3
- The following ``cancel-spot-fleet-requests`` example cancels a Spot Fleet request and terminates the associated On-Demand Instances and Spot Instances. ::
4
-
5
- aws ec2 cancel-spot-fleet-requests \
6
- --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
7
- --terminate-instances
8
-
9
- Output::
10
-
11
- {
12
- "SuccessfulFleetRequests": [
13
- {
14
- "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
15
- "CurrentSpotFleetRequestState": "cancelled_terminating",
16
- "PreviousSpotFleetRequestState": "active"
17
- }
18
- ],
19
- "UnsuccessfulFleetRequests": []
20
- }
21
-
22
- For more information, see `Cancel a Spot Fleet request <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-spot-fleets.html#cancel-spot-fleet>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
23
-
24
-
25
- **Example 2: To cancel a Spot fleet request without terminating the associated instances**
26
-
27
- The following ``cancel-spot-fleet-requests`` example cancels a Spot Fleet request without terminating the associated On-Demand Instances and Spot Instances. ::
28
-
29
- aws ec2 cancel-spot-fleet-requests \
30
- --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
31
- --no-terminate-instances
32
-
33
- Output::
34
-
35
- {
36
- "SuccessfulFleetRequests": [
37
- {
38
- "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
39
- "CurrentSpotFleetRequestState": "cancelled_running",
40
- "PreviousSpotFleetRequestState": "active"
41
- }
42
- ],
43
- "UnsuccessfulFleetRequests": []
44
- }
45
-
46
- For more information, see `Cancel a Spot Fleet request <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/work-with-spot-fleets.html#cancel-spot-fleet>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
1
+ **Example 1: To cancel a Spot fleet request and terminate the associated instances**
2
+
3
+ The following ``cancel-spot-fleet-requests`` example cancels a Spot Fleet request and terminates the associated On-Demand Instances and Spot Instances. ::
4
+
5
+ aws ec2 cancel-spot-fleet-requests \
6
+ --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
7
+ --terminate-instances
8
+
9
+ Output::
10
+
11
+ {
12
+ "SuccessfulFleetRequests": [
13
+ {
14
+ "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
15
+ "CurrentSpotFleetRequestState": "cancelled_terminating",
16
+ "PreviousSpotFleetRequestState": "active"
17
+ }
18
+ ],
19
+ "UnsuccessfulFleetRequests": []
20
+ }
21
+
22
+ **Example 2: To cancel a Spot fleet request without terminating the associated instances**
23
+
24
+ The following ``cancel-spot-fleet-requests`` example cancels a Spot Fleet request without terminating the associated On-Demand Instances and Spot Instances. ::
25
+
26
+ aws ec2 cancel-spot-fleet-requests \
27
+ --spot-fleet-request-ids sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE \
28
+ --no-terminate-instances
29
+
30
+ Output::
31
+
32
+ {
33
+ "SuccessfulFleetRequests": [
34
+ {
35
+ "SpotFleetRequestId": "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
36
+ "CurrentSpotFleetRequestState": "cancelled_running",
37
+ "PreviousSpotFleetRequestState": "active"
38
+ }
39
+ ],
40
+ "UnsuccessfulFleetRequests": []
41
+ }
42
+
43
+ For more information, see `Cancel a Spot Fleet request <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/cancel-spot-fleet.html>`__ in the *Amazon EC2 User Guide*.
@@ -6,7 +6,7 @@ The following ``copy-snapshot`` example command copies the specified snapshot fr
6
6
  --region us-east-1 \
7
7
  --source-region us-west-2 \
8
8
  --source-snapshot-id snap-066877671789bd71b \
9
- --description "This is my copied snapshot."
9
+ --description 'This is my copied snapshot.'
10
10
 
11
11
  Output::
12
12
 
@@ -14,8 +14,6 @@ Output::
14
14
  "SnapshotId": "snap-066877671789bd71b"
15
15
  }
16
16
 
17
- For more information, see `Copy an Amazon EBS snapshot <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-copy-snapshot.html>`__ in the *Amazon EC2 User Guide*.
18
-
19
17
  **Example 2: To copy an unencrypted snapshot and encrypt the new snapshot**
20
18
 
21
19
  The following ``copy-snapshot`` command copies the specified unencrypted snapshot from the ``us-west-2`` Region to the current Region and encrypts the new snapshot using the specified KMS key. ::
@@ -32,4 +30,4 @@ Output::
32
30
  "SnapshotId": "snap-066877671789bd71b"
33
31
  }
34
32
 
35
- For more information, see `Copy an Amazon EBS snapshot <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-copy-snapshot.html>`__ in the *Amazon EC2 User Guide*.
33
+ For more information, see `Copy an Amazon EBS snapshot <https://docs.aws.amazon.com/ebs/latest/userguide/ebs-copy-snapshot.html>`__ in the *Amazon EBS User Guide*.
@@ -1,95 +1,95 @@
1
- **Example 1: To create a Capacity Reservation**
2
-
3
- The following ``create-capacity-reservation`` example creates a capacity reservation in the ``eu-west-1a`` Availability Zone, into which you can launch three ``t2.medium`` instances running a Linux/Unix operating system. By default, the capacity reservation is created with open instance matching criteria and no support for ephemeral storage, and it remains active until you manually cancel it. ::
4
-
5
- aws ec2 create-capacity-reservation \
6
- --availability-zone eu-west-1a \
7
- --instance-type t2.medium \
8
- --instance-platform Linux/UNIX \
9
- --instance-count 3
10
-
11
- Output::
12
-
13
- {
14
- "CapacityReservation": {
15
- "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
16
- "EndDateType": "unlimited",
17
- "AvailabilityZone": "eu-west-1a",
18
- "InstanceMatchCriteria": "open",
19
- "EphemeralStorage": false,
20
- "CreateDate": "2019-08-16T09:27:35.000Z",
21
- "AvailableInstanceCount": 3,
22
- "InstancePlatform": "Linux/UNIX",
23
- "TotalInstanceCount": 3,
24
- "State": "active",
25
- "Tenancy": "default",
26
- "EbsOptimized": false,
27
- "InstanceType": "t2.medium"
28
- }
29
- }
30
-
31
- **Example 2: To create a Capacity Reservation that automatically ends at a specified date/time**
32
-
33
- The following ``create-capacity-reservation`` example creates a capacity reservation in the ``eu-west-1a`` Availability Zone, into which you can launch three ``m5.large`` instances running a Linux/Unix operating system. This capacity reservation automatically ends on 08/31/2019 at 23:59:59. ::
34
-
35
- aws ec2 create-capacity-reservation \
36
- --availability-zone eu-west-1a \
37
- --instance-type m5.large \
38
- --instance-platform Linux/UNIX \
39
- --instance-count 3 \
40
- --end-date-type limited \
41
- --end-date 2019-08-31T23:59:59Z
42
-
43
- Output::
44
-
45
- {
46
- "CapacityReservation": {
47
- "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
48
- "EndDateType": "limited",
49
- "AvailabilityZone": "eu-west-1a",
50
- "EndDate": "2019-08-31T23:59:59.000Z",
51
- "InstanceMatchCriteria": "open",
52
- "EphemeralStorage": false,
53
- "CreateDate": "2019-08-16T10:15:53.000Z",
54
- "AvailableInstanceCount": 3,
55
- "InstancePlatform": "Linux/UNIX",
56
- "TotalInstanceCount": 3,
57
- "State": "active",
58
- "Tenancy": "default",
59
- "EbsOptimized": false,
60
- "InstanceType": "m5.large"
61
- }
62
- }
63
-
64
- **Example 3: To create a Capacity Reservation that accepts only targeted instance launches**
65
-
66
- The following ``create-capacity-reservation`` example creates a capacity reservation that accepts only targeted instance launches. ::
67
-
68
- aws ec2 create-capacity-reservation \
69
- --availability-zone eu-west-1a \
70
- --instance-type m5.large \
71
- --instance-platform Linux/UNIX \
72
- --instance-count 3 \
73
- --instance-match-criteria targeted
74
-
75
- Output::
76
-
77
- {
78
- "CapacityReservation": {
79
- "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
80
- "EndDateType": "unlimited",
81
- "AvailabilityZone": "eu-west-1a",
82
- "InstanceMatchCriteria": "targeted",
83
- "EphemeralStorage": false,
84
- "CreateDate": "2019-08-16T10:21:57.000Z",
85
- "AvailableInstanceCount": 3,
86
- "InstancePlatform": "Linux/UNIX",
87
- "TotalInstanceCount": 3,
88
- "State": "active",
89
- "Tenancy": "default",
90
- "EbsOptimized": false,
91
- "InstanceType": "m5.large"
92
- }
93
- }
94
-
95
- For more information, see `Creating a Capacity Reservation <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html#capacity-reservations-create>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
1
+ **Example 1: To create a Capacity Reservation**
2
+
3
+ The following ``create-capacity-reservation`` example creates a capacity reservation in the ``eu-west-1a`` Availability Zone, into which you can launch three ``t2.medium`` instances running a Linux/Unix operating system. By default, the capacity reservation is created with open instance matching criteria and no support for ephemeral storage, and it remains active until you manually cancel it. ::
4
+
5
+ aws ec2 create-capacity-reservation \
6
+ --availability-zone eu-west-1a \
7
+ --instance-type t2.medium \
8
+ --instance-platform Linux/UNIX \
9
+ --instance-count 3
10
+
11
+ Output::
12
+
13
+ {
14
+ "CapacityReservation": {
15
+ "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
16
+ "EndDateType": "unlimited",
17
+ "AvailabilityZone": "eu-west-1a",
18
+ "InstanceMatchCriteria": "open",
19
+ "EphemeralStorage": false,
20
+ "CreateDate": "2019-08-16T09:27:35.000Z",
21
+ "AvailableInstanceCount": 3,
22
+ "InstancePlatform": "Linux/UNIX",
23
+ "TotalInstanceCount": 3,
24
+ "State": "active",
25
+ "Tenancy": "default",
26
+ "EbsOptimized": false,
27
+ "InstanceType": "t2.medium"
28
+ }
29
+ }
30
+
31
+ **Example 2: To create a Capacity Reservation that automatically ends at a specified date/time**
32
+
33
+ The following ``create-capacity-reservation`` example creates a capacity reservation in the ``eu-west-1a`` Availability Zone, into which you can launch three ``m5.large`` instances running a Linux/Unix operating system. This capacity reservation automatically ends on 08/31/2019 at 23:59:59. ::
34
+
35
+ aws ec2 create-capacity-reservation \
36
+ --availability-zone eu-west-1a \
37
+ --instance-type m5.large \
38
+ --instance-platform Linux/UNIX \
39
+ --instance-count 3 \
40
+ --end-date-type limited \
41
+ --end-date 2019-08-31T23:59:59Z
42
+
43
+ Output::
44
+
45
+ {
46
+ "CapacityReservation": {
47
+ "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
48
+ "EndDateType": "limited",
49
+ "AvailabilityZone": "eu-west-1a",
50
+ "EndDate": "2019-08-31T23:59:59.000Z",
51
+ "InstanceMatchCriteria": "open",
52
+ "EphemeralStorage": false,
53
+ "CreateDate": "2019-08-16T10:15:53.000Z",
54
+ "AvailableInstanceCount": 3,
55
+ "InstancePlatform": "Linux/UNIX",
56
+ "TotalInstanceCount": 3,
57
+ "State": "active",
58
+ "Tenancy": "default",
59
+ "EbsOptimized": false,
60
+ "InstanceType": "m5.large"
61
+ }
62
+ }
63
+
64
+ **Example 3: To create a Capacity Reservation that accepts only targeted instance launches**
65
+
66
+ The following ``create-capacity-reservation`` example creates a capacity reservation that accepts only targeted instance launches. ::
67
+
68
+ aws ec2 create-capacity-reservation \
69
+ --availability-zone eu-west-1a \
70
+ --instance-type m5.large \
71
+ --instance-platform Linux/UNIX \
72
+ --instance-count 3 \
73
+ --instance-match-criteria targeted
74
+
75
+ Output::
76
+
77
+ {
78
+ "CapacityReservation": {
79
+ "CapacityReservationId": "cr-1234abcd56EXAMPLE ",
80
+ "EndDateType": "unlimited",
81
+ "AvailabilityZone": "eu-west-1a",
82
+ "InstanceMatchCriteria": "targeted",
83
+ "EphemeralStorage": false,
84
+ "CreateDate": "2019-08-16T10:21:57.000Z",
85
+ "AvailableInstanceCount": 3,
86
+ "InstancePlatform": "Linux/UNIX",
87
+ "TotalInstanceCount": 3,
88
+ "State": "active",
89
+ "Tenancy": "default",
90
+ "EbsOptimized": false,
91
+ "InstanceType": "m5.large"
92
+ }
93
+ }
94
+
95
+ For more information, see `Create a Capacity Reservation <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservations-using.html>`__ in the *Amazon EC2 User Guide*.
@@ -18,8 +18,6 @@ Output::
18
18
  }
19
19
  }
20
20
 
21
- For more information, see `Replace a root volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root>`__ in the *Amazon Elastic Compute Cloud User Guide*.
22
-
23
21
  **Example 2: To restore a root volume to a specific snapshot**
24
22
 
25
23
  The following ``create-replace-root-volume-task`` example restores the root volume of instance i-0123456789abcdefa to snapshot snap-0abcdef1234567890. ::
@@ -41,4 +39,4 @@ Output::
41
39
  }
42
40
  }
43
41
 
44
- For more information, see `Replace a root volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ebs-restoring-volume.html#replace-root>`__ in the *Amazon Elastic Compute Cloud User Guide*.
42
+ For more information, see `Replace a root volume <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/replace-root.html>`__ in the *Amazon EC2 User Guide*.
@@ -5,7 +5,7 @@ The following ``create-restore-image-task`` example restores an AMI from an S3 b
5
5
  aws ec2 create-restore-image-task \
6
6
  --object-key ami-1234567890abcdef0.bin \
7
7
  --bucket my-ami-bucket \
8
- --name "New AMI Name"
8
+ --name 'New AMI Name'
9
9
 
10
10
  Output::
11
11
 
@@ -13,4 +13,4 @@ Output::
13
13
  "ImageId": "ami-0eab20fe36f83e1a8"
14
14
  }
15
15
 
16
- For more information about storing and restoring an AMI using S3, see `Store and restore an AMI using S3 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html>` in the *Amazon EC2 User Guide*.
16
+ For more information, see `Store and restore an AMI using S3 <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-store-restore.html>`__ in the *Amazon EC2 User Guide*.
@@ -21,4 +21,4 @@ The data feed is stored in the Amazon S3 bucket that you specified. The file nam
21
21
 
22
22
  my-bucket.s3.amazonaws.com/spot-data-feed/123456789012.YYYY-MM-DD-HH.n.abcd1234.gz
23
23
 
24
- For more information, see `Spot Instance data feed <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-data-feeds.html>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
24
+ For more information, see `Spot Instance data feed <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/spot-data-feeds.html>`__ in the *Amazon EC2 User Guide*.
@@ -1,43 +1,43 @@
1
- **Example 1: To add a tag to a resource**
2
-
3
- The following ``create-tags`` example adds the tag ``Stack=production`` to the specified image, or overwrites an existing tag for the AMI where the tag key is ``Stack``. ::
4
-
5
- aws ec2 create-tags \
6
- --resources ami-1234567890abcdef0 \
7
- --tags Key=Stack,Value=production
8
-
9
- For more information, see `This is the topic title <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
10
-
11
- **Example 2: To add tags to multiple resources**
12
-
13
- The following ``create-tags`` example adds (or overwrites) two tags for an AMI and an instance. One of the tags has a key (``webserver``) but no value (value is set to an empty string). The other tag has a key (``stack``) and a value (``Production``). ::
14
-
15
- aws ec2 create-tags \
16
- --resources ami-1a2b3c4d i-1234567890abcdef0 \
17
- --tags Key=webserver,Value= Key=stack,Value=Production
18
-
19
- For more information, see `This is the topic title <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
20
-
21
- **Example 3: To add tags containing special characters**
22
-
23
- The following ``create-tags`` example adds the tag ``[Group]=test`` for an instance. The square brackets ([ and ]) are special characters, and must be escaped. The following examples also use the line continuation character appropriate for each environment.
24
-
25
- If you are using Windows, surround the element that has special characters with double quotes ("), and then precede each double quote character with a backslash (\\) as follows::
26
-
27
- aws ec2 create-tags ^
28
- --resources i-1234567890abcdef0 ^
29
- --tags Key=\"[Group]\",Value=test
30
-
31
- If you are using Windows PowerShell, surround the element the value that has special characters with double quotes ("), precede each double quote character with a backslash (\\), and then surround the entire key and value structure with single quotes (') as follows::
32
-
33
- aws ec2 create-tags `
34
- --resources i-1234567890abcdef0 `
35
- --tags 'Key=\"[Group]\",Value=test'
36
-
37
- If you are using Linux or OS X, surround the element that has special characters with double quotes ("), and then surround the entire key and value structure with single quotes (') as follows::
38
-
39
- aws ec2 create-tags \
40
- --resources i-1234567890abcdef0 \
41
- --tags 'Key="[Group]",Value=test'
42
-
43
- For more information, see `This is the topic title <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html>`__ in the *Amazon Elastic Compute Cloud User Guide for Linux Instances*.
1
+ **Example 1: To add a tag to a resource**
2
+
3
+ The following ``create-tags`` example adds the tag ``Stack=production`` to the specified image, or overwrites an existing tag for the AMI where the tag key is ``Stack``. ::
4
+
5
+ aws ec2 create-tags \
6
+ --resources ami-1234567890abcdef0 \
7
+ --tags Key=Stack,Value=production
8
+
9
+ This command produces no output
10
+
11
+ **Example 2: To add tags to multiple resources**
12
+
13
+ The following ``create-tags`` example adds (or overwrites) two tags for an AMI and an instance. One of the tags has a key (``webserver``) but no value (value is set to an empty string). The other tag has a key (``stack``) and a value (``Production``). ::
14
+
15
+ aws ec2 create-tags \
16
+ --resources ami-1a2b3c4d i-1234567890abcdef0 \
17
+ --tags Key=webserver,Value= Key=stack,Value=Production
18
+
19
+ This command produces no output
20
+
21
+ **Example 3: To add tags containing special characters**
22
+
23
+ The following ``create-tags`` examples add the tag ``[Group]=test`` for an instance. The square brackets ([ and ]) are special characters, and must be escaped. The following examples also use the line continuation character appropriate for each environment.
24
+
25
+ If you are using Windows, surround the element that has special characters with double quotes ("), and then precede each double quote character with a backslash (\\) as follows. ::
26
+
27
+ aws ec2 create-tags ^
28
+ --resources i-1234567890abcdef0 ^
29
+ --tags Key=\"[Group]\",Value=test
30
+
31
+ If you are using Windows PowerShell, surround the element the value that has special characters with double quotes ("), precede each double quote character with a backslash (\\), and then surround the entire key and value structure with single quotes (') as follows. ::
32
+
33
+ aws ec2 create-tags `
34
+ --resources i-1234567890abcdef0 `
35
+ --tags 'Key=\"[Group]\",Value=test'
36
+
37
+ If you are using Linux or OS X, surround the element that has special characters with double quotes ("), and then surround the entire key and value structure with single quotes (') as follows. ::
38
+
39
+ aws ec2 create-tags \
40
+ --resources i-1234567890abcdef0 \
41
+ --tags 'Key="[Group]",Value=test'
42
+
43
+ For more information, see `Tag your Amazon EC2 resources <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html>`__ in the *Amazon EC2 User Guide*.
@@ -1,32 +1,32 @@
1
- **To create a filter rule for incoming TCP traffic**
2
-
3
- The following ``create-traffic-mirror-filter-rule`` example creates a rule that you can use to mirror all incoming TCP traffic. Before you run this command, use ``create-traffic-mirror-filter`` to create the the Traffic Mirror filter. ::
4
-
5
- aws ec2 create-traffic-mirror-filter-rule \
6
- --description "TCP Rule" \
7
- --destination-cidr-block 0.0.0.0/0 \
8
- --protocol 6 \
9
- --rule-action accept \
10
- --rule-number 1 \
11
- --source-cidr-block 0.0.0.0/0 \
12
- --traffic-direction ingress \
13
- --traffic-mirror-filter-id tmf-04812ff784b25ae67
14
-
15
- Output::
16
-
17
- {
18
- "TrafficMirrorFilterRule": {
19
- "DestinationCidrBlock": "0.0.0.0/0",
20
- "TrafficMirrorFilterId": "tmf-04812ff784b25ae67",
21
- "TrafficMirrorFilterRuleId": "tmfr-02d20d996673f3732",
22
- "SourceCidrBlock": "0.0.0.0/0",
23
- "TrafficDirection": "ingress",
24
- "Description": "TCP Rule",
25
- "RuleNumber": 1,
26
- "RuleAction": "accept",
27
- "Protocol": 6
28
- },
29
- "ClientToken": "4752b573-40a6-4eac-a8a4-a72058761219"
30
- }
31
-
32
- For more information, see `Create a Traffic Mirror Filter <https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#create-traffic-mirroring-filter>`__ in the *AWS Traffic Mirroring Guide*.
1
+ **To create a filter rule for incoming TCP traffic**
2
+
3
+ The following ``create-traffic-mirror-filter-rule`` example creates a rule that you can use to mirror all incoming TCP traffic. Before you run this command, use ``create-traffic-mirror-filter`` to create the the traffic mirror filter. ::
4
+
5
+ aws ec2 create-traffic-mirror-filter-rule \
6
+ --description 'TCP Rule' \
7
+ --destination-cidr-block 0.0.0.0/0 \
8
+ --protocol 6 \
9
+ --rule-action accept \
10
+ --rule-number 1 \
11
+ --source-cidr-block 0.0.0.0/0 \
12
+ --traffic-direction ingress \
13
+ --traffic-mirror-filter-id tmf-04812ff784b25ae67
14
+
15
+ Output::
16
+
17
+ {
18
+ "TrafficMirrorFilterRule": {
19
+ "DestinationCidrBlock": "0.0.0.0/0",
20
+ "TrafficMirrorFilterId": "tmf-04812ff784b25ae67",
21
+ "TrafficMirrorFilterRuleId": "tmfr-02d20d996673f3732",
22
+ "SourceCidrBlock": "0.0.0.0/0",
23
+ "TrafficDirection": "ingress",
24
+ "Description": "TCP Rule",
25
+ "RuleNumber": 1,
26
+ "RuleAction": "accept",
27
+ "Protocol": 6
28
+ },
29
+ "ClientToken": "4752b573-40a6-4eac-a8a4-a72058761219"
30
+ }
31
+
32
+ For more information, see `Create a traffic mirror filter <https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-filter.html>`__ in the *Traffic Mirroring Guide*.
@@ -1,12 +1,22 @@
1
- **To create a Traffic Mirror Filter**
2
-
3
- The following ``create-traffic-mirror-filter`` example creates a Traffic Mirror filter. After you create the filter, use ``create-traffic-mirror-filter-rule`` to add rules to the filter. ::
4
-
5
- aws ec2 create-traffic-mirror-filter \
6
- --description "TCP Filter"
7
-
8
- Output::
9
-
10
- {
11
1
  "ClientToken": "28908518-100b-4987-8233-8c744EXAMPLE",
12
2
  "TrafficMirrorFilter": {
13
3
  "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
14
4
  "Description": "TCP Filter",
15
5
  "EgressFilterRules": [],
16
6
  "IngressFilterRules": [],
17
7
  "Tags": [],
18
8
  "NetworkServices": []
19
9
  }
20
10
  }
21
-
22
- For more information, see `Create a Traffic Mirror Filter <https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-filter.html#create-traffic-mirroring-filter>`__ in the *AWS Traffic Mirroring Guide*.
11
+ **To create a traffic mirror filter**
12
+
13
+ The following ``create-traffic-mirror-filter`` example creates a traffic mirror filter. After you create the filter, use ``create-traffic-mirror-filter-rule`` to add rules. ::
14
+
15
+ aws ec2 create-traffic-mirror-filter \
16
+ --description 'TCP Filter'
17
+
18
+ Output::
19
+
20
+ {
21
+ "ClientToken": "28908518-100b-4987-8233-8c744EXAMPLE",
22
+ "TrafficMirrorFilter": {
23
+ "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
24
+ "Description": "TCP Filter",
25
+ "EgressFilterRules": [],
26
+ "IngressFilterRules": [],
27
+ "Tags": [],
28
+ "NetworkServices": []
29
+ }
30
+ }
31
+
32
+ For more information, see `Create a traffic mirror filter <https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-filter.html>`__ in the *Traffic Mirroring Guide*.
@@ -1,31 +1,31 @@
1
- **To create a Traffic Mirror Session**
2
-
3
- The following ``create-traffic-mirror-session`` command creates a traffic mirror sessions for the specified source and target for 25 bytes of the packet. ::
4
-
5
- aws ec2 create-traffic-mirror-session \
6
- --description "example session" \
7
- --traffic-mirror-target-id tmt-07f75d8feeEXAMPLE \
8
- --network-interface-id eni-070203f901EXAMPLE \
9
- --session-number 1 \
10
- --packet-length 25 \
11
- --traffic-mirror-filter-id tmf-04812ff784EXAMPLE
12
-
13
- Output::
14
-
15
- {
16
- "TrafficMirrorSession": {
17
- "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE",
18
- "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE",
19
- "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
20
- "NetworkInterfaceId": "eni-070203f901EXAMPLE",
21
- "OwnerId": "111122223333",
22
- "PacketLength": 25,
23
- "SessionNumber": 1,
24
- "VirtualNetworkId": 7159709,
25
- "Description": "example session",
26
- "Tags": []
27
- },
28
- "ClientToken": "5236cffc-ee13-4a32-bb5b-388d9da09d96"
29
- }
30
-
31
- For more information, see `Create a Traffic Mirror Session <https://docs.aws.amazon.com/vpc/latest/mirroring/traffic-mirroring-session.html#create-traffic-mirroring-session>`__ in the *AWS Traffic Mirroring Guide*.
1
+ **To create a traffic mirror session**
2
+
3
+ The following ``create-traffic-mirror-session`` command creates a traffic mirror session for the specified source and target for 25 bytes of the packet. ::
4
+
5
+ aws ec2 create-traffic-mirror-session \
6
+ --description 'example session' \
7
+ --traffic-mirror-target-id tmt-07f75d8feeEXAMPLE \
8
+ --network-interface-id eni-070203f901EXAMPLE \
9
+ --session-number 1 \
10
+ --packet-length 25 \
11
+ --traffic-mirror-filter-id tmf-04812ff784EXAMPLE
12
+
13
+ Output::
14
+
15
+ {
16
+ "TrafficMirrorSession": {
17
+ "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE",
18
+ "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE",
19
+ "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
20
+ "NetworkInterfaceId": "eni-070203f901EXAMPLE",
21
+ "OwnerId": "111122223333",
22
+ "PacketLength": 25,
23
+ "SessionNumber": 1,
24
+ "VirtualNetworkId": 7159709,
25
+ "Description": "example session",
26
+ "Tags": []
27
+ },
28
+ "ClientToken": "5236cffc-ee13-4a32-bb5b-388d9da09d96"
29
+ }
30
+
31
+ For more information, see `Create a traffic mirror session <https://docs.aws.amazon.com/vpc/latest/mirroring/create-traffic-mirroring-session.html>`__ in the *Traffic Mirroring Guide*.