アセットをアセットマネージャに追加する方法

アセットマネージャは、すべてのアセットのサムネイルを視覚的に表示するインターフェースを提供し、内容をすばやく確認できます。アセットマネージャを設定した後、アセットをアセットマネージャに追加する方法はいくつかあります。

オリジンにアップロード

互換性のあるオリジンからアセットを取得するようにソースを設定すると、レンダリングAPIを介してリクエストされたアセットをシステムがクロールします。これにより、これらのアセットがアセットマネージャに自動的に表示されます。クロールプロセスは約30分ごとに行われます。

プレミアム顧客は、レンダリングAPIを介してアクセスされたアセットだけでなく、バケット内のすべてのアセットをクロールする機能を持っています。詳細については、アカウントマネージャまたはサポートチームにお問い合わせください。

アセットマネージャUIを介したアップロード

注: アセットマネージャへのアップロードは、クラウドストレージバケットに直接アップロードされます。

imgix ダッシュボード (opens in a new tab)に移動します。
アセットボタンをクリックします。
オリジン画像を追加ボタンをクリックします。
新しいアセットをアップロードオプションをクリックします。
アップロードするアセットを選択します。
アップロードボタンをクリックします。

管理APIを介したアップロード

imgix管理APIを使用すると、クラウドストレージにバックアップされたソース（Azure、GCS、S3、CloudFlare R2、DigitalOcean、Linode、またはWasabi）に直接アップロードできます。APIは、ソースが読み取るように構成された同じバケットにアップロードし、アセットマネージャに追加されます。

注: アセットマネージャはWebフォルダおよびWebプロキシソースをサポートしていません。

APIを介してアップロードを開始するには、まずアップロード資格情報を構成していることを確認する必要があります。

設定が完了すると、サイズが50MB未満のアセットをapi/v1/sources/:source_id/upload/:origin_pathパスにPOSTリクエストを送信し、リクエストの本文に生のバイナリデータを含めることでアップロードできます。詳細についてはこちらをご覧ください：

アップロードセッションを使用したアップロード

50MBを超えるアセット（ビデオなど）をアップロードするには、アップロードセッションフローを使用することをお勧めします。これは、セッションを作成し、そのセッションにファイルをアップロードし、最終的にセッションを閉じる、複数の部分からなる順次フローです。

アップロードセッションフロー：

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

`Add`エンドポイントを使用してアセットを追加する

addエンドポイントは、オリジンからアセットマネージャに追加されるパスをキューに入れます。このエンドポイントはオリジンにアセットをアップロードしませんが、オリジンからアセットを取得してアセットマネージャに追加するように指示します。

アセットが正常に追加されるための条件：

アセットパスが存在する必要があります。
アセットパスがオリジンから200応答を返す必要があります。
ソースに十分な読み取り権限が必要です。

addエンドポイントは、オリジンからアセットを個別にクロールして、2〜3時間のクロール間隔を回避したい場合に役立ちます。

アセットを追加するには、sources/:source_id/assets/add/:origin-pathに空のPOST本文でPOSTリクエストを発行します。

例を示します：

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

アセットリフレッシュの使用

オリジンで変更されたアセットは、24〜48時間ごとに自動的に更新されます。これにより、アセットマネージャ内のファイルがオリジンでホストされている内容を反映するように「リフレッシュ」されます。

refreshエンドポイントを使用すると、自動化プロセスを待たずにアセットマネージャ内のアセットをリフレッシュできます。

アセットをリフレッシュするリクエストを行うと：

オリジンからアセットを再取得します。
アセットのETag (opens in a new tab)が最後に処理されたときから変更されている場合、アセットを再処理します。
- アセットがアセットマネージャに一度もプルされていない場合、リフレッシュエンドポイントはアセットをアセットマネージャにプルします。
すべてのimgixキャッシュからアセットをパージします。更新されたアセットを表示するには、ブラウザをリフレッシュする必要がある場合があります。

アセットをリフレッシュするには、sources/:source_id/assets/refresh/:origin-pathに空のPOST本文でPOSTリクエストを発行します。