次の方法で共有


az repos pr

Note

このリファレンスは、Azure CLI (バージョン 2.30.0 以降) の azure-devops 拡張機能の一部です。 拡張機能は、az repos pr コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

プル要求を管理します。

コマンド

名前 説明 状態
az repos pr checkout

ローカルの変更がない場合は、PR ソース ブランチをローカルでチェックアウトします。

Extension GA
az repos pr create

pull request を作成します。

Extension GA
az repos pr list

プル要求を一覧表示します。

Extension GA
az repos pr policy

プル要求ポリシーを管理します。

Extension GA
az repos pr policy list

プル要求のポリシーを一覧表示します。

Extension GA
az repos pr policy queue

プル要求のポリシーの評価をキューに登録します。

Extension GA
az repos pr reviewer

pull request レビュー担当者を管理します。

Extension GA
az repos pr reviewer add

プル要求に 1 人以上のレビュー担当者を追加します。

Extension GA
az repos pr reviewer list

プル要求のレビュー担当者を一覧表示します。

Extension GA
az repos pr reviewer remove

pull request から 1 つ以上のレビュー担当者を削除します。

Extension GA
az repos pr set-vote

pull request に投票します。

Extension GA
az repos pr show

プル要求の詳細を取得します。

Extension GA
az repos pr update

pull request を更新します。

Extension GA
az repos pr work-item

プル要求に関連付けられている作業項目を管理します。

Extension GA
az repos pr work-item add

1 つ以上の作業項目をプル要求にリンクします。

Extension GA
az repos pr work-item list

プル要求のリンクされた作業項目を一覧表示します。

Extension GA
az repos pr work-item remove

pull request から 1 つ以上の作業項目のリンクを解除します。

Extension GA

az repos pr checkout

ローカルの変更がない場合は、PR ソース ブランチをローカルでチェックアウトします。

az repos pr checkout --id
                     [--remote-name]

必須のパラメーター

--id

プル要求の ID。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--remote-name

PR が発生する Git リモートの名前。

プロパティ
規定値: origin
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az repos pr create

pull request を作成します。

