From 9a0ae4434cb8ae7eba485344bb2c7e0f69dcf6c7 Mon Sep 17 00:00:00 2001
From: Tales Lelo da Aparecida <tales.aparecida@gmail.com>
Date: Sun, 9 Oct 2022 01:15:39 -0300
Subject: [PATCH] aws-s3-ls: add page (#8619)

---
 pages/common/aws-s3-ls.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/aws-s3-ls.md

diff --git a/pages/common/aws-s3-ls.md b/pages/common/aws-s3-ls.md
new file mode 100644
index 000000000..eb8ab6c6c
--- /dev/null
+++ b/pages/common/aws-s3-ls.md
@@ -0,0 +1,28 @@
+# aws s3 ls
+
+> List AWS S3 buckets, folders (prefixes), and files (objects).
+> More information: <https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html>.
+
+- List all buckets:
+
+`aws s3 ls`
+
+- List files and folders in the root of a bucket (`s3://` is optional):
+
+`aws s3 ls s3://{{bucket_name}}`
+
+- List files and folders directly inside a directory:
+
+`aws s3 ls {{bucket_name}}/{{path/to/directory}}/`
+
+- List all files in a bucket:
+
+`aws s3 ls --recursive {{bucket_name}}`
+
+- List all files in a path with a given prefix:
+
+`aws s3 ls --recursive {{bucket_name}}/{{path/to/directory/}}{{prefix}}`
+
+- Display help:
+
+`aws s3 ls help`