az pipelines build

リファレンス

Note

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

ビルドを管理します。

コマンド

名前	説明	型	状態
az pipelines build cancel	ビルドが実行されている場合はキャンセルします。	拡張	GA
az pipelines build definition	ビルド定義を管理します。	拡張	GA
az pipelines build definition list	ビルド定義を一覧表示します。	拡張	GA
az pipelines build definition show	ビルド定義の詳細を取得します。	拡張	GA
az pipelines build list	ビルド結果を一覧表示します。	拡張	GA
az pipelines build queue	ビルドを要求 (キュー) します。	拡張	GA
az pipelines build show	ビルドの詳細を取得します。	拡張	GA
az pipelines build tag	ビルドタグを管理します。	拡張	GA
az pipelines build tag add	ビルドのタグを追加します。	拡張	GA
az pipelines build tag delete	ビルドタグを削除します。	拡張	GA
az pipelines build tag list	ビルドのタグを取得します。	拡張	GA

az pipelines build cancel

ビルドが実行されている場合はキャンセルします。

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org]
                          [--project]

必須のパラメーター

--build-id

ビルドの ID。

省略可能のパラメーター

--detect

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

指定可能な値: false, true

--open

Web ブラウザーでビルド結果ページを開きます。

規定値: False

--org --organization

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

--project -p

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

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az pipelines build list

ビルド結果を一覧表示します。

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

省略可能のパラメーター

--branch

このブランチのビルドでフィルター処理します。

--definition-ids

ビルドを一覧表示する定義の ID (スペース区切り)。

--detect

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

指定可能な値: false, true

--org --organization

--project -p

--reason

この理由でビルドに制限します。

指定可能な値: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset

--requested-for

このユーザーまたはグループに対して要求されたビルドに制限します。

--result

この結果を使用してビルドに制限します。

指定可能な値: canceled, failed, none, partiallySucceeded, succeeded

--status

この状態のビルドに制限します。

指定可能な値: all, cancelling, completed, inProgress, none, notStarted, postponed

--tags

指定された各タグを持つビルドに制限します。スペースを区切ります。

--top

一覧表示するビルドの最大数。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az pipelines build queue

ビルドを要求 (キュー) します。

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org]
                         [--project]
                         [--queue-id]
                         [--variables]

省略可能のパラメーター

--branch

ビルドするブランチ。定義に既定のブランチが設定されていない場合は必須です。例: refs/heads/master、master、refs/pull/1/merge、refs/tags/tag。

--commit-id

ビルドするブランチのコミット ID。

--definition-id

キューに登録する定義の ID。 --name が指定されていない場合は必須です。

--definition-name

キューに格納する定義の名前。 --id が指定されている場合は無視されます。

--detect

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

指定可能な値: false, true

--open

Web ブラウザーでビルド結果ページを開きます。

規定値: False

--org --organization

--project -p

--queue-id

ビルドのキューに使用されるプールのキュー ID。

--variables

設定する変数のスペース区切りの "name=value" ペア。

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

az pipelines build show

ビルドの詳細を取得します。

az pipelines build show --id
                        [--detect {false, true}]
                        [--open]
                        [--org]
                        [--project]

必須のパラメーター

--id

ビルドの ID。

省略可能のパラメーター

--detect

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

指定可能な値: false, true

--open

Web ブラウザーでビルド結果ページを開きます。

規定値: False

--org --organization

--project -p

グローバルパラメーター

--debug

すべてのデバッグログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc

規定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。詳細なデバッグログを表示するには --debug を使います。

次の方法で共有

az pipelines build

コマンド

az pipelines build cancel

必須のパラメーター

省略可能のパラメーター

az pipelines build list

省略可能のパラメーター

az pipelines build queue

省略可能のパラメーター

az pipelines build show

必須のパラメーター

省略可能のパラメーター

その他のリソース