---
title: aws CLI
description: Use the aws CLI to interact with Cloudflare R2 via the S3-compatible API.
image: https://developers.cloudflare.com/dev-products-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/r2/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

# aws CLI

You must [generate an Access Key](https://developers.cloudflare.com/r2/api/tokens/) before getting started. All examples will utilize `access_key_id` and `access_key_secret` variables which represent the **Access Key ID** and **Secret Access Key** values you generated.

  
With the [aws ↗](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) CLI installed, you may run [aws configure ↗](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) to configure a new profile. You will be prompted with a series of questions for the new profile's details.

Terminal window

```
aws configure
```

```
AWS Access Key ID [None]: <ACCESS_KEY_ID>AWS Secret Access Key [None]: <SECRET_ACCESS_KEY>Default region name [None]: autoDefault output format [None]: json
```

The `region` value can be set to `auto` since it is required by the SDK but not used by R2.

You may then use the `aws` CLI for any of your normal workflows.

Terminal window

```
# Provide your Cloudflare account IDaws s3api list-buckets --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com# {#     "Buckets": [#         {#             "Name": "my-bucket",#             "CreationDate": "2022-05-18T17:19:59.645000+00:00"#         }#     ],#     "Owner": {#         "DisplayName": "134a5a2c0ba47b38eada4b9c8ead10b6",#         "ID": "134a5a2c0ba47b38eada4b9c8ead10b6"#     }# }
aws s3api list-objects-v2 --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com --bucket my-bucket# {#     "Contents": [#         {#             "Key": "ferriswasm.png",#             "LastModified": "2022-05-18T17:20:21.670000+00:00",#             "ETag": "\"eb2b891dc67b81755d2b726d9110af16\"",#             "Size": 87671,#             "StorageClass": "STANDARD"#         }#     ]# }
```

## Generate presigned URLs

You can also generate presigned links which allow you to share public access to a file temporarily.

Terminal window

```
# You can pass the --expires-in flag to determine how long the presigned link is valid.aws s3 presign --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com  s3://my-bucket/ferriswasm.png --expires-in 3600# https://<ACCOUNT_ID>.r2.cloudflarestorage.com/my-bucket/ferriswasm.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=<credential>&X-Amz-Date=<timestamp>&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=<signature>
```

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/r2/examples/aws/aws-cli/#page","headline":"aws CLI · Cloudflare R2 docs","description":"Use the aws CLI to interact with Cloudflare R2 via the S3-compatible API.","url":"https://developers.cloudflare.com/r2/examples/aws/aws-cli/","inLanguage":"en","image":"https://developers.cloudflare.com/dev-products-preview.png","dateModified":"2026-04-21","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/r2/","name":"R2"}},{"@type":"ListItem","position":3,"item":{"@id":"/r2/examples/","name":"Examples"}},{"@type":"ListItem","position":4,"item":{"@id":"/r2/examples/aws/","name":"S3 SDKs"}},{"@type":"ListItem","position":5,"item":{"@id":"/r2/examples/aws/aws-cli/","name":"aws CLI"}}]}
```