R2 (4)·续3
</details>
r2 bucket sippy enable
Enable Sippy on an R2 bucket
npmyarnpnpm
npx wrangler r2 bucket sippy enable <NAME>
yarn wrangler r2 bucket sippy enable <NAME>
pnpm wrangler r2 bucket sippy enable <NAME>
<NAME>stringrequired
The name of the bucket
- --jurisdiction string alias: --J
The jurisdiction where the bucket exists
- --provider "AWS" | "GCS"
- --bucket string The name of the upstream bucket
- --region string (AWS provider only) The region of the upstream bucket
- --access-key-id string (AWS provider only) The secret access key id for the upstream bucket
- --secret-access-key string (AWS provider only) The secret access key for the upstream bucket
- --service-account-key-file string (GCS provider only) The path to your Google Cloud service account key JSON file
- --client-email string (GCS provider only) The client email for your Google Cloud service account key
- --private-key string (GCS provider only) The private key for your Google Cloud service account key
- --r2-access-key-id string The secret access key id for this R2 bucket
- --r2-secret-access-key string The secret access key for this R2 bucket
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
r2 bucket sippy disable
Disable Sippy on an R2 bucket
npmyarnpnpm
npx wrangler r2 bucket sippy disable <NAME>
yarn wrangler r2 bucket sippy disable <NAME>
pnpm wrangler r2 bucket sippy disable <NAME>
<NAME>stringrequired
The name of the bucket
- --jurisdiction string alias: --J
The jurisdiction where the bucket exists
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
r2 bucket sippy get
Check the status of Sippy on an R2 bucket
npmyarnpnpm
npx wrangler r2 bucket sippy get <NAME>
yarn wrangler r2 bucket sippy get <NAME>
pnpm wrangler r2 bucket sippy get <NAME>
<NAME>stringrequired
The name of the bucket
- --jurisdiction string alias: --J
The jurisdiction where the bucket exists
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
r2 object
Interact with R2 objects.
Note
The r2 object commands allow you to manage application data in the Cloudflare network to be accessed from Workers using the R2 API.
r2 object get
Fetch an object from an R2 bucket
npmyarnpnpm
npx wrangler r2 object get <OBJECTPATH>
yarn wrangler r2 object get <OBJECTPATH>
pnpm wrangler r2 object get <OBJECTPATH>
<OBJECTPATH>stringrequired
The source object path in the form of {bucket}/{key}
- --file string alias: --f
The destination file to create
- --pipe boolean alias: --p
Enables the file to be piped to a destination, rather than specified with the --file option
- --local boolean Interact with local storage
- --remote boolean Interact with remote storage
- --persist-to string Directory for local persistence
- --jurisdiction string alias: --J
The jurisdiction where the object exists
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
r2 object put
Create an object in an R2 bucket
npmyarnpnpm
npx wrangler r2 object put <OBJECTPATH>
yarn wrangler r2 object put <OBJECTPATH>
pnpm wrangler r2 object put <OBJECTPATH>
<OBJECTPATH>stringrequired
The destination object path in the form of {bucket}/{key}
- --content-type string alias: --ct
A standard MIME type describing the format of the object data
- --content-disposition string alias: --cd
Specifies presentational information for the object
- --content-encoding string alias: --ce
Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field
- --content-language string alias: --cl
The language the content is in
- --cache-control string alias: --cc
Specifies caching behavior along the request/reply chain
- --expires string The date and time at which the object is no longer cacheable
- --local boolean Interact with local storage
- --remote boolean Interact with remote storage
- --persist-to string Directory for local persistence
- --jurisdiction string alias: --J
The jurisdiction where the object will be created
- --storage-class string alias: --s
The storage class of the object to be created
- --force boolean alias: --ydefault: false
Skip Basin Catalog validation prompt
- --file string alias: --f
The path of the file to upload
- --pipe boolean alias: --p
Enables the file to be piped in, rather than specified with the --file option
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
r2 object delete
Delete an object in an R2 bucket
npmyarnpnpm
npx wrangler r2 object delete <OBJECTPATH>
yarn wrangler r2 object delete <OBJECTPATH>
pnpm wrangler r2 object delete <OBJECTPATH>
<OBJECTPATH>stringrequired
The destination object path in the form of {bucket}/{key}
- --local boolean Interact with local storage
- --remote boolean Interact with remote storage
- --persist-to string Directory for local persistence
- --jurisdiction string alias: --J
The jurisdiction where the object exists
- --force boolean alias: --ydefault: false
Skip Basin Catalog validation prompt
<details>
<summary>
Global flags
</summary>
- <code>--v</code><code>boolean</code> alias: --version
Show version number - <code>--cwd</code><code>string</code>Run as if Wrangler was started in the specified directory instead of the current working directory - <code>--config</code><code>string</code> alias: --c
Path to Wrangler configuration file - <code>--env</code><code>string</code> alias: --e
Environment to use for operations, and for selecting .env and .dev.vars files - <code>--env-file</code><code>string</code>Path to an .env file to load - can be specified multiple times - values from earlier files are overridden by values in later files - <code>--install-skills</code><code>boolean</code> default: false
Install Cloudflare skills for detected AI coding agents before running the command - <code>--profile</code><code>string</code>Use a specific auth profile
</details>
Basin SQL
Note
Report Basin SQL bugs in GitHub ↗︎. Basin SQL expects the WRANGLER_BASIN_SQL_AUTH_TOKEN environment variable to be set.
npmyarnpnpm
npx wrangler basin sql query <WAREHOUSE_NAME> "SELECT * FROM <NAMESPACE>.<TABLE> LIMIT 10"
yarn wrangler basin sql query <WAREHOUSE_NAME> "SELECT * FROM <NAMESPACE>.<TABLE> LIMIT 10"
pnpm wrangler basin sql query <WAREHOUSE_NAME> "SELECT * FROM <NAMESPACE>.<TABLE> LIMIT 10"
For more information, refer to Basin SQL Wrangler commands.
Was this helpful?
YesNo
On this page
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/workers/wrangler/commands/r2/#page","headline":"R2","description":"Wrangler commands for managing Workers R2 buckets and objects.","url":"https://developers.cloudflare.com/workers/wrangler/commands/r2/","inLanguage":"en","image":"https://developers.cloudflare.com/workers/wrangler/commands/r2/og.png?v=4db980a2ba80aab2","dateModified":"2026-10-01","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
description: Wrangler commands for managing account secrets within a Secrets Store. title: Secrets Store image: https://developers.cloudflare.com/workers/wrangler/commands/secrets-store/og.png?v=38356ae9c1b92267
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/workers/llms.txt
Use this file to discover all available pages before exploring further.
Docs