sonar-tickets
指定した時間範囲内に作成されたチケットの一覧を照会します。時間範囲を指定しない場合、すべてのチケットを照会します。
コマンドプロパティ
| 項目 | 説明 |
|---|---|
| コマンドタイプ | ドライバークエリ |
| 必要な権限 | ログイン必須 |
| ライセンス使用量 | 該当なし |
| 並列実行 | 非対応 |
| 分散実行 | 非対応 |
構文
sonar-tickets [duration=INT{s|m|h|d|mon}] [from=STR] [to=STR]
オプション
duration=INT{s|m|h|d|mon}- 現在時刻から指定した時間範囲内のチケットに照会範囲を限定します。
s(秒)、m(分)、h(時)、d(日)、mon(月)単位で指定できます。 from=STR- 照会範囲の開始時刻。
yyyyMMddHHmmss形式で指定します。後ろの桁を省略すると0で補完されます。 to=STR- 照会範囲の終了時刻。
yyyyMMddHHmmss形式で指定します。後ろの桁を省略すると0で補完されます。
出力フィールド
| フィールド | 型 | 説明 |
|---|---|---|
id | long | チケットID |
priority | string | 重要度。LOW、MEDIUM、HIGH |
guid | string | チケットGUID |
title | string | タイトル |
status | string | 状態。NEW、ASSIGNED、IN_PROGRESS、SUBMITTED、APPROVED、REJECTED、CLOSED |
attack | boolean | 正検知フラグ |
incident | boolean | インシデント発生フラグ |
count | integer | 重複集約件数 |
repo_name | string | チケット種別名 |
site_name | string | サイト名 |
owner_name | string | 作成者名。システム生成時はnull |
format | string | チケット形式。JSON、MARKDOWN、PLAIN |
assignees | array | 担当者リスト |
approvers | array | 承認者リスト |
tags | string | タグリスト。改行(\n)で区切られた文字列 |
created | timestamp | 作成日時 |
updated | timestamp | 更新日時 |
closed | timestamp | 完了日時 |
x_login | string | 削除されたアカウントのログイン名 |
x_user | string | 削除されたユーザーの氏名 |
x_dept | string | 削除された部署名 |
x_site | string | 削除されたサイト名 |
repo_guid | string | チケット種別GUID |
site_guid | string | サイトGUID |
owner_guid | string | 作成者GUID |
エラーコード
パースエラー
| エラーコード | メッセージ | 説明 |
|---|---|---|
| 300101 | 유효하지 않은 세션입니다. | セッションが無効、またはユーザーが見つかりません。 |
ランタイムエラー
該当なし
説明
sonar-ticketsコマンドは、現在のユーザーの権限でアクセス可能なチケット一覧を照会します。durationまたはfrom/toオプションで時間範囲を指定でき、時間範囲はチケットの作成日時(created)を基準にフィルタリングします。
durationオプションとfromオプションを同時に指定した場合、fromオプションが優先されます。
タグリストは改行文字(\n)で区切られた文字列としてシリアライズされます。
使用例
-
すべてのチケットを照会
sonar-ticketsアクセス権限があるすべてのチケットの一覧を照会します。
-
最近1日以内のチケットを照会
sonar-tickets duration=1d最近24時間以内に作成されたチケット一覧を照会します。
-
時間範囲を指定して照会
sonar-tickets from=20260301 to=202604012026年3月1日から4月1日までに作成されたチケット一覧を照会します。
-
未処理チケットをフィルタリング
sonar-tickets duration=7d | search status == "NEW" or status == "ASSIGNED" | sort created asc最近7日以内に作成された未処理(
NEWまたはASSIGNED)のチケットを作成日時の昇順で照会します。