アップロード API (V1)
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
アップロード API を使用すると、Sitecore Content Hub™ Web UI 以外のクライアントからアップロードできます。たとえば、Sitecore Connect for Creative Cloud™ を使用できます。
アップロード API は、次のエンドポイントを公開します。
api/v1.0/upload: アップロード URL を要求します。api/v1.0/upload/assets: すでにアップロードされているファイルから新しいアセットをアップロード (作成) します。api/v1.0/upload/assets/{id}: 既存のアセットのマスター ファイルをアップロードします。api/v1.0/upload/assets/{id}/alternative: 既存のアセットの代替ファイルをアップロードします。
完全なアップロード フローは、次の 3 つのステップで構成されます。
アップロード URL の要求
アップロード URL の要求
アップロード URL を取得するには、POST 要求をエンドポイント api/v1.0/upload に送信します。
要求フォームの本文には、次のフィールドが含まれている必要があります。
fileName- アップロードするファイルの名前。fileSize-アップロードするファイルのサイズ。
成功した応答では、アップロード URL を含むロケーション ヘッダーと、次のように構造化された情報を含む JSON 本文が返されます。
fileIdentifierは、システム内のファイルの識別子を表します。storageIdentifierは、ファイルが保存されている場所を表します。 これは JSON では null か欠落している可能性があります。
アップロード URL は常に Azure Storage Blob を指します。
分散アップロードの場合、ポータル アプリケーションの API エンドポイント api/v1.0/upload がトラフィック マネージャーにリダイレクトし、最も近い衛星がアップロード URL を作成して返します。
受信した URL へのファイルのアップロード
受信した URL へのファイルのアップロード
受信したアップロード URL は Azure Storage Blob へのパブリックURL です。つまり、Azure Blob サービスの REST API を使用してファイルをアップロードできます。
アップロードを実行するには、次の必須ヘッダーを使用して、PUT 要求をアップロード URL に送信します。
x-ms-blob-type: Azureは、値が BlockBlob であると想定します。x-ms-blob-content-type: ファイルのコンテンツ タイプ。x-ms-meta-Filename: ファイルの名前。
Azure Blob Storage への大きなファイルのアップロード
ファイルが 200 MB より大きい場合は、ファイルを分割し、クエリ文字列パラメーター comp=block&blockid={blockid} を使用してアップロード URL を拡張することにより、各ブロックを個別に Azure に送信します。
blockidは、ブロックを識別するための有効な Base64 文字列値です。- 特定の blob について、指定された
blockid値の長さは、各ブロックで同じサイズである必要があります。
すべてのブロックが送信されたら、アップロード URL に別の要求を送信して、アップロードが完了したことと、すべてのブロックをまとめる必要があることを通知します。
- クエリ文字列パラメーター
comp=blocklistを使用してアップロード URL を拡張します。 - 要求の本文は XML 形式でなければなりません。また、
blockidを使用してブロックを読み込む順序を指定する必要があります。
次のコード スニペットは、blockid を使用してブロックを読み込む方法を示しています。