# AWS CLI

### Overview

AWS CLI is a command-line tool for working with S3-compatible object storage.

Use it with **vStorage (HCM04)** by pointing commands to this S3 endpoint:

`https://hcm04.vstorage.vngcloud.vn`

Use AWS CLI when you need to:

* Script bucket and object operations (CI/CD, backups, migrations).
* Batch upload, download, sync, and presign URLs.
* Troubleshoot access issues with repeatable commands.

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

### What you need before starting

* A vStorage project in **HCM04**.
* The S3 endpoint (for `--endpoint-url`): `https://hcm04.vstorage.vngcloud.vn`
* An S3 Access Key + Secret Key for that project. See [Create a S3 key](https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-hcm04/bat-dau-voi-object-storage/buoc-2-khoi-tao-s3-key).
* AWS CLI installed on your machine. See [install aws-cli](https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-hcm04/3rd-party-softwares/aws-cli/integrate-aws-cli-with-vstorage).

### Quick connectivity check

Run a simple `list buckets` command after configuration:

```bash
aws s3 ls \
  --endpoint-url https://hcm04.vstorage.vngcloud.vn \
  --profile hcm04-prod
```

{% hint style="info" %}
**Important note**

From **AWS CLI v2.23.0+**, AWS enables the checksum algorithm `CRC64_NVME` by default.

vStorage currently supports `CRC32`, `CRC32C`, `SHA1`, and `SHA256`.

* Prefer **AWS CLI < v2.23.0** to avoid incompatibilities.
* If you use **AWS CLI v2.23.0+**, set this after installation:

  ```bash
  aws configure set request_checksum_calculation when_required --profile hcm04-prod
  ```

{% endhint %}

***

## **Detail**

* [Integrate AWS CLI with vStorage](https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-hcm04/3rd-party-softwares/broken-reference)
* [Using AWS CLI](https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-hcm04/3rd-party-softwares/broken-reference)