Asset Managerへのアセット追加方法

Asset Managerには、Originに存在するすべてのアセットが表示されます。

互換性のあるOriginからアセットを取得するようにSourceを設定すると、Rendering APIを通じてリクエストされたアセットが自動的にインデックスされ、Asset Managerに表示されます。

アセットは、リクエストから数分後にAsset Managerに表示されます。

デフォルトでは、Imgixは毎月最大50,000件のアセットをインデックスします。これ以上をインデックスする場合は、サポートに連絡するか、addエンドポイントを使用して手動でインデックスしてください。

自動インデックスに加えて、OriginアセットをAsset Managerで利用可能にする他の方法もいくつかあります。以下のセクションで、それらの方法を説明します。

Asset Manager UI経由でのアップロード

注：Asset Managerへのアップロードは、クラウドストレージバケットにも直接アップロードされます。

代わりに、Management APIのアップロードエンドポイントを使用して、対応するクラウドストレージSourceにアセットをプログラム的にアップロードすることもできます。これにより、アセットはSourceに接続されたバケットに直接アップロードされ、Asset Managerが更新されます。

注：Asset Managerは、Web FolderおよびWeb Proxy Sourceへのアップロードには対応していません。

API経由でのアップロードを始めるには、まずアップロード認証情報を設定してください。

設定後、30MB未満のアセットをPOSTリクエストでapi/v1/sources/:source_id/upload/:origin_pathにアップロードします。リクエストボディには生のバイナリデータを入れてください。詳細はこちらを参照してください。

アップロードセッションのワークフローでは、動画のような50MBを超える大容量のアセットをアップロードできます。このプロセスは、大容量ファイルのアップロードを成功させるために、複数の連続したステップで構成されています。

アップロードセッションの流れ：

アップロードセッションを作成します。アップロードされるファイルごとに1つのセッションを作成してください。 セッションと署名付きURLは8時間有効です。
セッションの署名付きURLを使用して、HTTP PUTでファイルをアップロードします。
アップロード完了後にセッションを閉じることができます。これは必須ではありませんが、アセット処理を迅速に行うために強く推奨されます。閉じられていないセッションは8時間後に自動的に終了します。
アップロードステータスを確認して、処理状態を追跡します。有効なアップロードセッションの状態は以下を参照してください。

addエンドポイントを使用して、Asset ManagerにOriginアセットパスをキューに追加します。これはアセットをOriginにアップロードするものではなく、Asset Managerにアセットの取得を指示するものです。

アセットが正常に追加されるには、指定されたアセットパスに実際にアセットが存在し、そのパスに対してOriginが200レスポンスを返す必要があります。また、Sourceには十分な読み取り権限が必要です。

Rendering API経由でアセットをリクエストする前に、Asset Managerにアセットを登録したい場合にaddエンドポイントを使用してください。

アセットを追加するには、空のPOSTボディでsources/:source_id/assets/add/:origin-pathにPOSTリクエストを送信します。

以下はその例です：

# Request
POST api/v1/sources/5ae507164b595f0001e048bc/assets/add/marketing/logo.png
{}

Origin上のアセットに変更があった場合、Asset Managerはデフォルトで24～48時間ごとに自動で更新を行います。これにより、ファイルはOriginの内容と同期されます。

自動処理を待たずにアセットを更新したい場合は、リフレッシュエンドポイントを使用してください。

アセットをリフレッシュするリクエストを送信すると、以下の処理が行われます：

Originからアセットを再取得します。
最後に処理されたときからETagが変更されていれば、アセットを再処理します。
- アセットがこれまでにAsset Managerに取り込まれていなければ、リフレッシュエンドポイントがAsset Managerにアセットを取り込みます。
Imgixのすべてのキャッシュからアセットをパージします。更新されたアセットを表示するには、ブラウザのリフレッシュが必要な場合があります。

アセットをリフレッシュするには、空のPOSTボディでsources/:source_id/assets/refresh/:origin-pathにPOSTリクエストを送信します。

以下はその例です：

# Request
POST api/v1/sources/5ae507164b595f0001e048bc/assets/refresh/marketing/logo.png
{}