awscli 1.37.11__py3-none-any.whl → 1.37.13__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 (145) hide show
  1. awscli/__init__.py +1 -1
  2. awscli/examples/cloudtrail/create-subscription.rst +35 -35
  3. awscli/examples/cloudtrail/create-trail.rst +19 -19
  4. awscli/examples/cloudtrail/describe-trails.rst +36 -36
  5. awscli/examples/cloudtrail/update-subscription.rst +33 -33
  6. awscli/examples/cloudtrail/update-trail.rst +18 -18
  7. awscli/examples/codepipeline/list-action-executions.rst +114 -114
  8. awscli/examples/ec2/create-spot-datafeed-subscription.rst +24 -24
  9. awscli/examples/elasticbeanstalk/create-application-version.rst +3 -3
  10. awscli/examples/kendra/describe-data-source.rst +1 -1
  11. awscli/examples/networkflowmonitor/create-monitor.rst +19 -0
  12. awscli/examples/networkflowmonitor/create-scope.rst +16 -0
  13. awscli/examples/networkflowmonitor/delete-monitor.rst +10 -0
  14. awscli/examples/networkflowmonitor/delete-scope.rst +10 -0
  15. awscli/examples/networkflowmonitor/get-monitor.rst +26 -0
  16. awscli/examples/networkflowmonitor/get-query-results-workload-insights-top-contributors-data.rst +30 -0
  17. awscli/examples/networkflowmonitor/get-query-results-workload-insights-top-contributors.rst +27 -0
  18. awscli/examples/networkflowmonitor/get-query-status-monitor-top-contributors.rst +15 -0
  19. awscli/examples/networkflowmonitor/get-query-status-workload-insights-top-contributors-data.rst +15 -0
  20. awscli/examples/networkflowmonitor/get-query-status-workload-insights-top-contributors.rst +15 -0
  21. awscli/examples/networkflowmonitor/get-scope.rst +28 -0
  22. awscli/examples/networkflowmonitor/list-monitors.rst +19 -0
  23. awscli/examples/networkflowmonitor/list-scopes.rst +19 -0
  24. awscli/examples/networkflowmonitor/list-tags-for-resource.rst +17 -0
  25. awscli/examples/networkflowmonitor/start-query-monitor-top-contributors.rst +18 -0
  26. awscli/examples/networkflowmonitor/start-query-workload-insights-top-contributors-data.rst +18 -0
  27. awscli/examples/networkflowmonitor/start-query-workload-insights-top-contributors.rst +18 -0
  28. awscli/examples/networkflowmonitor/stop-query-monitor-top-contributors.rst +11 -0
  29. awscli/examples/networkflowmonitor/stop-query-workload-insights-top-contributors-data.rst +11 -0
  30. awscli/examples/networkflowmonitor/stop-query-workload-insights-top-contributors.rst +11 -0
  31. awscli/examples/networkflowmonitor/tag-resource.rst +11 -0
  32. awscli/examples/networkflowmonitor/untag-resource.rst +11 -0
  33. awscli/examples/networkflowmonitor/update-monitor.rst +21 -0
  34. awscli/examples/networkmanager/delete-bucket-analytics-configuration.rst +1 -1
  35. awscli/examples/networkmanager/delete-bucket-metrics-configuration.rst +1 -1
  36. awscli/examples/networkmanager/delete-public-access-block.rst +1 -1
  37. awscli/examples/networkmanager/get-bucket-analytics-configuration.rst +1 -1
  38. awscli/examples/networkmanager/get-bucket-metrics-configuration.rst +1 -1
  39. awscli/examples/networkmanager/get-object-retention.rst +1 -1
  40. awscli/examples/networkmanager/get-public-access-block.rst +1 -1
  41. awscli/examples/networkmanager/list-bucket-analytics-configurations.rst +1 -1
  42. awscli/examples/networkmanager/list-bucket-metrics-configurations.rst +1 -1
  43. awscli/examples/networkmanager/put-bucket-metrics-configuration.rst +1 -1
  44. awscli/examples/networkmanager/put-object-retention.rst +1 -1
  45. awscli/examples/networkmanager/put-public-access-block.rst +1 -1
  46. awscli/examples/robomaker/create-robot-application-version.rst +1 -1
  47. awscli/examples/robomaker/create-robot-application.rst +2 -2
  48. awscli/examples/robomaker/create-simulation-application-version.rst +1 -1
  49. awscli/examples/robomaker/create-simulation-application.rst +2 -2
  50. awscli/examples/robomaker/describe-robot-application.rst +1 -1
  51. awscli/examples/robomaker/describe-simulation-application.rst +1 -1
  52. awscli/examples/robomaker/update-robot-application.rst +2 -2
  53. awscli/examples/robomaker/update-simulation-application.rst +2 -2
  54. awscli/examples/s3/website.rst +2 -2
  55. awscli/examples/s3api/abort-multipart-upload.rst +2 -2
  56. awscli/examples/s3api/complete-multipart-upload.rst +4 -4
  57. awscli/examples/s3api/create-bucket.rst +9 -9
  58. awscli/examples/s3api/create-multipart-upload.rst +4 -4
  59. awscli/examples/s3api/delete-bucket-analytics-configuration.rst +1 -1
  60. awscli/examples/s3api/delete-bucket-cors.rst +2 -2
  61. awscli/examples/s3api/delete-bucket-encryption.rst +1 -1
  62. awscli/examples/s3api/delete-bucket-inventory-configuration.rst +1 -1
  63. awscli/examples/s3api/delete-bucket-lifecycle.rst +2 -2
  64. awscli/examples/s3api/delete-bucket-metrics-configuration.rst +1 -1
  65. awscli/examples/s3api/delete-bucket-policy.rst +2 -2
  66. awscli/examples/s3api/delete-bucket-replication.rst +2 -2
  67. awscli/examples/s3api/delete-bucket-tagging.rst +2 -2
  68. awscli/examples/s3api/delete-bucket-website.rst +2 -2
  69. awscli/examples/s3api/delete-bucket.rst +2 -2
  70. awscli/examples/s3api/delete-object-tagging.rst +1 -1
  71. awscli/examples/s3api/delete-object.rst +2 -2
  72. awscli/examples/s3api/delete-objects.rst +2 -2
  73. awscli/examples/s3api/delete-public-access-block.rst +1 -1
  74. awscli/examples/s3api/get-bucket-accelerate-configuration.rst +1 -1
  75. awscli/examples/s3api/get-bucket-acl.rst +2 -2
  76. awscli/examples/s3api/get-bucket-analytics-configuration.rst +1 -1
  77. awscli/examples/s3api/get-bucket-cors.rst +2 -2
  78. awscli/examples/s3api/get-bucket-encryption.rst +2 -2
  79. awscli/examples/s3api/get-bucket-inventory-configuration.rst +2 -2
  80. awscli/examples/s3api/get-bucket-lifecycle-configuration.rst +2 -2
  81. awscli/examples/s3api/get-bucket-lifecycle.rst +2 -2
  82. awscli/examples/s3api/get-bucket-location.rst +2 -2
  83. awscli/examples/s3api/get-bucket-logging.rst +2 -2
  84. awscli/examples/s3api/get-bucket-metrics-configuration.rst +1 -1
  85. awscli/examples/s3api/get-bucket-notification-configuration.rst +2 -2
  86. awscli/examples/s3api/get-bucket-notification.rst +2 -2
  87. awscli/examples/s3api/get-bucket-policy-status.rst +2 -2
  88. awscli/examples/s3api/get-bucket-policy.rst +3 -3
  89. awscli/examples/s3api/get-bucket-replication.rst +3 -3
  90. awscli/examples/s3api/get-bucket-request-payment.rst +1 -1
  91. awscli/examples/s3api/get-bucket-tagging.rst +2 -2
  92. awscli/examples/s3api/get-bucket-versioning.rst +2 -2
  93. awscli/examples/s3api/get-bucket-website.rst +2 -2
  94. awscli/examples/s3api/get-object-acl.rst +2 -2
  95. awscli/examples/s3api/get-object-attributes.rst +1 -1
  96. awscli/examples/s3api/get-object-legal-hold.rst +1 -1
  97. awscli/examples/s3api/get-object-lock-configuration.rst +1 -1
  98. awscli/examples/s3api/get-object-retention.rst +1 -1
  99. awscli/examples/s3api/get-object-tagging.rst +3 -3
  100. awscli/examples/s3api/get-object-torrent.rst +2 -2
  101. awscli/examples/s3api/get-public-access-block.rst +1 -1
  102. awscli/examples/s3api/head-bucket.rst +2 -2
  103. awscli/examples/s3api/head-object.rst +2 -2
  104. awscli/examples/s3api/list-bucket-analytics-configurations.rst +1 -1
  105. awscli/examples/s3api/list-bucket-inventory-configurations.rst +3 -3
  106. awscli/examples/s3api/list-bucket-metrics-configurations.rst +1 -1
  107. awscli/examples/s3api/list-multipart-uploads.rst +2 -2
  108. awscli/examples/s3api/list-object-versions.rst +2 -2
  109. awscli/examples/s3api/list-objects-v2.rst +1 -1
  110. awscli/examples/s3api/list-parts.rst +2 -2
  111. awscli/examples/s3api/put-bucket-accelerate-configuration.rst +1 -1
  112. awscli/examples/s3api/put-bucket-analytics-configuration.rst +1 -1
  113. awscli/examples/s3api/put-bucket-encryption.rst +1 -1
  114. awscli/examples/s3api/put-bucket-inventory-configuration.rst +6 -6
  115. awscli/examples/s3api/put-bucket-lifecycle-configuration.rst +2 -2
  116. awscli/examples/s3api/put-bucket-lifecycle.rst +2 -2
  117. awscli/examples/s3api/put-bucket-metrics-configuration.rst +1 -1
  118. awscli/examples/s3api/put-bucket-notification-configuration.rst +44 -44
  119. awscli/examples/s3api/put-bucket-notification.rst +4 -4
  120. awscli/examples/s3api/put-bucket-request-payment.rst +2 -2
  121. awscli/examples/s3api/put-bucket-tagging.rst +4 -4
  122. awscli/examples/s3api/put-bucket-versioning.rst +3 -3
  123. awscli/examples/s3api/put-bucket-website.rst +2 -2
  124. awscli/examples/s3api/put-object-legal-hold.rst +1 -1
  125. awscli/examples/s3api/put-object-lock-configuration.rst +1 -1
  126. awscli/examples/s3api/put-object-retention.rst +1 -1
  127. awscli/examples/s3api/put-object-tagging.rst +2 -2
  128. awscli/examples/s3api/put-public-access-block.rst +1 -1
  129. awscli/examples/s3api/select-object-content.rst +1 -1
  130. awscli/examples/s3api/upload-part-copy.rst +2 -2
  131. awscli/examples/s3api/upload-part.rst +1 -1
  132. awscli/examples/s3api/wait/bucket-exists.rst +1 -1
  133. awscli/examples/s3api/wait/bucket-not-exists.rst +1 -1
  134. awscli/examples/s3api/wait/object-exists.rst +1 -1
  135. awscli/examples/s3api/wait/object-not-exists.rst +1 -1
  136. {awscli-1.37.11.dist-info → awscli-1.37.13.dist-info}/METADATA +2 -2
  137. {awscli-1.37.11.dist-info → awscli-1.37.13.dist-info}/RECORD +145 -122
  138. {awscli-1.37.11.data → awscli-1.37.13.data}/scripts/aws +0 -0
  139. {awscli-1.37.11.data → awscli-1.37.13.data}/scripts/aws.cmd +0 -0
  140. {awscli-1.37.11.data → awscli-1.37.13.data}/scripts/aws_bash_completer +0 -0
  141. {awscli-1.37.11.data → awscli-1.37.13.data}/scripts/aws_completer +0 -0
  142. {awscli-1.37.11.data → awscli-1.37.13.data}/scripts/aws_zsh_completer.sh +0 -0
  143. {awscli-1.37.11.dist-info → awscli-1.37.13.dist-info}/LICENSE.txt +0 -0
  144. {awscli-1.37.11.dist-info → awscli-1.37.13.dist-info}/WHEEL +0 -0
  145. {awscli-1.37.11.dist-info → awscli-1.37.13.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
- The following command verifies access to a bucket named ``my-bucket``::
1
+ The following command verifies access to a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api head-bucket --bucket my-bucket
3
+ aws s3api head-bucket --bucket amzn-s3-demo-bucket
4
4
 
5
5
  If the bucket exists and you have access to it, no output is returned. Otherwise, an error message will be shown. For example::
6
6
 
@@ -1,6 +1,6 @@
1
- The following command retrieves metadata for an object in a bucket named ``my-bucket``::
1
+ The following command retrieves metadata for an object in a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api head-object --bucket my-bucket --key index.html
3
+ aws s3api head-object --bucket amzn-s3-demo-bucket --key index.html
4
4
 
5
5
  Output::
6
6
 
@@ -3,7 +3,7 @@
3
3
  The following ``list-bucket-analytics-configurations`` retrieves a list of analytics configurations for the specified bucket. ::
4
4
 
5
5
  aws s3api list-bucket-analytics-configurations \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  Output::
9
9
 
@@ -3,7 +3,7 @@
3
3
  The following ``list-bucket-inventory-configurations`` example lists the inventory configurations for the specified bucket. ::
4
4
 
5
5
  aws s3api list-bucket-inventory-configurations \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  Output::
9
9
 
@@ -14,7 +14,7 @@ Output::
14
14
  "Destination": {
15
15
  "S3BucketDestination": {
16
16
  "Format": "ORC",
17
- "Bucket": "arn:aws:s3:::my-bucket",
17
+ "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
18
18
  "AccountId": "123456789012"
19
19
  }
20
20
  },
@@ -29,7 +29,7 @@ Output::
29
29
  "Destination": {
30
30
  "S3BucketDestination": {
31
31
  "Format": "CSV",
32
- "Bucket": "arn:aws:s3:::my-bucket",
32
+ "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket",
33
33
  "AccountId": "123456789012"
34
34
  }
35
35
  },
@@ -3,7 +3,7 @@
3
3
  The following ``list-bucket-metrics-configurations`` example retrieves a list of metrics configurations for the specified bucket. ::
4
4
 
5
5
  aws s3api list-bucket-metrics-configurations \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  Output::
9
9
 
@@ -1,6 +1,6 @@
1
- The following command lists all of the active multipart uploads for a bucket named ``my-bucket``::
1
+ The following command lists all of the active multipart uploads for a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api list-multipart-uploads --bucket my-bucket
3
+ aws s3api list-multipart-uploads --bucket amzn-s3-demo-bucket
4
4
 
5
5
  Output::
6
6
 
@@ -1,6 +1,6 @@
1
- The following command retrieves version information for an object in a bucket named ``my-bucket``::
1
+ The following command retrieves version information for an object in a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api list-object-versions --bucket my-bucket --prefix index.html
3
+ aws s3api list-object-versions --bucket amzn-s3-demo-bucket --prefix index.html
4
4
 
5
5
  Output::
6
6
 
@@ -3,7 +3,7 @@
3
3
  The following ``list-objects-v2`` example lists the objects in the specified bucket. ::
4
4
 
5
5
  aws s3api list-objects-v2 \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  Output::
9
9
 
@@ -1,6 +1,6 @@
1
- The following command lists all of the parts that have been uploaded for a multipart upload with key ``multipart/01`` in the bucket ``my-bucket``::
1
+ The following command lists all of the parts that have been uploaded for a multipart upload with key ``multipart/01`` in the bucket ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api list-parts --bucket my-bucket --key 'multipart/01' --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R
3
+ aws s3api list-parts --bucket amzn-s3-demo-bucket --key 'multipart/01' --upload-id dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R
4
4
 
5
5
  Output::
6
6
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-bucket-accelerate-configuration`` example enables the accelerate configuration for the specified bucket. ::
4
4
 
5
5
  aws s3api put-bucket-accelerate-configuration \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --accelerate-configuration Status=Enabled
8
8
 
9
9
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``put-bucket-analytics-configuration`` example configures analytics for the specified bucket. ::
4
4
 
5
5
  aws s3api put-bucket-analytics-configuration \
6
- --bucket my-bucket --id 1 \
6
+ --bucket amzn-s3-demo-bucket --id 1 \
7
7
  --analytics-configuration '{"Id": "1","StorageClassAnalysis": {}}'
8
8
 
9
9
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``put-bucket-encryption`` example sets AES256 encryption as the default for the specified bucket. ::
4
4
 
5
5
  aws s3api put-bucket-encryption \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --server-side-encryption-configuration '{"Rules": [{"ApplyServerSideEncryptionByDefault": {"SSEAlgorithm": "AES256"}}]}'
8
8
 
9
9
  This command produces no output.
@@ -1,21 +1,21 @@
1
1
  **Example 1: To set an inventory configuration for a bucket**
2
2
 
3
- The following ``put-bucket-inventory-configuration`` example sets a weekly ORC-formatted inventory report for the bucket ``my-bucket``. ::
3
+ The following ``put-bucket-inventory-configuration`` example sets a weekly ORC-formatted inventory report for the bucket ``amzn-s3-demo-bucket``. ::
4
4
 
5
5
  aws s3api put-bucket-inventory-configuration \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --id 1 \
8
- --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::my-bucket", "Format": "ORC" }}, "IsEnabled": true, "Id": "1", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Weekly" }}'
8
+ --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "ORC" }}, "IsEnabled": true, "Id": "1", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Weekly" }}'
9
9
 
