# AWS CLI

### Overview

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

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

`https://han02.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 **HAN02**.
* The S3 endpoint (for `--endpoint-url`): `https://han02.vstorage.vngcloud.vn`
* An S3 Access Key + Secret Key for that project. See [Create a S3 key](/vng-cloud-document/vstorage/object-storage/object-storage-han02/getting-started-with-object-storage/step-4-create-a-s3-key.md).
* AWS CLI installed on your machine. See [install aws-cli](/vng-cloud-document/vstorage/object-storage/object-storage-han02/3rd-party-softwares/aws-cli/integrate-aws-cli-with-vstorage.md).

### Quick connectivity check

Run a simple `list buckets` command after configuration:

```bash
aws s3 ls \
  --endpoint-url https://han02.vstorage.vngcloud.vn \
  --profile han02-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 han02-prod
  ```

{% endhint %}

### Next steps

* [Integrate AWS CLI with vStorage](/vng-cloud-document/vstorage/object-storage/object-storage-han02/3rd-party-softwares/aws-cli/integrate-aws-cli-with-vstorage.md)
* [Using AWS CLI](/vng-cloud-document/vstorage/object-storage/object-storage-han02/3rd-party-softwares/aws-cli/using-aws-cli.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vngcloud.vn/vng-cloud-document/vstorage/object-storage/object-storage-han02/3rd-party-softwares/aws-cli.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.