1. フェッチ ジョブの更新

フェッチ ジョブの更新

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

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

フェッチ ジョブの更新は現在、フェッチ ジョブのキャンセルに限定されています。フェッチ ジョブをキャンセルできるのは、更新時の state プロパティの値が Pending と等しい場合のみです。フェッチ ジョブは削除できません。

PUT /entities/:fetchJobsId

以下のプレースホルダーを置き換えます。

プレースホルダー説明
:fetchJobId更新する必要のあるフェッチ ジョブの ID

本文パラメーター

次の本文パラメーターが必要ですが、現在変更されるのは state 値のみです。

パラメーター説明
conditionStringジョブの現在の状態に関するシステムの説明。
file_countInt現在フェッチ ジョブにあるファイルの量。
stateStringジョブの現在の状態。このプロパティは現在、フェッチ ジョブで更新できる唯一のプロパティです。現在の値が Pending であれば、Cancelled に設定できます。
state_descriptionStringジョブの現在の状態に関する正規の説明。

パラメーターはすべて無視されますが、値は更新されるフェッチ ジョブと同じでなければなりません。異なっている場合、エラーがスローされます。つまり、これらの値を最初にフェッチ ジョブから取得する必要があるということです。実際にフェッチ ジョブの更新に使用されるのは、state パラメーター値のみです。

本文の例

{
"condition":"Success",
"file_count":"1",
"state":"Cancelled",
"state_description":"Job completed"
}

応答

応答本文
204 No Contentすべてがエラーなしで処理された場合、空の本文を返します。state 値が実際に意図したとおりに処理されたかどうかをチェックしません。
403 Forbidden更新内容を処理できなかったときにはエラー メッセージを返します。これは通常、本文にパラメーターがないことが原因です。

応答の例

Status: 204 No Content
Status: 403 Forbidden

{
"Message": "Only the 'Job.State' property can be changed."
}
この記事を改善するための提案がある場合は、 お知らせください!