10
10
  This command produces no output.
11
11
 
12
12
  **Example 2: To set an inventory configuration for a bucket**
13
13
 
14
- The following ``put-bucket-inventory-configuration`` example sets a daily CSV-formatted inventory report for the bucket ``my-bucket``. ::
14
+ The following ``put-bucket-inventory-configuration`` example sets a daily CSV-formatted inventory report for the bucket ``amzn-s3-demo-bucket``. ::
15
15
 
16
16
  aws s3api put-bucket-inventory-configuration \
17
- --bucket my-bucket \
17
+ --bucket amzn-s3-demo-bucket \
18
18
  --id 2 \
19
- --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::my-bucket", "Format": "CSV" }}, "IsEnabled": true, "Id": "2", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Daily" }}'
19
+ --inventory-configuration '{"Destination": { "S3BucketDestination": { "AccountId": "123456789012", "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket", "Format": "CSV" }}, "IsEnabled": true, "Id": "2", "IncludedObjectVersions": "Current", "Schedule": { "Frequency": "Daily" }}'
20
20
 
21
21
  This command produces no output.
@@ -1,6 +1,6 @@
1
- The following command applies a lifecycle configuration to a bucket named ``my-bucket``::
1
+ The following command applies a lifecycle configuration to a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-lifecycle-configuration --bucket my-bucket --lifecycle-configuration file://lifecycle.json
3
+ aws s3api put-bucket-lifecycle-configuration --bucket amzn-s3-demo-bucket --lifecycle-configuration file://lifecycle.json
4
4
 
