Regional Hostnames は Regional Services の最も一般的な使い方です。プロキシ済みホスト名にリージョンを割り当てると、Cloudflare はそのホスト名のトラフィックを、共有 anycast IP アドレスを使ってリージョン内のデータセンターへ誘導し、TLS 終端と処理を行います。トラフィックを地域化する他の方法は、Regional Services の使い方 を参照してください。
Regional Hostnames は managed regions に対応しています。カスタムリージョンが必要な場合は、代わりに Regionalized Spectrum Applications または Regionalized IP Bindings を使います。
Regional Hostnames はダッシュボードまたは API で設定できます。
Regional Services を使うには、まずダッシュボードで DNS レコードを作成します。
-
Cloudflare ダッシュボードで Records ページを開きます。
Records を開く ↗ -
次の手順で DNS レコードを作成 します。
-
Region ドロップダウンから、ドメインで使うリージョンを選びます。この値は、同じホスト名のすべての DNS レコードに適用されます。同じホスト名の DNS レコードが 2 つあり、一方のリージョンを変更すると、両方のレコードが同じリージョンになります。
利用可能なリージョン、定義、製品対応の一覧は、利用可能なリージョンと製品サポート の表を参照してください。
Regional Services は API でも利用できます。
Super Administrator、Administrator、または Domain Administrator のロールを持つユーザーは、Regional Services の設定を編集できます。Domain Administrator Read Only ロールには、現時点では Regional Services 設定の読み取り権限は含まれません。/addressing/ エンドポイントの読み取りまたは書き込みには、DNS: Read/Write の API 権限を使います。
API リクエストの例をいくつか示します。
利用可能なリージョンを一覧する
Required API token permissions
At least one of the following token permissions is required:DNS ReadDNS Write
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/regional_hostnames/regions" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"success": true,
"errors": [],
"result": [
{
"key": "ca",
"label": "Canada"
},
{
"key": "eu",
"label": "Europe"
}
],
"messages": []
}新しい regional hostname エントリを作成する
Required API token permissions
At least one of the following token permissions is required:DNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"hostname": "ca.regional.ipam.rocks",
"region_key": "ca"
}'{
"success": true,
"errors": [],
"result": {
"hostname": "ca.regional.ipam.rocks",
"region_key": "ca",
"created_on": "2023-01-13T23:59:45.276558Z"
},
"messages": []
}ゾーンの regional hostname を一覧する、または特定のエントリを取得する
Required API token permissions
At least one of the following token permissions is required:DNS ReadDNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"success": true,
"errors": [],
"result": [
{
"hostname": "ca.regional.ipam.rocks",
"region_key": "ca",
"created_on": "2023-01-14T00:47:57.060267Z"
}
],
"messages": []
}特定ゾーンの regional hostname を取得する
Required API token permissions
At least one of the following token permissions is required:DNS ReadDNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
--request GET \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"success": true,
"errors": [],
"result": {
"hostname": "ca.regional.ipam.rocks",
"region_key": "ca",
"created_on": "2023-01-13T23:59:45.276558Z"
},
"messages": []
}特定ホスト名のリージョンを更新する
Required API token permissions
At least one of the following token permissions is required:DNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
--request PATCH \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"region_key": "eu"
}'{
"success": true,
"errors": [],
"result": {
"hostname": "ca.regional.ipam.rocks",
"region_key": "eu",
"created_on": "2023-01-13T23:59:45.276558Z"
},
"messages": []
}リージョン設定を削除する
Required API token permissions
At least one of the following token permissions is required:DNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/addressing/regional_hostnames/$HOSTNAME" \
--request DELETE \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"{
"success": true,
"errors": [],
"result": null,
"messages": []
}リージョンマップが正しく適用されていることを確認するには、Zero Trust Network Session ログ の IngressColoName フィールドを確認します。このフィールドは、トラフィックがイングレスした Cloudflare データセンターの名前を示します。地域化は Gateway の上流で適用されるため、イングレスデータセンターは設定したリージョンマップ内にあり、トラフィックが正しいリージョンで処理されていることが確認できます。
Terraform でも Regional Services を設定できます。詳細は、Terraform ドキュメントの cloudflare_regional_hostname リソース ↗ を参照してください。