# How to Use AWS CLI with Stook

The **AWS CLI** is a command-line tool that can be used to transfer data to **Medianova Stook Object Storage**, which is fully compatible with S3 storage services. You can install AWS CLI on Windows, macOS, and Linux to configure Stook, create buckets, and manage objects.

***

### Prerequisites

* AWS CLI installed
* Medianova Stook credentials:
  * **Server**
  * **Access Key**
  * **Secret Key**
* Python (for macOS/Linux installations with pip)

⚠️ Your account information is private. Do not share it.

***

### Installation

#### Windows

1. Download the AWS CLI installer from [AWS CLI official website](https://aws.amazon.com/cli/).
2. Run the setup file (choose 32-bit or 64-bit version).
3. Accept the license agreement, click **Next**, then **Install**.
4. Finish the installation with the **Finish** button.

*Caption: Windows installation wizard for AWS CLI*

#### macOS / Linux

Install AWS CLI with pip:

```bash
pip install awscli
```

***

### Configuration

Run the following command to configure credentials:

```bash
aws configure
AWS Access Key ID [None]: xxxxxxxxxxxxxxxxxx
AWS Secret Access Key [None]: yyyyyyyyyyyyyyyyyyy
Default region name [None]: ENTER
Default output format [None]: ENTER
```

Example credentials:

* **Server**: `xxxxx.mncdn.com`
* **Access Key**: `xxxxxxxxxxxxxxxxxxxx`
* **Secret Key**: `yyyyyyyyyyyyyyyyyyyy`

***

### Commands

#### List Buckets

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 ls
```

#### List Contents in a Bucket

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 ls s3://testbucket1
```

#### Create a Bucket

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 mb s3://bucket2
```

#### Add Objects to a Bucket

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 cp hello_world.txt s3://mybucket
```

#### Delete Objects

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 rm s3://mybucket/hello_world.txt
```

#### Remove Buckets

```bash
aws --endpoint-url https://xxxxx.mncdn.com s3 rb s3://mybucket
```

***

### Troubleshooting / FAQ

* **Command not found:** Ensure AWS CLI is installed and added to PATH.
* **Authentication error:** Verify Access Key, Secret Key, and endpoint URL.
* **Permission denied:** Confirm you are using correct credentials.

***

### References

* [AWS CLI Official Website](https://aws.amazon.com/cli/)