5
5
  The file ``lifecycle.json`` is a JSON document in the current folder that specifies two rules::
6
6
 
@@ -1,6 +1,6 @@
1
- The following command applies a lifecycle configuration to the bucket ``my-bucket``::
1
+ The following command applies a lifecycle configuration to the bucket ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-lifecycle --bucket my-bucket --lifecycle-configuration file://lifecycle.json
3
+ aws s3api put-bucket-lifecycle --bucket amzn-s3-demo-bucket --lifecycle-configuration file://lifecycle.json
4
4
 
5
5
  The file ``lifecycle.json`` is a JSON document in the current folder that specifies two rules::
6
6
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-bucket-metrics-configuration`` example sets a metric configuration with ID 123 for the specified bucket. ::
4
4
 
5
5
  aws s3api put-bucket-metrics-configuration \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --id 123 \
8
8
  --metrics-configuration '{"Id": "123", "Filter": {"Prefix": "logs"}}'
9
9
 
@@ -1,45 +1,45 @@
1
- **To enable the specified notifications to a bucket**
2
-
3
- The following ``put-bucket-notification-configuration`` example applies a notification configuration to a bucket named ``my-bucket``. The file ``notification.json`` is a JSON document in the current folder that specifies an SNS topic and an event type to monitor. ::
4
-
5
- aws s3api put-bucket-notification-configuration \
6
- --bucket my-bucket \
7
- --notification-configuration file://notification.json
8
-
9
- Contents of ``notification.json``::
10
-
11
- {
12
- "TopicConfigurations": [
13
- {
14
- "TopicArn": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic",
15
- "Events": [
16
- "s3:ObjectCreated:*"
17
- ]
18
- }
19
- ]
20
- }
21
-
22
- The SNS topic must have an IAM policy attached to it that allows Amazon S3 to publish to it. ::
23
-
24
- {
25
- "Version": "2008-10-17",
26
- "Id": "example-ID",
27
- "Statement": [
28
- {
29
- "Sid": "example-statement-ID",
30
- "Effect": "Allow",
31
- "Principal": {
32
- "Service": "s3.amazonaws.com"
33
- },
34
- "Action": [
35
- "SNS:Publish"
36
- ],
37
- "Resource": "arn:aws:sns:us-west-2:123456789012::s3-notification-topic",
38
- "Condition": {
39
- "ArnLike": {
40
- "aws:SourceArn": "arn:aws:s3:*:*:my-bucket"
41
- }
42
- }
43
- }
44
- ]
1
+ **To enable the specified notifications to a bucket**
2
+
3
+ The following ``put-bucket-notification-configuration`` example applies a notification configuration to a bucket named ``amzn-s3-demo-bucket``. The file ``notification.json`` is a JSON document in the current folder that specifies an SNS topic and an event type to monitor. ::
4
+
5
+ aws s3api put-bucket-notification-configuration \
6
+ --bucket amzn-s3-demo-bucket \
7
+ --notification-configuration file://notification.json
8
+
9
+ Contents of ``notification.json``::
10
+
11
+ {
12
+ "TopicConfigurations": [
13
+ {
14
+ "TopicArn": "arn:aws:sns:us-west-2:123456789012:s3-notification-topic",
15
+ "Events": [
16
+ "s3:ObjectCreated:*"
17
+ ]
18
+ }
19
+ ]
20
+ }
21
+
22
+ The SNS topic must have an IAM policy attached to it that allows Amazon S3 to publish to it. ::
23
+
24
+ {
25
+ "Version": "2008-10-17",
26
+ "Id": "example-ID",
27
+ "Statement": [
28
+ {
29
+ "Sid": "example-statement-ID",
30
+ "Effect": "Allow",
31
+ "Principal": {
32
+ "Service": "s3.amazonaws.com"
33
+ },
34
+ "Action": [
35
+ "SNS:Publish"
36
+ ],
37
+ "Resource": "arn:aws:sns:us-west-2:123456789012::s3-notification-topic",
38
+ "Condition": {
39
+ "ArnLike": {
40
+ "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
41
+ }
42
+ }
43
+ }
44
+ ]
45
45
  }
@@ -1,6 +1,6 @@
1
- The applies a notification configuration to a bucket named ``my-bucket``::
1
+ The applies a notification configuration to a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-notification --bucket my-bucket --notification-configuration file://notification.json
3
+ aws s3api put-bucket-notification --bucket amzn-s3-demo-bucket --notification-configuration file://notification.json
4
4
 
5
5
  The file ``notification.json`` is a JSON document in the current folder that specifies an SNS topic and an event type to monitor::
6
6
 
@@ -26,10 +26,10 @@ The SNS topic must have an IAM policy attached to it that allows Amazon S3 to pu
26
26
  "Action": [
27
27
  "SNS:Publish"
28
28
  ],
29
- "Resource": "arn:aws:sns:us-west-2:123456789012:my-bucket",
29
+ "Resource": "arn:aws:sns:us-west-2:123456789012:amzn-s3-demo-bucket",
30
30
  "Condition": {
31
31
  "ArnLike": {
32
- "aws:SourceArn": "arn:aws:s3:*:*:my-bucket"
32
+ "aws:SourceArn": "arn:aws:s3:*:*:amzn-s3-demo-bucket"
33
33
  }
34
34
  }
35
35
  }
