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."
}
この記事を改善するための提案がある場合は、 お知らせください!