From c7ba28e557b43da5409b4b8690f8c56dea987055 Mon Sep 17 00:00:00 2001
From: Angira Kekteeva <kira@nspcc.ru>
Date: Wed, 23 Jun 2021 19:44:44 +0300
Subject: [PATCH] [#77] readme: add aws-cli usage

Signed-off-by: Angira Kekteeva <kira@nspcc.ru>
---
 README.md | 85 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/README.md b/README.md
index 1660cfcd..a8b65dce 100644
--- a/README.md
+++ b/README.md
@@ -238,6 +238,91 @@ secret stored on the NeoFS network:
 }
 ```
 
+## AWS CLI usage
+
+### Configuration
+
+#### Credentials
+
+To configure basic settings that the AWS CLI uses to interact with the Gateway, do the following steps:
+
+1. issue a secret with neofs-authmate tool (see [NeoFS Authmate] (#neofs-authmate))
+2. execute the command
+```
+$ aws configure
+```
+after you enter this command, the AWS CLI will prompt you for four pieces of information, like in this example
+(replace with your own values):
+```
+AWS Access Key ID [None]: 5g933dyLEkXbbAspouhPPTiyLZRg4axBW1axSPD87eVT_AiXsH4AjYy1iTJ4C1WExzjBrSobJsQFWEyKLREe5sQYM
+AWS Secret Access Key [None]: 438bbd8243060e1e1c9dd4821756914a6e872ce29bf203b68f81b140ac91231c
+Default region name [None]: ru 
+Default output format [none]: json 
+```
+
+### Basic usage
+
+> **_NOTE:_** To specify IP and port of the gate, append `--endpoint-url https://%IP:%PORT` to your commands.
+
+#### Bucket
+
+##### Obtainment of a list of buckets 
+
+To view the list of the buckets in the NeoFS node, to which the gateway is connected, enter the command:
+```
+$ aws s3 ls 
+```
+
+##### Creation of a bucket
+
+At this moment, the gateway supports only canned ACL and doesn't support the setting of location constraints.
+
+To create a bucket, run the command:
+```
+$ aws s3api create-bucket --bucket %BUCKET_NAME --acl %ACL
+```
+where `%ACL` can be represented by a hex encoded value or by keywords `public-read-write`, `private`, `public-read`. 
+If the parameter is not set, the default value is `private`.
+
+
+
+##### Deletion of a bucket 
+
+To delete a bucket, execute the following command:
+```
+$ aws s3api delete-bucket --bucket %BUCKET_NAME
+```
+
+#### Object
+
+##### Obtainment of a list of objects
+
+To view the list of the objects in a bucket, run:
+```
+$ aws s3api list-objects --bucket %BUCKET_NAME 
+```
+
+##### Upload of a file
+
+To upload the file into a bucket in the NeoFS network, run the following command:
+```
+$ aws s3api put-object --bucket %BUCKET_NAME --key %OBJECT_KEY --body  %FILEPATH
+```
+where %OBJECT_KEY is a filename of an object in NeoFS
+
+#### Download of a file
+
+To download the file from a bucket in the NeoFS Network, execute:
+```
+$ aws s3api get-object --bucket  %BUCKET_NAME --key %OBJECT_KEY
+```
+
+#### Deletion of a file
+To delete the file:
+```
+$ aws s3api delete-object --bucket %BUCKET_NAME --key %FILE_NAME
+```
+
 ## S3 API supported
 
 Reference: