新しいフェッチジョブの作成

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

フェッチワーカーによって処理されるフェッチジョブを作成します。参照されるファイルがダウンロードされ、参照される M.Asset リソースのファイル履歴に追加されます。要求のリストの最後のファイルが新しいマスターファイルになります。これによりクライアントは、ファイルの完全な履歴を 1 回の要求で単一のアセットに追加できます。

POST /fetchjobs

本文パラメーター

フェッチジョブ作成要求オブジェクトは、新しいフェッチジョブの作成を要求するために使用されます。次のパラメーターは必須です。

パラメーター	型	説明
`state_description`	`String`	ジョブの現在の状態の説明。設定する必要がありますが、このパラメーターは、ジョブが送信されるとすぐにシステムによって上書きされるため、空のまま (`""`) にしておくことをお勧めします。
`asset`	リンク	これらのファイルを受信するアセットエンティティへのリンク。
`files`	配列.<ファイル>	アセットに追加するファイルを取得する場所を示すファイルオブジェクトの `Array`。要求のリストの最後のファイルが新しいマスターファイルになります。

ローカルストレージ ("type":"File") または Azure Blob Storage ("type":"Azure") からファイルをフェッチする場合は、m.defaults.json で fileProvider 設定を適切に構成する必要があります。その方法については、「ファイルオブジェクト」セクションを参照してください。

本文の例

ヒント: フェッチジョブが作成され、既存のファイルがすでに添付されているアセットをターゲットにしている場合、次のことが起こります。

フェッチジョブの作成時にアセットに既に関連付けられていたファイルは FileHistory に移動されます
新しくアップロードされたファイルは新しいマスターファイルになり、プレビューに表示されるます (ファイル履歴は、既定でサムネイルのすぐ下のパネルに表示されます)
フェッチジョブがファイル配列内の複数のファイルで作成される場合、提供された最後のリンクがマスターファイルになり、他のファイルは代替ファイルとして追加されます

要求の例:

{
    "state_description":"",
    "asset":{
        "href":"/entities/23"
    },
    "files":[
        {
            "type":"File",
            "path":"\\server\path\file1.jpg"
        },
        {
            "type" : "Web",
            "href" : "http://www.gstatic.com/webp/gallery/5.jpg"
        },
        {
            "type":"Azure",
            "key":"fileProviderName-/path/to/file/on/blob/storage.jpg"
        }
    ]
}

応答

応答	説明
`201 Created`	新しく作成されたリソースの URL を含む追加のロケーションヘッダーを提供します。

応答の例

HTTP/1.1 201 Created
Location: /fetchjobs/6448

この記事を改善するための提案がある場合は、お知らせください!

新しいフェッチ ジョブの作成

本文パラメーター

本文の例

応答

応答の例

新しいフェッチジョブの作成