カスタムパスを使用してアップロード

Cloudflare Imagesのユニバーサルユニーク識別子（UUID）によって自動生成されたパスの代わりに、カスタムIDパスを使用して画像をアップロードできます。

カスタムパスは以下をサポートします：

• 最大1,024文字。
• 任意の数のサブパス。
• 文字のためのUTF-8エンコーディング標準 ↗。

ノート

カスタムIDパスを持つ画像は、署名付きURLトークンを使用してプライベートにすることはできません。また、画像を配信する際には、カスタムIDに含まれる%文字は、画像配信URL内で%25にエンコードする必要があります。

以下の例を参考にしてPOSTリクエストを作成します。URL経由または直接ファイルアップロードでアップロードする際にカスタムIDパスを使用できます。

curl --request POST https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1 \
--header "Authorization: Bearer <API_TOKEN>" \
--form 'url=https://<REMOTE_PATH_TO_IMAGE>' \
--form 'id=<PATH_TO_YOUR_IMAGE>'

画像のアップロードが成功すると、以下の例に似たレスポンスが返されます。

{
  "result": {
    "id": "<PATH_TO_YOUR_IMAGE>",
    "filename": "<YOUR_IMAGE>",
    "uploaded": "2022-04-20T09:51:09.559Z",
    "requireSignedURLs": false,
    "variants": ["https://imagedelivery.net/Vi7wi5KSItxGFsWRG2Us6Q/<PATH_TO_YOUR_IMAGE>/public"]
  },
  "result_info": null,
  "success": true,
  "errors": [],
  "messages": []
}