Merge branch 'release-1.18.16'

* release-1.18.16:
  Bumping version to 1.18.16
  Update changelog based on model updates
  New CLI examples for s3control

.changes/1.18.16.json

@@ -0,0 +1,27 @@
+[
+  {
+    "category": "``appmesh``", 
+    "description": "Update appmesh command to latest version", 
+    "type": "api-change"
+  }, 
+  {
+    "category": "``signer``", 
+    "description": "Update signer command to latest version", 
+    "type": "api-change"
+  }, 
+  {
+    "category": "``robomaker``", 
+    "description": "Update robomaker command to latest version", 
+    "type": "api-change"
+  }, 
+  {
+    "category": "``ec2``", 
+    "description": "Update ec2 command to latest version", 
+    "type": "api-change"
+  }, 
+  {
+    "category": "``guardduty``", 
+    "description": "Update guardduty command to latest version", 
+    "type": "api-change"
+  }
+]

CHANGELOG.rst

@@ -2,6 +2,16 @@
 CHANGELOG
 =========
 
+1.18.16
+=======
+
+* api-change:``appmesh``: Update appmesh command to latest version
+* api-change:``signer``: Update signer command to latest version
+* api-change:``robomaker``: Update robomaker command to latest version
+* api-change:``ec2``: Update ec2 command to latest version
+* api-change:``guardduty``: Update guardduty command to latest version
+
+
 1.18.15
 =======
 

awscli/__init__.py

