Azure / Azure/azure-cli-extensions

az repos policy build create - how to set 'Build Expiration: immediately on change'

Open
#1,307 2 comments 1 reaction 0 assignees View on GitHub
customer-reported DevOps Service Attention
Dominant language
Python
Stars
454
Forks
1.7k
Avg merge
2d 19h
Merged PRs (30d)
64

Description

When creating a build policy via the web UI there is the option to make the build validation expire immediately when the source branch changes.

When creating one using the az cli devops extension it's not clear how to do this.

`--queue-on-source-update-only false --manual-queue-only false --valid-duration 0`

---
#### Document Details

⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.*

* ID: 4f18c5a2-b9c6-77d8-28b6-e6576602bc4a
* Version Independent ID: 5943b200-4ab4-80c1-c702-5b02ac9d101d
* Content: [az repos policy build](https://docs.microsoft.com/en-us/cli/azure/ext/azure-devops/repos/policy/build?view=azure-cli-latest#ext-azure-devops-az-repos-policy-build-create)
* Content Source: [latest/docs-ref-autogen/ext/azure-devops/repos/policy/build.yml](https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/latest/docs-ref-autogen/ext/azure-devops/repos/policy/build.yml)
* GitHub Login: @rloutlaw
* Microsoft Alias: **routlaw**

Contributor guide

Open the contributing guide

Research direction

Start with latest/docs-ref-autogen/ext/azure-devops/repos/policy/build.yml and the az repos policy build create documentation linked in the issue. Verify how the listed flags represent the web UI's immediate-expiration setting, then update the documentation so the required command options and completed behavior are clear.

Written by the indexing model from the issue text.

Assessment

Domain
cli, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.