# リージョンとデータの保存地域

リクエストを送信できるリージョン別のベース URL、プランごとに利用できるリージョン、そして処理が1つのリージョン内にとどまるとはどういうことかを説明します。

PDF Blocks のすべてのアクションは、リクエスト先に指定したリージョンで実行されます。ベース URL を選べば、ドキュメントはそこで処理され、それ以外の場所では処理されません。リージョンを選ぶことは、URL のホストを入れ替えるだけの単純な作業です。どのリージョンも17個のアクションからなる全カタログを、同じ稼働率で提供します。

## リージョン別エンドポイント

処理したいリージョンのベース URL にリクエストを送信します。

| リージョン         | ベース URL                          |
| -------------- | --------------------------------- |
| グローバル         | `https://api.pdfblocks.com`       |
| 日本          | `https://jp.api.pdfblocks.com`    |
| 米国  | `https://us.api.pdfblocks.com`    |
| HIPAA 米国       | `https://hipaa.api.pdfblocks.com` |
| 欧州連合 | `https://eu.api.pdfblocks.com`    |
| 英国 | `https://uk.api.pdfblocks.com`    |
| カナダ         | `https://ca.api.pdfblocks.com`    |
| オーストラリア      | `https://au.api.pdfblocks.com`    |
| インド          | `https://in.api.pdfblocks.com`    |
| ブラジル         | `https://br.api.pdfblocks.com`    |

上記のリージョンはすべて稼働しており、完全なアクションカタログを提供し、同じ稼働率が保証されています。**グローバル** エンドポイントは各リクエストを最も近いインフラへルーティングして最小のレイテンシーを実現し、名前付きのリージョンエンドポイントは処理を特定の法域に固定します。

## プランごとの利用可能リージョン

アドレスできるリージョンは、プランによって異なります。

- **Free**：グローバル。
- **Starter**：グローバル、米国、欧州。
- **Business**：上記のすべてのリージョン。

詳しい内訳は [料金](/pricing) を参照してください。

## 「処理がリージョン内にとどまる」とは

リージョンのベース URL に送られたリクエストは、そのリージョン内だけで完全に処理されます。アップロードされたファイルは、その法域のインフラによって受信、変換され、返送されます。他の場所に移動して処理されることはありません。

この API は **ステートレス** なため、保存するものは何もありません。ドキュメントはリクエストが処理されている間だけメモリ上に存在します。レスポンスがストリーミングされて返された時点で、入力と出力は消えます。呼び出し完了後にファイルを保持するバケットもデータベースもキューもありません。したがって、データの保存地域は、どのホストにリクエストを送るかという1つの選択だけで決まります。

## HIPAA 米国のエンドポイント

`https://hipaa.api.pdfblocks.com` は、HIPAA が定める保護対象保健情報（PHI）を扱うワークフロー向けに運用されている、米国内のエンドポイントです。コンプライアンスプログラム上、PDF 処理を HIPAA 準拠環境で実行する必要がある場合は、リクエストをここに送信してください。他のすべてのリージョンと同様にステートレスであり、全アクションカタログを実行します。

## リージョンを選ぶ

データの処理が許可されている場所に合わせて、リージョンを選んでください。

- **グローバル**：デフォルト。最良のレイテンシーで、保存地域の制約はありません。
- **欧州連合**（`eu.`）：GDPR やその他の EU のデータ保存地域要件に対応するため、処理を EU 内にとどめます。
- **英国**（`uk.`）：処理を英国内にとどめます。
- **米国**（`us.`）と **HIPAA 米国**（`hipaa.`）：米国内で処理します。PHI を扱うワークフローには HIPAA エンドポイントを使用してください。
- **カナダ**（`ca.`）、**オーストラリア**（`au.`）、**日本**（`jp.`）、**インド**（`in.`）、**ブラジル**（`br.`）：現地のデータ保存地域規則を満たすため、その国の中で処理します。

要件が単に「これをリージョン X 内にとどめる」ことであれば、そのリージョンのホストにすべてのリクエストを送るだけで完了です。

## リージョンを切り替える

リージョンの切り替えは1行の変更で済みます。パス、パラメーター、API キーはそのままにして、ホストだけを変更します。次の例は、[テキスト透かしを追加する](/docs/api/add-text-watermark-to-pdf) をグローバルではなく EU で実行します。

```bash title="cURL"
# Global
curl https://api.pdfblocks.com/v1/add_text_watermark \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F line_1='CONFIDENTIAL' \
  -o watermarked.pdf

# European Union: same request, EU host
curl https://eu.api.pdfblocks.com/v1/add_text_watermark \
  -H 'X-API-Key: your_api_key' \
  -F file=@input.pdf \
  -F line_1='CONFIDENTIAL' \
  -o watermarked.pdf
```

あなたの [API キー](/docs/api/authentication) はすべてのリージョンで機能します。リージョンごとにキーを管理する必要はありません。各呼び出しが共有する形については [リクエストとレスポンス](/docs/api/requests-and-responses) を参照してください。