@@ -3,7 +3,7 @@
3
3
  The following ``put-bucket-request-payment`` example enables ``requester pays`` for the specified bucket. ::
4
4
 
5
5
  aws s3api put-bucket-request-payment \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --request-payment-configuration '{"Payer":"Requester"}'
8
8
 
9
9
  This command produces no output.
@@ -13,7 +13,7 @@ This command produces no output.
13
13
  The following ``put-bucket-request-payment`` example disables ``requester pays`` for the specified bucket. ::
14
14
 
15
15
  aws s3api put-bucket-request-payment \
16
- --bucket my-bucket \
16
+ --bucket amzn-s3-demo-bucket \
17
17
  --request-payment-configuration '{"Payer":"BucketOwner"}'
18
18
 
19
19
  This command produces no output.
@@ -1,6 +1,6 @@
1
- The following command applies a tagging configuration to a bucket named ``my-bucket``::
1
+ The following command applies a tagging configuration to a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-tagging --bucket my-bucket --tagging file://tagging.json
3
+ aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging file://tagging.json
4
4
 
5
5
  The file ``tagging.json`` is a JSON document in the current folder that specifies tags::
6
6
 
@@ -13,6 +13,6 @@ The file ``tagging.json`` is a JSON document in the current folder that specifie
13
13
  ]
