SaaS 向け Early Hints

Early Hints を使うと、オリジンサーバーがレスポンス全体を組み立てているあいだに、ブラウザーがリソースの読み込みを始められます。エンドユーザー向けのページ読み込みが速くなります。SaaS プロバイダーとして、一部のカスタムホスト名では速度を優先したいことがあります。カスタムメタデータを使うと、カスタムホスト名ごとに Early Hints を有効化できます。

前提条件

SaaS 向け Early Hints を使う前に、カスタムホスト名を作成する必要があります。まだの場合は Cloudflare for SaaS のスタートガイドを確認してください。

API でカスタムホスト名ごとに Early Hints を有効にする

Cloudflare ダッシュボードでゾーン ID を確認します。
API Tokens ↗ ページの Global API Key で Authentication Key を確認します。
新しいカスタムホスト名を作成する場合は、次の例のように "early_hints": "on" を指定して API を呼び出します。

Required API token permissions

At least one of the following token permissions is required:

SSL and Certificates Write

Create Custom Hostnamebash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "<CUSTOM_HOSTNAME>",
		"ssl": {
				"method": "http",
				"type": "dv",
				"settings": {
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on",
						"early_hints": "on"
				},
				"bundle_method": "ubiquitous",
				"wildcard": false
		}
	}'

既存のカスタムホスト名の場合は、GET 呼び出しでそのホスト名の id を確認します。

Required API token permissions

At least one of the following token permissions is required:

SSL and Certificates Write
SSL and Certificates Read

List Custom Hostnamesbash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames?hostname=%7Bhostname%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

次の例のように、"early_hints": "on" を指定して API を呼び出します。

Required API token permissions

At least one of the following token permissions is required:

SSL and Certificates Write

Edit Custom Hostnamebash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames/$CUSTOM_HOSTNAME_ID" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"ssl": {
				"method": "http",
				"type": "dv",
				"settings": {
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on",
						"early_hints": "on"
				}
		}
	}'

現時点では、settings 内のすべてのオプションを指定する必要があります。含めないとデフォルト値に戻るためです。Early Hints を更新する前に、ホスト名の id を返す出力を使って、現在の設定を取得できます。