aws-s3api: add page

pages/common/aws-s3api.md

@@ -0,0 +1,36 @@
+# aws s3api
+
+> Create and delete s3 buckets, and edit bucket properties.
+> More information: <https://docs.aws.amazon.com/cli/latest/reference/s3api/>.
+
+- Create a bucket:
+
+`aws s3api create-bucket --bucket my-bucket`
+
+- Delete a bucket:
+
+`aws s3api delete-bucket --bucket {{bucket_name}}`
+
+- List buckets:
+
+`aws s3api list-buckets`
+
+- List the objects inside of a bucket, and only show each object's key and size:
+
+`aws s3api list-objects --bucket {{bucket_name}} --query 'Contents[].{Key: Key, Size: Size}'`
+
+- Add an object to a bucket:
+
+`aws s3api put-object --bucket {{bucket_name}} --key {{object_key}} --body {{path/to/file}}`
+
+- Download object from a bucket (The output file is always the last argument):
+
+`aws s3api get-object --bucket {{bucket_name}} --key {{object_key}} {{path/to/output_file}}`
+
+- Apply an Amazon S3 bucket policy to a specified bucket:
+
+`aws s3api put-bucket-policy --bucket {{bucket_name}} --policy file://{{path/to/bucket_policy.json}}`
+
+- Download the Amazon S3 bucket policy from a specified bucket:
+
+`aws s3api get-bucket-policy --bucket {{bucket_name}} --query Policy --output text > {{path/to/bucket_policy.json}}``