14
14
  }
15
15
 
16
- Or apply a tagging configuration to ``my-bucket`` directly from the command line::
16
+ Or apply a tagging configuration to ``amzn-s3-demo-bucket`` directly from the command line::
17
17
 
18
- aws s3api put-bucket-tagging --bucket my-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'
18
+ aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'
@@ -1,7 +1,7 @@
1
- The following command enables versioning on a bucket named ``my-bucket``::
1
+ The following command enables versioning on a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled
3
+ aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled
4
4
 
5
5
  The following command enables versioning, and uses an mfa code ::
6
6
 
7
- aws s3api put-bucket-versioning --bucket my-bucket --versioning-configuration Status=Enabled --mfa "SERIAL 123456"
7
+ aws s3api put-bucket-versioning --bucket amzn-s3-demo-bucket --versioning-configuration Status=Enabled --mfa "SERIAL 123456"
@@ -1,6 +1,6 @@
1
- The applies a static website configuration to a bucket named ``my-bucket``::
1
+ The applies a static website configuration to a bucket named ``amzn-s3-demo-bucket``::
2
2
 
3
- aws s3api put-bucket-website --bucket my-bucket --website-configuration file://website.json
3
+ aws s3api put-bucket-website --bucket amzn-s3-demo-bucket --website-configuration file://website.json
4
4
 
