uip resource queue-items

キュー アイテムの管理 — キュー内の個々のワーク トランザクションを管理します。項目フローは、 New → InProgress → Successful / Failed / Abandoned / Retried / Deletedのステートを通過します。キュー アイテムはフォルダー範囲です。ほとんどのサブコマンドでは、 --folder-path または --folder-keyが必要です。キュー自体については、「 uip resource queues」をご覧ください。

リソース間の規則 (認証、フォルダー スコープ、キーの種類、出力エンベロープ) については、「 uip resource の概要」をご覧ください。

概要

uip resource queue-items list                <flags below>
uip resource queue-items get                 <queue-item-key>
uip resource queue-items update              <queue-item-key> [--progress <text>] [--priority <p>] [--due-date <iso>] [--defer-date <iso>] [--specific-content <json>]
uip resource queue-items set-progress        <queue-item-key> <progress>
uip resource queue-items delete              <queue-item-key>
uip resource queue-items delete-bulk         <queue-item-key...>
uip resource queue-items set-review-status   <status> <queue-item-key...>
uip resource queue-items set-reviewer        <queue-item-key...> --user-key <guid>
uip resource queue-items unset-reviewer      <queue-item-key...>
uip resource queue-items get-reviewers       [--folder-path <path> | --folder-key <key>]
uip resource queue-items get-history         <queue-item-key> [-l <n>] [--offset <n>]
uip resource queue-items get-last-retry      <retry-chain-key>
uip resource queue-items has-video           <queue-item-key>
uip resource queue-items add                 <queue-name> --folder-path <path> | --folder-key <key> --specific-content <json> [-r <ref>] [-p <priority>] [--defer-date <iso>] [--due-date <iso>]
uip resource queue-items bulk-add            <queue-name> --folder-path <path> | --folder-key <key> --queue-items <json-array> [--commit-type <mode>]

リスト (List)

フォルダー内のキュー アイテムのリストを取得します。フィルター: --queue-definition-key <guid>および/または --queue-name <name> および/または --status <state>

uip resource queue-items list --folder-path Shared \
  --queue-name InvoiceQueue --status Failed

get

キュー アイテムを<queue-item-key>単位で取得する (list出力のuniqueKeyフィールド。試行ごとに一意)。

更新

キュー アイテムのフィールドを変更します。任意 --progress、 --priority <High|Normal|Low>、 --due-date <ISO-8601>、 --defer-date <ISO-8601>、 --specific-content <json>です。

進行状況の設定

進行中のアイテムの進行状況テキストを更新します: set-progress <queue-item-key> <progress>。

削除 / 一括削除

<queue-item-key> / <queue-item-key...>で 1 つ以上のアイテムを削除します。一括フォームでは、すべてのアイテムが同じフォルダーに属している必要があります。

レビューステータスを設定

1 つ以上の<queue-item-key...>に <status> (Retried、 Abandoned、 Deleted) を設定します。

set-reviewer / unset-reviewer

1 つまたは複数の <queue-item-key...>でレビュー担当者を割り当てるか、レビュー担当者をクリアします。set-reviewer には --user-key <guid>が必要です。

GET-REVIEWERS

レビュー担当者として利用可能なユーザーのリストを取得します (指定されている場合は --folder-path / --folder-key でスコープを設定します)。返されたキーは set-reviewer --user-keyにフィードされます。

履歴を取得

キュー アイテムの処理履歴を返します。-l, --limit / --offsetでページ分割

最後のリトライを取得

アイテムの最新のリトライを返します。Argument はリトライ チェーン キーです (uniqueKeyではなく、listのkeyフィールド)。

has-video

キュー アイテムにビデオ記録が添付されているかどうかを返します。

追加

名前でキューにアイテムを 1 つ追加します。<queue-name> と --specific-content <json>が必要です。任意 -r, --reference、 -p, --priority <High|Normal|Low> (既定 Normal)、 --defer-date、 --due-dateです。

uip resource queue-items add InvoiceQueue --folder-path Shared \
  --specific-content '{"InvoiceId":"INV-001","Amount":1500}'

一括追加

1 つの要求に複数のアイテムを追加します。<queue-name> と --queue-items <json-array>が必要です。任意 --commit-type <AllOrNothing|StopOnFirstFailure|ProcessAllIndependently> (既定 ProcessAllIndependently)。

ITEMS=$(jq -c . ./items.json)
uip resource queue-items bulk-add InvoiceQueue \
  --folder-path Shared \
  --queue-items "$ITEMS" \
  --commit-type StopOnFirstFailure

参照

• uip resource queues — キューレベルの CRUD です。
• uip resourceの概要—すべてのuip resource動詞に共通する規則。
• 方法: Orchestrator のアセットとキューを管理する — 一括パターンと CSV 主導のディスパッチ。