az pipelines build

Note

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

ビルドを管理します。

コマンド

名前	説明	型	Status
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

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 構成を使用して取得された場合は必須です。

--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

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 構成を使用して取得された場合は必須です。

--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

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 を使います。