5
5
  The file ``website.json`` is a JSON document in the current folder that specifies index and error pages for the website::
6
6
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-object-legal-hold`` example sets a Legal Hold on the object ``doc1.rtf``. ::
4
4
 
5
5
  aws s3api put-object-legal-hold \
6
- --bucket my-bucket-with-object-lock \
6
+ --bucket amzn-s3-demo-bucket-with-object-lock \
7
7
  --key doc1.rtf \
8
8
  --legal-hold Status=ON
9
9
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-object-lock-configuration`` example sets a 50-day object lock on the specified bucket. ::
4
4
 
5
5
  aws s3api put-object-lock-configuration \
6
- --bucket my-bucket-with-object-lock \
6
+ --bucket amzn-s3-demo-bucket-with-object-lock \
7
7
  --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 50 }}}'
8
8
 
9
9
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``put-object-retention`` example sets an object retention configuration for the specified object until 2025-01-01. ::
4
4
 
5
5
  aws s3api put-object-retention \
6
- --bucket my-bucket-with-object-lock \
6
+ --bucket amzn-s3-demo-bucket-with-object-lock \
7
7
  --key doc1.rtf \
8
8
  --retention '{ "Mode": "GOVERNANCE", "RetainUntilDate": "2025-01-01T00:00:00" }'
