Jira
Jira は、アジャイル チームが世界に通用するソフトウェアを計画、追跡、リリースするためのソフトウェア開発ツールです。 Jira の問題をご自身の他のツールに接続すると、障壁を取り除き、チームの可能性を引き出すことができます。
このコネクタは、次の製品および地域で利用可能です。
サービス | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 - 米国国防総省 (DoD) |
Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 21 Vianet が運用する中国のクラウド |
Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 21 Vianet が運用する中国のクラウド |
連絡先 | |
---|---|
件名 | Microsoft |
URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
コネクタ メタデータ | |
---|---|
公開元 | Microsoft |
Web サイト | https://www.atlassian.com/software/jira |
プライバシー ポリシー | https://www.atlassian.com/legal/privacy-policy |
カテゴリ | IT オペレーション;コラボレーション |
この統合を使用するには、Jira アカウントが必要です。
既知の問題と制限事項
- 認証には、API トークンを使用する必要があります。 トークンを取得するには、このリンク に移動します。
- パスワードを使用した基本認証は非推奨です。 詳細については、JIRA API に関するドキュメント を参照してください。
- ファイアウォールの背後にある、または REST API が無効になっている Jira サーバーはサポートされていません。
- Jira クラウドへの接続を作成する場合は、ユーザー名に有効なメール アドレスを使用する必要があります。 さもなければ、接続は成功したように見えますが、接続は確立されません。
- Jira クラウドのユーザー名は非推奨であり、Reporter などのフィールドには使用できません。 詳細については、Atlassian クラウド ドキュメント を参照してください。
- JIRA API ドキュメント に基づき、JIRA API は最大 50 件のプロジェクトを返すので、上位 50 件のプロジェクトがアクション/トリガーのドロップダウンに一覧表示されます。
- プロジェクトを取得するにページ割り付けが実装されました。 すべてのプロジェクトが返されます。
- 新しい問題を作成する (V2) アクションは、'string'、'number'、'date'、および 'datetime' などの動的スキーマの単純なフィールドのみをサポートします。 プロジェクト構成に複雑なデータ型の必須フィールドがある場合、操作は次のエラーで失敗します: 「'{type}' タイプのフィールド '{key}' はサポートされていません」。 これを回避するには、プロジェクト フィールドの構成を変更し、これらのフィールドを不要にしてください。
- 新しい問題を作成する (V3) アクションは、'string'、'number'、'date'、および 'datetime' などの動的スキーマの単純なフィールドのみをサポートします。 プロジェクト構成に複雑なデータ型の必須フィールドがある場合、操作は次のエラーで失敗します: 「'{type}' タイプのフィールド '{key}' はサポートされていません」。 これを回避するには、プロジェクト フィールドの構成を変更し、これらのフィールドを不要にしてください。
- コネクタのアクションとトリガーによって予期される
Project
プロパティは、次のいずれかのオプションを使用して入力する必要があります:- プロジェクト ピッカーからプロジェクトを選択します。 Jira クラウド接続では、ピッカーに上位 50 プロジェクトのみを表示することに注意してください。
- プロジェクトを取得する アクションからの出力を使用します (プロジェクトの
Project Key
プロパティ)。
- イシューを編集する 操作の詳細については、Jira API ドキュメント を参照してください
- 作業フローが 400 レスポンスで失敗たり、アクションやトリガーに対して不正なリクエストが発生した場合は、接続を作成するために使用した API キーの有効期限が切れていないか確認し、切れている場合は新しい API キーで接続を再作成してください。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
API トークン | API トークンを使用して Jira にアクセスする | すべての地域 | 共有不可 |
Oauth | Oauth を使用して、Jira にアクセスします。 | すべての地域 | 共有不可 |
既定 [非推奨] | このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。 | すべての地域 | 共有不可 |
API Token
Auth ID: APIToken
適用可能: すべての領域
API トークンを使用して Jira にアクセスする
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
件名 | タイプ | Description | Required |
---|---|---|---|
ユーザー名またはメール | string | Jira ユーザー名。 Jira クラウドの場合、有効なメール アドレスを使用する必要があります。 | True |
API トークン | securestring | API トークン (https://id.atlassian.com/manage/api-tokens)。 | True |
Oauth
認証 ID: oauth
適用可能: すべての領域
Oauth を使用して、Jira にアクセスします。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
既定 [非推奨]
適用できるもの: すべての領域
このオプションは、明示的な認証の種類を持たない古い接続専用に対してのみ使用され、下位互換性を保つためにのみ提供されます。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
件名 | タイプ | Description | Required |
---|---|---|---|
Jira インスタンス | string | Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 | True |
ユーザー名またはメール | string | Jira ユーザー名。 Jira クラウドの場合、有効なメール アドレスを使用する必要があります。 | True |
API トークン | securestring | API トークン (https://id.atlassian.com/manage/api-tokens)。 | 真 |
調整制限
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
トリガー ポーリングの頻度 | 1 | 60 秒 |
アクション
すべてのプロジェクト カテゴリの取得 |
プロジェクト カテゴリをすべて返します。 |
すべてのプロジェクト カテゴリを取得する (V2) |
プロジェクト カテゴリをすべて返します。 |
イシューを編集する |
イシューを編集します。 この編集により変移が適用され、イシューのプロパティが更新されます。 イシューのフィールドの編集は、更新とフィールドを使用して定義されます。 |
キーごとに問題を取得する (V2) |
この操作は、特定の問題キーの問題オブジェクトを取得するために使用されます。 |
キーで問題を取得する |
この操作は、特定の問題キーの問題オブジェクトを取得するために使用されます。 |
コメントを追加する |
この操作は、既存の Jira 問題にコメントを追加するために使用されます。 |
コメントを追加する (V2) |
この操作は、既存の Jira 問題にコメントを追加するために使用されます。 |
タスクを取り消す |
タスクを取り消します。 必要なアクセス許可: JIRA の管理またはタスクの作成者のいずれか。 |
タスクを取り消す (V2) |
タスクを取り消します。 必要なアクセス許可: JIRA の管理またはタスクの作成者のいずれか。 |
タスクを取得する |
実行時間の長い非同期タスクのステータスを返します。 タスクが終了すると、この操作はタスクに適用可能な JSON BLOB を返します。 |
タスクを取得する (V2) |
実行時間の長い非同期タスクのステータスを返します。 タスクが終了すると、この操作はタスクに適用可能な JSON BLOB を返します。 |
フィルターのリストを取得する |
この操作は、ユーザーが利用できるフィルターのリストを返します。 |
フィルターの一覧を取得する (V2) |
この操作は、ユーザーが利用できるフィルターのリストを返します。 |
プロジェクト カテゴリを作成する |
プロジェクト カテゴリを作成します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクト カテゴリを作成する (V2) |
プロジェクト カテゴリを作成します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクト カテゴリを削除する |
プロジェクト カテゴリを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクト カテゴリを削除する (V2) |
プロジェクト カテゴリを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクトごとにタスクを一覧表示する (V2) |
この操作は、プロジェクトに関連付けられているすべてのユーザーの一覧を取得するために使用されます。 |
プロジェクトの取得 |
この操作は、Jira インスタンスについてプロジェクトの一覧を取得するために使用されます。 |
プロジェクトを削除する |
プロジェクトを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクトを削除する (V2) |
プロジェクトを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可) |
プロジェクトを取得する (V2) |
この操作は、Jira インスタンスについてプロジェクトの一覧を取得するために使用されます。 |
プロジェクトを取得する [非推奨] |
このアクションは非推奨になりました。 代わりにプロジェクトの取得 を使用してください。
|
プロジェクトを更新する |
プロジェクトに対応するプロジェクトの詳細を更新します。 |
プロジェクトを更新する (V2) |
プロジェクトに対応するプロジェクトの詳細を更新します。 |
ユーザーをプロジェクト別に一覧表示する |
この操作は、プロジェクトに関連付けられているすべてのユーザーの一覧を取得するために使用されます。 |
ユーザーを取得する |
ユーザーを返します。 必要なアクセス許可: ユーザーとグループを参照します。 |
ユーザーを取得する (V2) |
ユーザーを返します。 必要なアクセス許可: ユーザーとグループを参照します。 |
リソースの一覧を取得する |
この操作は、ユーザーが利用できるリソースのリストを返します。 |
問題の一覧を取得する |
この操作は JQL を使用して問題の一覧を返します。 |
問題の遷移を実行する |
問題を新しい状態に遷移させます。 |
問題を編集する (V2) |
イシューを編集します。 この編集により変移が適用され、イシューのプロパティが更新されます。 イシューのフィールドの編集は、更新とフィールドを使用して定義されます。 |
新しいプロジェクト (V2) を作成する |
この操作は、新しい Jira プロジェクトを作成するために使用されます。 |
新しいプロジェクトの作成 |
この操作は、新しい Jira プロジェクトを作成するために使用されます。 |
新しい問題を作成する (V2) |
この操作は、新しい問題を作成するために使用されます。 |
新しい問題を作成する (V3) |
この操作は、新しい問題を作成するために使用されます。 |
新しい問題を作成する [非推奨] |
このアクションは非推奨になりました。 代わりに新しい問題の作成 (V3) を使用してください。
|
現在のユーザーを取得 |
この操作は現在のユーザーの詳細を返します |
遷移の一覧を取得する |
この課題に対して現在のユーザーが利用できる遷移の一覧を返します |
すべてのプロジェクト カテゴリの取得
プロジェクト カテゴリをすべて返します。
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
|
array of object | ||
self
|
self | string |
自己 |
id
|
id | string |
ID |
description
|
description | string |
Description |
名称
|
name | string |
件名 |
すべてのプロジェクト カテゴリを取得する (V2)
プロジェクト カテゴリをすべて返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
|
array of object | ||
self
|
self | string |
自己 |
id
|
id | string |
ID |
description
|
description | string |
Description |
名称
|
name | string |
件名 |
イシューを編集する
イシューを編集します。 この編集により変移が適用され、イシューのプロパティが更新されます。 イシューのフィールドの編集は、更新とフィールドを使用して定義されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
イシュー ID またはイシュー キー
|
issueIdOrKey | True | string |
編集するイシューに対応するイシュー ID またはキーを入力します |
Notify Users
|
notifyUsers | boolean |
ユーザーに通知しますか? |
|
Override Screen Security
|
overrideScreenSecurity | boolean |
画面のセキュリティを上書きしますか? |
|
編集可能なフラグを上書きする
|
overrideEditableFlag | boolean |
編集可能なフラグを上書きしますか? |
|
遷移 ID
|
id | string |
遷移 ID |
|
遷移がループされました
|
looped | string |
遷移がループされました |
|
Fields
|
fields | object |
更新するイシュー画面フィールドの一覧。更新するサブフィールドと各フィールドの値を指定します。 このフィールドにより、サブフィールドを簡単な方法で設定できます。 複数のサブフィールドやその他の操作が必要な場合は、更新を使用してください。 ここに含まれるフィールドを更新に含めることはできません。 |
|
更新する
|
update | object |
フィールド名およびイシュー画面フィールドで実行する操作の一覧を含むマップ。 ここに含まれるフィールドをフィールドに含めることはできません。 |
|
メタデータの種類
|
type | string |
履歴メタデータの種類 |
|
メタデータの記述
|
description | string |
履歴メタデータの記述 |
|
メタデータの記述キー
|
descriptionKey | string |
履歴メタデータの記述キー |
|
メタデータの活動記述
|
activityDescription | string |
履歴メタデータの活動記述 |
|
メタデータの活動記述キー
|
activityDescriptionKey | string |
履歴メタ データの活動記述キー |
|
メタデータのメール記述
|
emailDescription | string |
履歴メタデータのメール記述 |
|
メタデータのメール記述キー
|
emailDescriptionKey | string |
履歴メタ データのメール記述キー |
|
アクター ID
|
id | string |
アクター ID |
|
アクターの表示名
|
displayName | string |
アクターの表示名 |
|
アクターの表示名のキー
|
displayNameKey | string |
アクターの表示名のキー |
|
アクターの種類
|
type | string |
アクターの種類 |
|
アクターのアバター URL
|
avatarUrl | string |
アクターのアバター URL |
|
アクターの URL
|
url | string |
アクターの URL |
|
ジェネレーター ID
|
id | string |
ジェネレーター ID |
|
ジェネレーターの表示名
|
displayName | string |
ジェネレーターの表示名 |
|
ジェネレーターの表示名のキー
|
displayNameKey | string |
ジェネレーターの表示名のキー |
|
ジェネレーターの種類
|
type | string |
ジェネレーターの種類 |
|
ジェネレーターのアバターの URL
|
avatarUrl | string |
ジェネレーターのアバターの URL |
|
ジェネレーターの URL
|
url | string |
ジェネレーターの URL |
|
原因 ID
|
id | string |
原因 ID |
|
原因の表示名
|
displayName | string |
原因の表示名 |
|
原因の表示名のキー
|
displayNameKey | string |
原因の表示名のキー |
|
原因の種類
|
type | string |
原因の種類 |
|
原因アバターの URL
|
avatarUrl | string |
原因アバターの URL |
|
原因の URL
|
url | string |
原因の URL |
|
追加データ
|
extraData | string |
追加データ |
|
key
|
key | string |
Key |
戻り値
キーごとに問題を取得する (V2)
この操作は、特定の問題キーの問題オブジェクトを取得するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
問題キー
|
issueKey | True | string |
問題の一意のキー。 |
戻り値
- Issue
- FullIssue
キーで問題を取得する
この操作は、特定の問題キーの問題オブジェクトを取得するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
問題キー
|
issueKey | True | string |
問題の一意のキー。 |
戻り値
- Issue
- FullIssue
コメントを追加する
この操作は、既存の Jira 問題にコメントを追加するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
問題キー
|
issueKey | True | string |
コメントを追加する問題の一意のキー。 |
Comment
|
body | True | string |
コメントの本文。 |
戻り値
- Body
- CommentResponse
コメントを追加する (V2)
この操作は、既存の Jira 問題にコメントを追加するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
問題キー
|
issueKey | True | string |
コメントを追加する問題の一意のキー。 |
Comment
|
body | True | string |
コメントの本文。 |
戻り値
- Body
- CommentResponse
タスクを取り消す
タスクを取り消します。 必要なアクセス許可: JIRA の管理またはタスクの作成者のいずれか。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Task ID
|
taskId | True | string |
タスクの ID です。 |
戻り値
タスクを取り消す (V2)
タスクを取り消します。 必要なアクセス許可: JIRA の管理またはタスクの作成者のいずれか。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Task ID
|
taskId | True | string |
タスクの ID です。 |
戻り値
タスクを取得する
実行時間の長い非同期タスクのステータスを返します。 タスクが終了すると、この操作はタスクに適用可能な JSON BLOB を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Task ID
|
taskId | True | string |
タスクの ID です。 |
戻り値
タスクを取得する (V2)
実行時間の長い非同期タスクのステータスを返します。 タスクが終了すると、この操作はタスクに適用可能な JSON BLOB を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Task ID
|
taskId | True | string |
タスクの ID です。 |
戻り値
フィルターのリストを取得する
フィルターの一覧を取得する (V2)
この操作は、ユーザーが利用できるフィルターのリストを返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
戻り値
- Body
- ListFiltersResponse
プロジェクト カテゴリを作成する
プロジェクト カテゴリを作成します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
名称
|
name | string |
件名 |
|
description
|
description | string |
Description |
戻り値
プロジェクト カテゴリを作成する (V2)
プロジェクト カテゴリを作成します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
名称
|
name | string |
件名 |
|
description
|
description | string |
Description |
戻り値
プロジェクト カテゴリを削除する
プロジェクト カテゴリを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
会社 ID
|
id | True | integer |
削除するプロジェクト カテゴリの ID です。 |
プロジェクト カテゴリを削除する (V2)
プロジェクト カテゴリを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
会社 ID
|
id | True | integer |
削除するプロジェクト カテゴリの ID です。 |
プロジェクトごとにタスクを一覧表示する (V2)
この操作は、プロジェクトに関連付けられているすべてのユーザーの一覧を取得するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
プロジェクト キー
|
projectKey | True | string |
プロジェクトの一意のキー。 |
戻り値
- アイテム
- UserList
プロジェクトの取得
プロジェクトを削除する
プロジェクトを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project ID or Key
|
projectIdOrKey | True | string |
プロジェクト ID またはプロジェクト キー (大文字と小文字を区別する) です。 |
Enable Undo
|
enableUndo | boolean |
このプロジェクトが、復元を利用できる Jira ごみ箱に存在するかどうか。 |
プロジェクトを削除する (V2)
プロジェクトを削除します。 必要なアクセス許可: JIRA の管理 (グローバル アクセス許可)
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Project ID or Key
|
projectIdOrKey | True | string |
プロジェクト ID またはプロジェクト キー (大文字と小文字を区別する) です。 |
Enable Undo
|
enableUndo | boolean |
このプロジェクトが、復元を利用できる Jira ごみ箱に存在するかどうか。 |
プロジェクトを取得する (V2)
この操作は、Jira インスタンスについてプロジェクトの一覧を取得するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
戻り値
プロジェクトを取得する [非推奨]
このアクションは非推奨になりました。 代わりにプロジェクトの取得 を使用してください。
この操作は、Jira インスタンスについてプロジェクトの一覧を取得するために使用されます。
戻り値
- アイテム
- ProjectArray
プロジェクトを更新する
プロジェクトに対応するプロジェクトの詳細を更新します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project ID or Key
|
projectIdOrKey | True | string |
更新するプロジェクトの ID またはキーを入力する1 |
key
|
key | string |
キー |
|
name
|
name | string |
名前 |
|
projectTypeKey
|
projectTypeKey | string |
プロジェクトの種類キー |
|
projectTemplateKey
|
projectTemplateKey | string |
プロジェクト テンプレート キー |
|
description
|
description | string |
説明 |
|
lead
|
lead | string |
リード |
|
leadAccountId
|
leadAccountId | string |
リードの取引先担当者 ID |
|
url
|
url | string |
URL |
|
assigneeType
|
assigneeType | string |
担当者の種類 |
|
avatarId
|
avatarId | string |
アバター ID |
|
issueSecurityScheme
|
issueSecurityScheme | string |
イシューのセキュリティ スキーム |
|
permissionScheme
|
permissionScheme | string |
アクセス許可スキーム |
|
notificationScheme
|
notificationScheme | string |
通知スキーム |
|
categoryId
|
categoryId | string |
Category ID |
戻り値
プロジェクトを更新する (V2)
プロジェクトに対応するプロジェクトの詳細を更新します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Project ID or Key
|
projectIdOrKey | True | string |
更新するプロジェクトの ID またはキーを入力する1 |
key
|
key | string |
キー |
|
name
|
name | string |
名前 |
|
projectTypeKey
|
projectTypeKey | string |
プロジェクトの種類キー |
|
projectTemplateKey
|
projectTemplateKey | string |
プロジェクト テンプレート キー |
|
description
|
description | string |
説明 |
|
lead
|
lead | string |
リード |
|
leadAccountId
|
leadAccountId | string |
リードの取引先担当者 ID |
|
url
|
url | string |
URL |
|
assigneeType
|
assigneeType | string |
担当者の種類 |
|
avatarId
|
avatarId | string |
アバター ID |
|
issueSecurityScheme
|
issueSecurityScheme | string |
イシューのセキュリティ スキーム |
|
permissionScheme
|
permissionScheme | string |
アクセス許可スキーム |
|
notificationScheme
|
notificationScheme | string |
通知スキーム |
|
categoryId
|
categoryId | string |
カテゴリ ID |
戻り値
ユーザーをプロジェクト別に一覧表示する
この操作は、プロジェクトに関連付けられているすべてのユーザーの一覧を取得するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
プロジェクト キー
|
projectKey | True | string |
プロジェクトの一意のキー。 |
戻り値
- アイテム
- UserList
ユーザーを取得する
ユーザーを返します。 必要なアクセス許可: ユーザーとグループを参照します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Account ID
|
accountId | True | string |
すべての Atlassian 製品でユーザーを一意に識別するユーザーのアカウント ID。 例えば、5b10ac8d82e05b22cc7d4ef5。 必須。 |
Expand
|
expand | string |
展開を使用して、応答にユーザーに関する追加情報を含めます。 このパラメーターは、コンマ区切りのリストを受け入れます。 展開オプションは次のとおりです: * |
戻り値
ユーザーを取得する (V2)
ユーザーを返します。 必要なアクセス許可: ユーザーとグループを参照します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Account ID
|
accountId | True | string |
すべての Atlassian 製品でユーザーを一意に識別するユーザーのアカウント ID。 例えば、5b10ac8d82e05b22cc7d4ef5。 必須。 |
Expand
|
expand | string |
展開を使用して、応答にユーザーに関する追加情報を含めます。 このパラメーターは、コンマ区切りのリストを受け入れます。 展開オプションは次のとおりです: * |
戻り値
リソースの一覧を取得する
問題の一覧を取得する
この操作は JQL を使用して問題の一覧を返します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
戻り値
- Body
- ListIssuesResponse
問題の遷移を実行する
問題を新しい状態に遷移させます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
イシュー ID またはイシュー キー
|
issueIdOrKey | True | string |
遷移させる問題の ID またはキー |
名称
|
name | string | ||
名称
|
name | string | ||
activityDescription
|
activityDescription | string | ||
avatarUrl
|
avatarUrl | string | ||
displayName
|
displayName | string | ||
id
|
id | string | ||
タイプ
|
type | string | ||
url
|
url | string | ||
id
|
id | string | ||
タイプ
|
type | string | ||
description
|
description | string | ||
イテレーション
|
Iteration | string | ||
Step
|
Step | string | ||
id
|
id | string | ||
タイプ
|
type | string | ||
タイプ
|
type | string | ||
id
|
id | string | ||
body
|
body | string |
戻り値
問題を編集する (V2)
イシューを編集します。 この編集により変移が適用され、イシューのプロパティが更新されます。 イシューのフィールドの編集は、更新とフィールドを使用して定義されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
イシュー ID またはイシュー キー
|
issueIdOrKey | True | string |
編集するイシューに対応するイシュー ID またはキーを入力します |
Notify Users
|
notifyUsers | boolean |
ユーザーに通知しますか? |
|
Override Screen Security
|
overrideScreenSecurity | boolean |
画面のセキュリティを上書きしますか? |
|
編集可能なフラグを上書きする
|
overrideEditableFlag | boolean |
編集可能なフラグを上書きしますか? |
|
遷移 ID
|
id | string |
遷移 ID |
|
遷移がループされました
|
looped | string |
遷移がループされました |
|
Fields
|
fields | object |
更新するイシュー画面フィールドの一覧。更新するサブフィールドと各フィールドの値を指定します。 このフィールドにより、サブフィールドを簡単な方法で設定できます。 複数のサブフィールドやその他の操作が必要な場合は、更新を使用してください。 ここに含まれるフィールドを更新に含めることはできません。 |
|
更新する
|
update | object |
フィールド名およびイシュー画面フィールドで実行する操作の一覧を含むマップ。 ここに含まれるフィールドをフィールドに含めることはできません。 |
|
メタデータの種類
|
type | string |
履歴メタデータの種類 |
|
メタデータの記述
|
description | string |
履歴メタデータの記述 |
|
メタデータの記述キー
|
descriptionKey | string |
履歴メタデータの記述キー |
|
メタデータの活動記述
|
activityDescription | string |
履歴メタデータの活動記述 |
|
メタデータの活動記述キー
|
activityDescriptionKey | string |
履歴メタ データの活動記述キー |
|
メタデータのメール記述
|
emailDescription | string |
履歴メタデータのメール記述 |
|
メタデータのメール記述キー
|
emailDescriptionKey | string |
履歴メタ データのメール記述キー |
|
アクター ID
|
id | string |
アクター ID |
|
アクターの表示名
|
displayName | string |
アクターの表示名 |
|
アクターの表示名のキー
|
displayNameKey | string |
アクターの表示名のキー |
|
アクターの種類
|
type | string |
アクターの種類 |
|
アクターのアバター URL
|
avatarUrl | string |
アクターのアバター URL |
|
アクターの URL
|
url | string |
アクターの URL |
|
ジェネレーター ID
|
id | string |
ジェネレーター ID |
|
ジェネレーターの表示名
|
displayName | string |
ジェネレーターの表示名 |
|
ジェネレーターの表示名のキー
|
displayNameKey | string |
ジェネレーターの表示名のキー |
|
ジェネレーターの種類
|
type | string |
ジェネレーターの種類 |
|
ジェネレーターのアバターの URL
|
avatarUrl | string |
ジェネレーターのアバターの URL |
|
ジェネレーターの URL
|
url | string |
ジェネレーターの URL |
|
原因 ID
|
id | string |
原因 ID |
|
原因の表示名
|
displayName | string |
原因の表示名 |
|
原因の表示名のキー
|
displayNameKey | string |
原因の表示名のキー |
|
原因の種類
|
type | string |
原因の種類 |
|
原因アバターの URL
|
avatarUrl | string |
原因アバターの URL |
|
原因の URL
|
url | string |
原因の URL |
|
追加データ
|
extraData | string |
追加データ |
|
キー
|
key | string |
キー |
戻り値
新しいプロジェクト (V2) を作成する
この操作は、新しい Jira プロジェクトを作成するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
プロジェクト キー
|
key | True | string |
一意のキーは大文字で始まります。 |
件名
|
name | True | string |
プロジェクトのタイトル。 |
タイプ
|
projectTypeKey | True | string |
プロジェクト タイプのキー。 |
リード ID
|
leadAccountId | True | string |
プロジェクト リードの ID。 |
Description
|
description | string |
プロジェクトの詳細な説明。 |
戻り値
新しいプロジェクトの作成
この操作は、新しい Jira プロジェクトを作成するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
プロジェクト キー
|
key | True | string |
一意のキーは大文字で始まります。 |
件名
|
name | True | string |
プロジェクトのタイトル。 |
タイプ
|
projectTypeKey | True | string |
プロジェクト タイプのキー。 |
リード ID
|
leadAccountId | True | string |
プロジェクト リードの ID。 |
Description
|
description | string |
プロジェクトの詳細な説明。 |
戻り値
新しい問題を作成する (V2)
この操作は、新しい問題を作成するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project
|
projectKey | True | string |
イシューを作成するプロジェクトを選択します。 |
Issue Type Id
|
issueTypeIds | True | string |
イシューの種類を選択します。 |
item
|
item | dynamic |
Item |
戻り値
- Body
- CreateIssueResponse
新しい問題を作成する (V3)
この操作は、新しい問題を作成するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Project
|
projectKey | True | string |
イシューを作成するプロジェクトを選択します。 |
Issue Type Id
|
issueTypeIds | True | string |
イシューの種類を選択します。 |
item
|
item | dynamic |
Item |
戻り値
- Body
- CreateIssueResponse
新しい問題を作成する [非推奨]
このアクションは非推奨になりました。 代わりに新しい問題の作成 (V3) を使用してください。
この操作は、新しい問題を作成するために使用されます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project
|
projectKey | True | string |
問題を作成するプロジェクトを選択します。 |
問題の種類 ID
|
id | True | string |
問題の種類を選択します。 |
サマリー
|
summary | True | string |
問題の簡単な説明。 |
コンポーネント
|
components | string |
'名前' で示される複数の値からなるシステム フィールド (例: Microsoft Entra ID、ネットワーク スイッチ)。 |
|
報告者の ID
|
id | string |
問題を報告しているユーザー。 |
|
内容
|
description | string |
イシューの詳細な説明。 |
|
優先順位 ID
|
id | string |
問題の優先順位を選択します。 |
|
ラベル
|
labels | string |
ラベルのコンマ区切りの一覧を入力する |
|
担当者 ID
|
id | string |
問題が割り当てられているエージェント。 |
|
親問題の ID
|
id | string |
サブタスクの親を設定します。 |
|
エピック名 (customfield_10011)
|
customfield_10119 | string |
エピック問題の種類にはエピック名が必要です。 このフィールドは、Jira サーバーの 'customfield_10011' フィールドと一致します。 |
戻り値
- Body
- CreateIssueResponse
現在のユーザーを取得
この操作は現在のユーザーの詳細を返します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
Expand
|
expand | string |
展開を使用して、応答にユーザーに関する追加情報を含めます。 このパラメーターは、コンマ区切りのリストを受け入れます。 展開オプションは次のとおりです: * |
戻り値
遷移の一覧を取得する
この課題に対して現在のユーザーが利用できる遷移の一覧を返します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | True | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
イシュー ID またはイシュー キー
|
issueIdOrKey | True | string |
遷移を取得する問題の ID またはキー |
戻り値
名前 | パス | 型 | 説明 |
---|---|---|---|
移行
|
transitions | array of Transition |
トリガー
問題がクローズしたとき |
この操作は、既存の問題が指定されたプロジェクトでクローズしたときにトリガーされます。 |
問題をクローズしたとき (V2) |
この操作は、既存の問題が指定されたプロジェクトでクローズしたときにトリガーされます。 |
新しい問題が JQL クエリによって返されたとき |
この操作は、JQL クエリの最新の 100 件の結果に新しい問題が表示されたときにトリガーされます。 |
新しい問題が JQL クエリによって返されたとき (V2) |
この操作は、JQL クエリの最新の 100 件の結果に新しい問題が表示されたときにトリガーされます。 |
新しい問題が作成されたとき (V2) |
この操作は、新しい問題を指定されたプロジェクトに追加したときにトリガーされます。 |
新しい問題が作成されるとき |
この操作は、新しい問題を指定されたプロジェクトに追加したときにトリガーされます。 |
問題がクローズしたとき
この操作は、既存の問題が指定されたプロジェクトでクローズしたときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project
|
projectKey | True | string |
新しい問題を検索するプロジェクトの一意のキー。 |
戻り値
- Issue
- FullIssue
問題をクローズしたとき (V2)
この操作は、既存の問題が指定されたプロジェクトでクローズしたときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
|
Project
|
projectKey | True | string |
新しい問題を検索するプロジェクトの一意のキー。 |
戻り値
- Issue
- FullIssue
新しい問題が JQL クエリによって返されたとき
この操作は、JQL クエリの最新の 100 件の結果に新しい問題が表示されたときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
JQL クエリ
|
jql | True | string |
使用するクエリ。 |
戻り値
- Issue
- FullIssue
新しい問題が JQL クエリによって返されたとき (V2)
この操作は、JQL クエリの最新の 100 件の結果に新しい問題が表示されたときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
|
JQL クエリ
|
jql | True | string |
使用するクエリ。 |
戻り値
- Issue
- FullIssue
新しい問題が作成されたとき (V2)
この操作は、新しい問題を指定されたプロジェクトに追加したときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Jira インスタンス
|
X-Request-Jirainstance | string |
Jira インスタンスをホストしている場所の URL (https のサポートが必須)。 |
|
Project
|
projectKey | True | string |
新しい問題を検索するプロジェクトの一意のキー。 |
戻り値
- Issue
- FullIssue
新しい問題が作成されるとき
この操作は、新しい問題を指定されたプロジェクトに追加したときにトリガーされます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Project
|
projectKey | True | string |
新しい問題を検索するプロジェクトの一意のキー。 |
戻り値
- Issue
- FullIssue
定義
CreateProjectResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
プロジェクト ID
|
id | integer |
プロジェクトを表す一意の ID。 |
プロジェクト キー
|
key | string |
プロジェクトの一意のキー。 |
CreateIssueResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
問題 ID
|
id | string |
問題を表す一意識別子。 |
問題キー
|
key | string |
問題の一意のキー。 |
ListProjects_ResponseV2
名前 | パス | 型 | 説明 |
---|---|---|---|
値
|
values | ProjectArray |
ProjectArray
名前 | パス | 型 | 説明 |
---|---|---|---|
プロジェクト ID
|
id | string |
プロジェクトの一意の ID。 |
プロジェクト キー
|
key | string |
プロジェクトの一意のキー。 |
プロジェクト名
|
name | string |
プロジェクトの名前です。 |
プロジェクト タイプのキー
|
projectTypeKey | string |
プロジェクト タイプの一意のキー。 |
FullIssue
名前 | パス | 型 | 説明 |
---|---|---|---|
問題 ID
|
id | string |
問題を表す一意の ID。 |
問題キー
|
key | string |
問題の一意のキー。 |
問題 URL
|
self | string |
この URL を使用して問題を参照します。 |
問題の種類 ID
|
fields.issuetype.id | string |
問題の種類を表す一意の ID。 |
問題の種類の説明
|
fields.issuetype.description | string |
問題の種類の詳細なタイトル。 |
問題の種類のアイコンの URL
|
fields.issuetype.iconUrl | string |
問題の種類に関連付けられているアイコン。 |
イシューの種類の名前
|
fields.issuetype.name | string |
問題の種類のタイトル。 |
所要時間
|
fields.timespent | integer |
問題に費やした時間 |
プロジェクト ID
|
fields.project.id | string |
プロジェクトの一意の ID。 |
プロジェクト キー
|
fields.project.key | string |
プロジェクトの一意のキー。 |
プロジェクト名
|
fields.project.name | string |
プロジェクトのタイトル。 |
プロジェクト タイプのキー
|
fields.project.projectTypeKey | string |
プロジェクトの種類の一意のキー。 |
費やした集計時間
|
fields.aggregatetimespent | integer |
サブタスクに費やした集計時間。 |
問題解決の URL
|
fields.resolution.self | string | |
問題解決の ID
|
fields.resolution.id | string | |
問題解決の説明
|
fields.resolution.description | string | |
問題解決の名前
|
fields.resolution.name | string | |
解決日
|
fields.resolutiondate | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
作業の比率
|
fields.workratio | integer |
ログに記録された作業対問題の見積もりの割合。 |
作成日
|
fields.created | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
優先順位のアイコンの URL
|
fields.priority.iconUrl | string |
問題の優先順位に関連付けられているアイコン。 |
優先名
|
fields.priority.name | string |
優先順位のタイトル。 |
優先順位 ID
|
fields.priority.id | string |
問題の優先順位の ID。 |
見積もり時間
|
fields.timeestimate | integer |
残り時間の見積もり時間 (秒単位)。 |
見積もり時間の集計
|
fields.aggregatetimeoriginalestimate | integer |
すべてのサブタスクの見積もり時間の元の合計 (秒単位)。 |
担当者 ID
|
fields.assignee.accountId | string |
問題が割り当てられているユーザー。 |
担当者のキー
|
fields.assignee.key | string |
問題が割り当てられているユーザーのユーザー キー。 |
担当者のメール
|
fields.assignee.emailAddress | string |
問題が割り当てられているユーザーのメール。 |
担当者の表示名
|
fields.assignee.displayName | string |
問題が割り当てられているユーザーの表示名。 |
更新日時
|
fields.updated | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
状態の説明
|
fields.status.description | string |
問題の状態。 |
アイコン URL の状態
|
fields.status.iconUrl | string |
問題の状態。 |
状態の名前
|
fields.status.name | string |
問題の状態。 |
状態 ID
|
fields.status.id | string |
問題の状態。 |
カテゴリ ID の状態
|
fields.status.statusCategory.id | integer |
問題の状態のカテゴリ。 |
カテゴリ キーの状態
|
fields.status.statusCategory.key | string |
問題の状態のカテゴリ。 |
カテゴリの色の名前の状態
|
fields.status.statusCategory.colorName | string |
問題の状態のカテゴリ。 |
カテゴリ名の状態
|
fields.status.statusCategory.name | string |
問題の状態のカテゴリ。 |
元の見積もり時間
|
fields.timeoriginalestimate | integer |
元の見積もり時間 (秒単位)。 |
内容
|
fields.description | string |
問題の説明。 |
見積もり時間の集計
|
fields.aggregatetimeestimate | integer |
残りのサブタスクすべての見積もり時間の合計時間 (秒単位)。 |
サマリー
|
fields.summary | string |
問題のタイトル。 |
コンポーネント
|
fields.components | array of object |
'名前' で示される複数の値からなるシステム フィールド (例: Microsoft Entra ID、ネットワーク スイッチ)。 |
コンポーネント ID
|
fields.components.id | string | |
コンポーネント名
|
fields.components.name | string | |
作成者 ID
|
fields.creator.accountId | string |
問題を作成したユーザー。 |
作成者 キー
|
fields.creator.key | string |
問題を作成するユーザーを表す一意のキー。 |
作成者のメール
|
fields.creator.emailAddress | string |
問題を作成したユーザーのメール。 |
作成者の表示名
|
fields.creator.displayName | string |
問題を作成したユーザーの名前。 |
報告者の ID
|
fields.reporter.accountId | string |
問題を報告したユーザー。 |
報告者のキー
|
fields.reporter.key | string |
問題を報告するユーザーを表す一意のキー。 |
報告者のメール
|
fields.reporter.emailAddress | string |
問題を報告したユーザーのメール。 |
報告者の表示名
|
fields.reporter.displayName | string |
問題を報告したユーザーの表示名。 |
完了した集計の進捗
|
fields.aggregateprogress.progress | integer |
すべてのサブタスクの完了した進捗の合計 (秒単位)。 |
集計の推定工数
|
fields.aggregateprogress.total | integer |
推定されたすべてのサブタスク工数の合計。 |
集計の進捗率
|
fields.aggregateprogress.percent | integer |
推定工数に関連して完了した集計の進行状況の割合。 |
期限日時
|
fields.duedate | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
完了した進行状況
|
fields.progress.progress | integer |
進行状況は数秒で完了。 |
推定工数
|
fields.progress.total | integer |
推定工数。 |
進捗率
|
fields.progress.percent | integer |
推定工数に関連して完了した進行状況の割合。 |
エピック名 (customfield_10011)
|
fields.customfield_10119 |
エピック問題の種類にはエピック名が必要です。 このフィールドは、Jira サーバーの 'customfield_10011' フィールドと一致します。 |
UserList
名前 | パス | 型 | 説明 |
---|---|---|---|
Id
|
accountId | string |
プロジェクト メンバーの ID。 |
Key
|
key | string |
ユーザーに関連付けられている一意のキー。 |
電子メール
|
emailAddress | string |
ユーザーのメール アドレス。 |
Display Name
|
displayName | string |
ユーザーの氏名。 |
ListFiltersResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
values
|
values | FilterArray |
FilterArray
名前 | パス | 型 | 説明 |
---|---|---|---|
Id
|
id | string |
フィルターの ID。 |
件名
|
name | string |
フィルターの名前。 |
JQL
|
jql | string |
フィルターで JQL を使用します。 |
ListIssuesResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
件の懸念事項
|
issues | array of FullIssue |
CommentResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
Comment Id
|
id | string |
コメントを表す一意の ID。 |
コメント本文
|
body | string |
コメントの本文。 |
Created Date-Time
|
created | date-time |
yyyy-MM-ddTHH:mm:ss.fffZ |
サイト
名前 | パス | 型 | 説明 |
---|---|---|---|
クラウド ID
|
id | string | |
サイト名
|
name | string | |
サイトの URL
|
url | string |
Transition
名前 | パス | 型 | 説明 |
---|---|---|---|
id
|
id | string |
遷移の ID |
名称
|
name | string |
遷移の名前 |
送信先
|
to | TransitionStatus | |
fields
|
fields | object |
この遷移の必須フィールド |
TransitionStatus
名前 | パス | 型 | 説明 |
---|---|---|---|
id
|
id | string |
状態の ID |
名称
|
name | string |
状態の名前 |