az repos pr create [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--labels]
                   [--merge-commit-message]
                   [--open]
                   [--optional-reviewers --reviewers]
                   [--org --organization]
                   [--project]
                   [--repository]
                   [--required-reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-complete

すべてのポリシーが成功し、ソース ブランチをターゲット ブランチにマージできる場合に、pull request を自動的に完了するように設定します。

プロパティ
規定値: False
指定可能な値: false, true
--bypass-policy

必要なポリシー (存在する場合) をバイパスし、マージが可能になったら pull request を完了します。

プロパティ
規定値: False
指定可能な値: false, true
--bypass-policy-reason

必要なポリシーをバイパスする理由。

--delete-source-branch

プル要求が完了し、ターゲット ブランチにマージされた後、ソース ブランチを削除します。

プロパティ
規定値: False
指定可能な値: false, true
--description -d

新しいプル要求の説明。 マークダウンを含めることができます。 この引数に送信される各値は新しい行になります。 例: --description "First Line" "Second Line"。

--detect

組織を自動的に検出します。

プロパティ
指定可能な値: false, true
--draft

このフラグを使用して、下書き/作業中モードでプル要求を作成します。

プロパティ
指定可能な値: false, true
--labels

プル要求に関連付けられているラベル。 スペースを区切ります。

--merge-commit-message

コミットがマージされるときに表示されるメッセージ。

--open

Web ブラウザーで pull request を開きます。

プロパティ
規定値: False
--optional-reviewers --reviewers

新しいプル要求にオプションのレビュー担当者として含める追加のユーザーまたはグループ。 スペースを区切ります。

--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

--repository -r

プル要求を作成するリポジトリの名前または ID。

--required-reviewers

新しいプル要求に必要なレビュー担当者として含める追加のユーザーまたはグループ。 スペースを区切ります。

--source-branch -s

ソース ブランチの名前。 例: "dev"

--squash

ターゲット ブランチにマージするときに、ソース ブランチのコミットをスカッシュします。

プロパティ
規定値: False
指定可能な値: false, true
--target-branch -t

ターゲット ブランチの名前。 指定しない場合、既定ではターゲット リポジトリの既定のブランチが使用されます。

--title

新しい pull request のタイトル。

--transition-work-items

pull request にリンクされている作業項目を次の論理状態に移行します。 (例: アクティブ -> 解決済み)。

プロパティ
規定値: False
指定可能な値: false, true
--work-items

新しい pull request にリンクする作業項目の ID。 スペースを区切ります。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az repos pr list

プル要求を一覧表示します。

az repos pr list [--creator]
                 [--detect {false, true}]
                 [--include-links]
                 [--org --organization]
                 [--project]
                 [--repository]
                 [--reviewer]
                 [--skip]
                 [--source-branch]
                 [--status {abandoned, active, all, completed}]
                 [--target-branch]
                 [--top]

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--creator

このユーザーによって作成された pull request に結果を制限します。

--detect

組織を自動的に検出します。

プロパティ
指定可能な値: false, true
--include-links

プル要求ごとに_linksを含めます。

プロパティ
規定値: False
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--project -p

プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git config を使って取得されていない場合は必須です。

--repository -r

リポジトリの名前または ID。

--reviewer

このユーザーがレビュー担当者である pull request に結果を制限します。

--skip

スキップするプル要求の数。

--source-branch -s

このソース ブランチから送信されたプル要求に結果を制限します。

--status

この状態の pull request に結果を制限します。

プロパティ
指定可能な値: abandoned, active, all, completed
--target-branch -t

このブランチを対象とするプル要求に結果を制限します。

--top

一覧表示するプル要求の最大数。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az repos pr set-vote

pull request に投票します。

az repos pr set-vote --id
                     --vote {approve, approve-with-suggestions, reject, reset, wait-for-author}
                     [--detect {false, true}]
                     [--org --organization]

必須のパラメーター

--id

プル要求の ID。

--vote

pull request の新しい投票値。

プロパティ
指定可能な値: approve, approve-with-suggestions, reject, reset, wait-for-author

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

組織を自動的に検出します。

プロパティ
指定可能な値: false, true
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az repos pr show

プル要求の詳細を取得します。

az repos pr show --id
                 [--detect {false, true}]
                 [--open]
                 [--org --organization]

必須のパラメーター

--id

プル要求の ID。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

組織を自動的に検出します。

プロパティ
指定可能な値: false, true
--open

Web ブラウザーで pull request を開きます。

プロパティ
規定値: False
--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az repos pr update

pull request を更新します。

az repos pr update --id
                   [--auto-complete {false, true}]
                   [--bypass-policy {false, true}]
                   [--bypass-policy-reason]
                   [--delete-source-branch {false, true}]
                   [--description]
                   [--detect {false, true}]
                   [--draft {false, true}]
                   [--merge-commit-message]
                   [--org --organization]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

必須のパラメーター

--id

プル要求の ID。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-complete

すべてのポリシーが成功し、ソース ブランチをターゲット ブランチにマージできる場合に、pull request を自動的に完了するように設定します。

プロパティ
指定可能な値: false, true
--bypass-policy

必要なポリシー (存在する場合) をバイパスし、マージが可能になったら pull request を完了します。

プロパティ
指定可能な値: false, true
--bypass-policy-reason

必要なポリシーをバイパスする理由。

--delete-source-branch

プル要求が完了し、ターゲット ブランチにマージされた後、ソース ブランチを削除します。

プロパティ
指定可能な値: false, true
--description -d

pull request の新しい説明。 マークダウンを含めることができます。 この引数に送信される各値は新しい行になります。 例: --description "First Line" "Second Line"。

--detect

組織を自動的に検出します。

プロパティ
指定可能な値: false, true
--draft

PR を発行するか、下書きモードに変換します。

プロパティ
指定可能な値: false, true
--merge-commit-message

コミットがマージされるときに表示されるメッセージ。

--org --organization

Azure DevOps organization URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。例: https://dev.azure.com/MyOrganizationName/.

--squash

ターゲット ブランチにマージするときに、ソース ブランチのコミットをスカッシュします。

プロパティ
指定可能な値: false, true
--status

pull request の新しい状態を設定します。

プロパティ
指定可能な値: abandoned, active, completed
--title

pull request の新しいタイトル。

--transition-work-items

pull request にリンクされている作業項目を次の論理状態に移行します。 (例: アクティブ -> 解決済み)。

プロパティ
指定可能な値: false, true
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False