9
9
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-object-tagging`` example sets a tag with the key ``designation`` and the value ``confidential`` on the specified object. ::
4
4
 
5
5
  aws s3api put-object-tagging \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --key doc1.rtf \
8
8
  --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }]}'
9
9
 
@@ -12,7 +12,7 @@ This command produces no output.
12
12
  The following ``put-object-tagging`` example sets multiple tags sets on the specified object. ::
13
13
 
14
14
  aws s3api put-object-tagging \
15
- --bucket my-bucket-example \
15
+ --bucket amzn-s3-demo-bucket-example \
16
16
  --key doc3.rtf \
17
17
  --tagging '{"TagSet": [{ "Key": "designation", "Value": "confidential" }, { "Key": "department", "Value": "finance" }, { "Key": "team", "Value": "payroll" } ]}'
18
18
 
@@ -3,7 +3,7 @@
3
3
  The following ``put-public-access-block`` example sets a restrictive block public access configuration for the specified bucket. ::
4
4
 
5
5
  aws s3api put-public-access-block \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --public-access-block-configuration "BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true"
8
8
 
9
9
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``select-object-content`` example filters the object ``my-data-file.csv`` with the specified SQL statement and sends output to a file. ::
4
4
 
5
5
  aws s3api select-object-content \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --key my-data-file.csv \
