Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

定義済みバリアントを作成する

最終更新 Markdown で表示Agent セットアップ

バリアントでは、用途ごとに画像のリサイズ方法を指定できます。デフォルトでは画像は public バリアントで配信されます。必要に応じて最大 100 個までバリアントを作成できます。次の手順でバリアントを作成します。

  1. Cloudflare dashboard で、Hosted Images ページを開きます。

    公式ダッシュボードで Hosted images を開く ↗
  2. Delivery タブを選択します。

  3. Create variant を選択します。

  4. バリアント名を入力し、Create を選択します。

  5. 新しいバリアントの変数を定義します。リサイズオプション、フィットの種類、メタデータの扱いなどを指定します。

API でリサイズする

バリアントを作成する には、POST リクエストを送信します。

curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/variants" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{"id":"<NAME_OF_THE_VARIANT>","options":{"fit":"scale-down","metadata":"none","width":1366,"height":768},"neverRequireSignedURLs":true}

フィットオプション

Fit プロパティは、幅と高さの寸法の解釈方法を表します。各オプションの動作は次の表のとおりです。

フィットオプション 動作
Scale down 指定した幅または高さに収まるよう画像を縮小します。拡大はしません。
Contain アスペクト比を保ったまま、指定した幅または高さの範囲内で可能な限り大きくなるよう、画像を縮小または拡大します。
Cover 指定した幅と高さの領域をちょうど埋めるよう画像をリサイズします。必要に応じて切り抜きます。
Crop 指定した幅と高さの領域に収まるよう、画像を縮小して切り抜きます。拡大はしません。指定寸法より小さい画像では scale-down と同じです。大きい画像では cover と同じです。
Pad アスペクト比を保ったまま、指定した幅または高さの範囲内で可能な限り大きくなるよう、画像を縮小または拡大します。余白は背景色(デフォルトは白)で埋めます。

メタデータオプション

バリアントでは、画像のメタデータをどう扱うかを選べます。Metadata ドロップダウンから次のいずれかを選択します。

  • すべてのメタデータを削除する
  • 著作権以外のメタデータを削除する
  • すべてのメタデータを保持する

公開アクセス

Always allow public access をオンにすると、署名付き URL で画像を非公開にした場合でも、そのバリアントは常に公開アクセスできます。

役に立ちましたか?