Missing jurisdiction in binding examples (R2)

[Mael-Abgrall]

Existing documentation URL(s)

In the tutorial on how to use R2 with bindings, there is a missing bit of important documentation (this page https://developers.cloudflare.com/r2/api/workers/workers-api-usage/#3-bind-your-bucket-to-a-worker)

Wrangler CLI will refuse to deploy when the jurisdiction is missing and the bucket is using regional services

What changes are you suggesting?

add to the doc the following:

{
  "r2_buckets": [
    {
      "binding": "MY_BUCKET",
      "bucket_name": "<YOUR_BUCKET_NAME>"
      "jurisdiction": "eu", // When the bucket is using regional services, leave empty otherwise
    }
  ]
}

Additional information

No response

[Oxyjun]

Hey @Mael-Abgrall , thanks for creating the issue.

Can I check what you mean by "regional services"?

The chapter you've linked is designed to showcase the minimal possible form of binding, as the binding can be as complex (or not complex) as a user might need.

The link just below the Wrangler snippet takes you to https://developers.cloudflare.com/workers/wrangler/configuration/, which contains more information about specifying R2 jurisdiction binding (https://developers.cloudflare.com/r2/reference/data-location/#jurisdictional-restrictions).

[Mael-Abgrall]

By regional services, I meant the jurisdiction

My bad, too many things on my plate and did not see all the documentation

[Oxyjun]

By regional services, I meant the jurisdiction

My bad, too many things on my plate and did not see all the documentation

Gotcha, thanks for clarifying! I've added a sentence to draw more attention to the Wrangler docs via #24055.

Hope this addresses the issue!

[Mael-Abgrall]

thank you!