8
8
  --expression "select * from s3object limit 100" \
9
9
  --expression-type 'SQL' \
@@ -3,9 +3,9 @@
3
3
  The following ``upload-part-copy`` example uploads a part by copying data from an existing object as a data source. ::
4
4
 
5
5
  aws s3api upload-part-copy \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --key "Map_Data_June.mp4" \
8
- --copy-source "my-bucket/copy_of_Map_Data_June.mp4" \
8
+ --copy-source "amzn-s3-demo-bucket/copy_of_Map_Data_June.mp4" \
9
9
  --part-number 1 \
10
10
  --upload-id "bq0tdE1CDpWQYRPLHuNG50xAT6pA5D.m_RiBy0ggOH6b13pVRY7QjvLlf75iFdJqp_2wztk5hvpUM2SesXgrzbehG5hViyktrfANpAD0NO.Nk3XREBqvGeZF6U3ipiSm"
11
11
 
@@ -1,6 +1,6 @@
1
1
  The following command uploads the first part in a multipart upload initiated with the ``create-multipart-upload`` command::
2
2
 
3
- aws s3api upload-part --bucket my-bucket --key 'multipart/01' --part-number 1 --body part01 --upload-id "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R"
3
+ aws s3api upload-part --bucket amzn-s3-demo-bucket --key 'multipart/01' --part-number 1 --body part01 --upload-id "dfRtDYU0WWCCcH43C3WFbkRONycyCpTJJvxu2i5GYkZljF.Yxwh6XG7WfS2vC4to6HiV6Yjlx.cph0gtNBtJ8P3URCSbB7rjxI5iEwVDmgaXZOGgkk5nVTW16HOQ5l0R"
4
4
 
5
5
  The ``body`` option takes the name or path of a local file for upload (do not use the file:// prefix). The minimum part size is 5 MB. Upload ID is returned by ``create-multipart-upload`` and can also be retrieved with ``list-multipart-uploads``. Bucket and key are specified when you create the multipart upload.
6
6
 
@@ -3,6 +3,6 @@
3
3
  The following ``wait bucket-exists`` example pauses and continues only after it can confirm that the specified bucket exists. ::
4
4
 
5
5
  aws s3api wait bucket-exists \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  This command produces no output.
@@ -3,6 +3,6 @@
3
3
  The following ``wait bucket-not-exists`` example pauses and continues only after it can confirm that the specified bucket doesn't exist. ::
4
4
 
5
5
  aws s3api wait bucket-not-exists \
6
- --bucket my-bucket
6
+ --bucket amzn-s3-demo-bucket
7
7
 
8
8
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``wait object-not-exists`` example pauses and continues only after it can confirm that the specified object (``--key``) in the specified bucket exists. ::
4
4
 
5
5
  aws s3api wait object-exists \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --key doc1.rtf
8
8
 
9
9
  This command produces no output.
@@ -3,7 +3,7 @@
3
3
  The following ``wait object-not-exists`` example pauses and continues only after it can confirm that the specified object (``--key``) in the specified bucket doesn't exist. ::
4
4
 
5
5
  aws s3api wait object-not-exists \
6
- --bucket my-bucket \
6
+ --bucket amzn-s3-demo-bucket \
7
7
  --key doc1.rtf
8
8
 
9
9
  This command produces no output.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: awscli
3
- Version: 1.37.11
3
+ Version: 1.37.13
4
4
  Summary: Universal Command Line Environment for AWS.
5
5
  Home-page: http://aws.amazon.com/cli/
6
6
  Author: Amazon Web Services
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.11
23
23
  Classifier: Programming Language :: Python :: 3.12
24
24
  Requires-Python: >= 3.8
25
25
  License-File: LICENSE.txt
26
- Requires-Dist: botocore (==1.36.11)
26
+ Requires-Dist: botocore (==1.36.13)
27
27
  Requires-Dist: docutils (<0.17,>=0.10)
28
28
  Requires-Dist: s3transfer (<0.12.0,>=0.11.0)
29
29
  Requires-Dist: PyYAML (<6.1,>=3.10)