@@ -17,7 +17,7 @@
 """
 import os
 
-__version__ = '1.18.15'
+__version__ = '1.18.16'
 
 #
 # Get our data path to be added to botocore's search path

awscli/examples/s3control/create-access-point.rst

@@ -0,0 +1,12 @@
+**To create an access point**
+
+The following ``create-access-point`` example creates an access point named ``finance-ap`` for the bucket ``business-records`` in account 123456789012. Before running this example, replace the access point name, bucket name, and account number with appropriate values for your use case. ::
+
+    aws s3control create-access-point \
+        --account-id 123456789012 \
+        --bucket business-records \
+        --name finance-ap
+
+This command produces no output.
+
+For more information, see `Creating Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/creating-access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/delete-access-point-policy.rst

@@ -0,0 +1,11 @@
+**To delete an access point policy**
+
+The following ``delete-access-point-policy`` example deletes the access point policy from the access point named ``finance-ap`` in account 123456789012. Before running this example, replace the access point name and account number with appropriate values for your use case. ::
+
+    aws s3control delete-access-point-policy \
+        --account-id 123456789012 \
+        --name finance-ap
+
+This command produces no output.
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/delete-access-point.rst

@@ -0,0 +1,11 @@
+**To delete an access point**
+
+The following ``delete-access-point`` example deletes an access point named ``finance-ap`` in account 123456789012. Before running this example, replace the access point name and account number with appropriate values for your use case. ::
+
+    aws s3control delete-access-point \
+        --account-id 123456789012 \
+        --name finance-ap
+
+This command produces no output.
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/get-access-point-policy-status.rst

@@ -0,0 +1,17 @@
+**To retrieve the access point policy status**
+
+The following ``get-access-point-policy-status`` example retrieves the access point policy status for the access point named ``finance-ap`` in account 123456789012. The access point policy status indicates whether the access point's policy allows public access. Before running this example, replace the access point name and account number with appropriate values for your use case. ::
+
+    aws s3control get-access-point-policy-status \
+        --account-id 123456789012 \
+        --name finance-ap
+
+Output::
+
+    {
+        "PolicyStatus": {
+            "IsPublic": false
+        }
+    }
+
+For more information about when an access point policy is considered public, see `The Meaning of "Public" <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/get-access-point-policy.rst

@@ -0,0 +1,15 @@
+**To retrieve an access point policy**
+
+The following ``get-access-point-policy`` example retrieves the access point policy from the access point named ``finance-ap`` in account 123456789012. Before running this example, replace the access point name and account number with appropriate values for your use case. ::
+
+    aws s3control get-access-point-policy \
+        --account-id 123456789012 \
+        --name finance-ap
+
+Output::
+
+    {
+        "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/Admin\"},\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/records/*\"}]}"
+    }
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/get-access-point.rst

@@ -0,0 +1,24 @@
+**To retrieve access point configuration details**
+
+The following ``get-access-point`` example retrieves the configuration details for the access point named ``finance-ap`` in account 123456789012. Before running this example, replace the access point name and account number with appropriate values for your use case. ::
+
+    aws s3control get-access-point \
+        --account-id 123456789012 \
+        --name finance-ap
+
+Output::
+
+    {
+        "Name": "finance-ap",
+        "Bucket": "business-records",
+        "NetworkOrigin": "Internet",
+        "PublicAccessBlockConfiguration": {
+            "BlockPublicAcls": false,
+            "IgnorePublicAcls": false,
+            "BlockPublicPolicy": false,
+            "RestrictPublicBuckets": false
+        },
+        "CreationDate": "2020-01-01T00:00:00Z"
+    }
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/list-access-points.rst

@@ -0,0 +1,68 @@
+**Example 1: To retrieve a list of all access points for an account**
+
+The following ``list-access-points`` example displays a list of all access points attached to buckets owned by account 123456789012. ::
+
+    aws s3control list-access-points \
+        --account-id 123456789012
+
+Output::
+
+    {
+        "AccessPointList": [
+            {
+                "Name": "finance-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "business-records"
+            },
+            {
+                "Name": "managers-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "business-records"
+            },
+            {
+                "Name": "private-network-ap",
+                "NetworkOrigin": "VPC",
+                "VpcConfiguration": {
+                    "VpcId": "1a2b3c"
+                },
+                "Bucket": "business-records"
+            },
+            {
+                "Name": "customer-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "external-docs"
+            },
+            {
+                "Name": "public-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "external-docs"
+            }
+        ]
+    }
+
+**Example 2: To retrieve a list of all access points for a bucket**
+
+The following ``list-access-points`` example retrieves a list of all access points attached to the bucket ``external-docs`` owned by account 123456789012. ::
+
+    aws s3control list-access-points \
+        --account-id 123456789012 \
+        --bucket external-docs
+
+Output::
+
+    {
+        "AccessPointList": [
+            {
+                "Name": "customer-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "external-docs"
+            },
+            {
+                "Name": "public-ap",
+                "NetworkOrigin": "Internet",
+                "Bucket": "external-docs"
+            }
+        ]
+    }
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

awscli/examples/s3control/put-access-point-policy.rst

@@ -0,0 +1,28 @@
+**To set an access point policy**
+
+The following ``put-access-point-policy`` example places the specified access point policy for the access point ``finance-ap`` in account 123456789012. If the access point ``finance-ap`` already has a policy, this command replaces the existing policy with the one specified in this command. Before running this example, replace the account number, access point name, and policy statements with appropriate values for your use case. ::
+
+    aws s3control put-access-point-policy \
+        --account-id 123456789012 \
+        --name finance-ap \
+        --policy file://ap-policy.json
+
+Contents of ``ap-policy.json``::
+
+    {
+        "Version": "2012-10-17",
+        "Statement": [
+            {
+                "Effect": "Allow",
+                "Principal": {
+                    "AWS": "arn:aws:iam::123456789012:user/Alice"
+                },
+                "Action": "s3:GetObject",
+                "Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/Alice/*"
+            }
+        ]
+    }
+
+This command produces no output.
+
+For more information, see `Managing Data Access with Amazon S3 Access Points <https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html>`__ in the *Amazon Simple Storage Service Developer Guide*.

doc/source/conf.py

@@ -52,7 +52,7 @@
 # The short X.Y version.
 version = '1.18.'
 # The full version, including alpha/beta/rc tags.
-release = '1.18.15'
+release = '1.18.16'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

setup.cfg

@@ -4,7 +4,7 @@ universal = 1
 
 [metadata]
 requires-dist =
-        botocore==1.15.15
+        botocore==1.15.16
         docutils>=0.10,<0.16
         rsa>=3.1.2,<=3.5.0
         s3transfer>=0.3.0,<0.4.0

setup.py

@@ -24,7 +24,7 @@ def find_version(*file_paths):
 
 
 install_requires = [
-    'botocore==1.15.15',
+    'botocore==1.15.16',
     'docutils>=0.10,<0.16',
     'rsa>=3.1.2,<=3.5.0',
     's3transfer>=0.3.0,<0.4.0',