az repos pr

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-devops per l'interfaccia della riga di comando di Azure (versione 2.30.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az repos pr . Altre informazioni sulle estensioni.

Gestire le richieste pull.

Comandi

Nome Descrizione Tipo Stato
az repos pr checkout

Eseguire il checkout del ramo di origine della richiesta pull in locale, se non sono presenti modifiche locali.

 Estensione Disponibilità generale
az repos pr create

Creare una richiesta pull.

 Estensione Disponibilità generale
az repos pr list

Elencare le richieste pull.

 Estensione Disponibilità generale
az repos pr policy

Gestire i criteri di richiesta pull.

 Estensione Disponibilità generale
az repos pr policy list

Elencare i criteri di una richiesta pull.

 Estensione Disponibilità generale
az repos pr policy queue

Accoda una valutazione di un criterio per una richiesta pull.

 Estensione Disponibilità generale
az repos pr reviewer

Gestire i revisori delle richieste pull.

 Estensione Disponibilità generale
az repos pr reviewer add

Aggiungere uno o più revisori a una richiesta pull.

 Estensione Disponibilità generale
az repos pr reviewer list

Elencare i revisori di una richiesta pull.

 Estensione Disponibilità generale
az repos pr reviewer remove

Rimuovere uno o più revisori da una richiesta pull.

 Estensione Disponibilità generale
az repos pr set-vote

Votare su una richiesta pull.

 Estensione Disponibilità generale
az repos pr show

Ottenere i dettagli di una richiesta pull.

 Estensione Disponibilità generale
az repos pr update

Aggiornare una richiesta pull.

 Estensione Disponibilità generale
az repos pr work-item

Gestire gli elementi di lavoro associati alle richieste pull.

 Estensione Disponibilità generale
az repos pr work-item add

Collegare uno o più elementi di lavoro a una richiesta pull.

 Estensione Disponibilità generale
az repos pr work-item list

Elencare gli elementi di lavoro collegati per una richiesta pull.

 Estensione Disponibilità generale
az repos pr work-item remove

Scollegare uno o più elementi di lavoro da una richiesta pull.

 Estensione Disponibilità generale

az repos pr checkout

Eseguire il checkout del ramo di origine della richiesta pull in locale, se non sono presenti modifiche locali.

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

Parametri necessari

--id

ID della richiesta pull.

Parametri facoltativi

--remote-name

Nome di git remote in base al quale viene generata la richiesta pull.

valore predefinito: origin
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos pr create

Creare una richiesta pull.

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]
                   [--org]
                   [--project]
                   [--repository]
                   [--required-reviewers]
                   [--source-branch]
                   [--squash {false, true}]
                   [--target-branch]
                   [--title]
                   [--transition-work-items {false, true}]
                   [--work-items]

Parametri facoltativi

--auto-complete

Impostare la richiesta pull da completare automaticamente quando tutti i criteri sono stati superati e il ramo di origine può essere unito al ramo di destinazione.

valori accettati: false, true
valore predefinito: False
--bypass-policy

Ignorare i criteri obbligatori (se presenti) e completa la richiesta pull una volta che può essere unita.

valori accettati: false, true
valore predefinito: False
--bypass-policy-reason

Motivo per ignorare i criteri richiesti.

--delete-source-branch

Eliminare il ramo di origine dopo che la richiesta pull è stata completata e unita nel ramo di destinazione.

valori accettati: false, true
valore predefinito: False
--description -d

Descrizione per la nuova richiesta pull. Può includere markdown. Ogni valore inviato a questo argomento sarà una nuova riga. Ad esempio: --description "Prima riga" "Seconda riga".

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--draft

Usare questo flag per creare la richiesta pull in modalità bozza/lavoro in corso.

valori accettati: false, true
--labels

Etichette associate alla richiesta pull. Spazio separato.

--merge-commit-message

Messaggio visualizzato quando vengono uniti i commit.

--open

Aprire la richiesta pull nel Web browser.

valore predefinito: False
--optional-reviewers --reviewers

Altri utenti o gruppi da includere come revisori facoltativi nella nuova richiesta pull. Spazio separato.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--repository -r

Nome o ID del repository in cui creare la richiesta pull.

--required-reviewers

Altri utenti o gruppi da includere come revisori necessari nella nuova richiesta pull. Spazio separato.

--source-branch -s

Nome del ramo di origine. Esempio: "dev".

--squash

Eseguire lo squash dei commit nel ramo di origine durante l'unione nel ramo di destinazione.

valori accettati: false, true
valore predefinito: False
--target-branch -t

Nome del ramo di destinazione. Se non specificato, per impostazione predefinita viene impostato il ramo predefinito del repository di destinazione.

--title

Titolo per la nuova richiesta pull.

--transition-work-items

Eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo. (ad esempio, Attivo -> Risolto).

valori accettati: false, true
valore predefinito: False
--work-items

ID degli elementi di lavoro da collegare alla nuova richiesta pull. Spazio separato.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos pr list

Elencare le richieste pull.

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

Parametri facoltativi

--creator

Limitare i risultati alle richieste pull create dall'utente.

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--include-links

Includere _links per ogni richiesta pull.

valore predefinito: False
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.

--repository -r

Nome o ID del repository.

--reviewer

Limitare i risultati alle richieste pull in cui l'utente è un revisore.

--skip

Numero di richieste pull da ignorare.

--source-branch -s

Limitare i risultati alle richieste pull provenienti da questo ramo di origine.

--status

Limitare i risultati alle richieste pull con questo stato.

valori accettati: abandoned, active, all, completed
--target-branch -t

Limitare i risultati alle richieste pull destinate a questo ramo.

--top

Numero massimo di richieste pull da elencare.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos pr set-vote

Votare su una richiesta pull.

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

Parametri necessari

--id

ID della richiesta pull.

--vote

Nuovo valore di voto per la richiesta pull.

valori accettati: approve, approve-with-suggestions, reject, reset, wait-for-author

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos pr show

Ottenere i dettagli di una richiesta pull.

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

Parametri necessari

--id

ID della richiesta pull.

Parametri facoltativi

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--open

Aprire la richiesta pull nel Web browser.

valore predefinito: False
--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az repos pr update

Aggiornare una richiesta pull.

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]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

Parametri necessari

--id

ID della richiesta pull.

Parametri facoltativi

--auto-complete

Impostare la richiesta pull da completare automaticamente quando tutti i criteri sono stati superati e il ramo di origine può essere unito al ramo di destinazione.

valori accettati: false, true
--bypass-policy

Ignorare i criteri obbligatori (se presenti) e completa la richiesta pull una volta che può essere unita.

valori accettati: false, true
--bypass-policy-reason

Motivo per ignorare i criteri richiesti.

--delete-source-branch

Eliminare il ramo di origine dopo che la richiesta pull è stata completata e unita nel ramo di destinazione.

valori accettati: false, true
--description -d

Nuova descrizione per la richiesta pull. Può includere markdown. Ogni valore inviato a questo argomento sarà una nuova riga. Ad esempio: --description "Prima riga" "Seconda riga".

--detect

Rilevare automaticamente l'organizzazione.

valori accettati: false, true
--draft

Pubblicare la richiesta pull o convertirla in modalità bozza.

valori accettati: false, true
--merge-commit-message

Messaggio visualizzato quando vengono uniti i commit.

--org --organization

URL dell'organizzazione di Azure DevOps. È possibile configurare l'organizzazione predefinita usando az devops configure -d organization=ORG_URL. Obbligatorio se non è configurato come predefinito o selezionato tramite git config. Esempio: https://dev.azure.com/MyOrganizationName/.

--squash

Eseguire lo squash dei commit nel ramo di origine durante l'unione nel ramo di destinazione.

valori accettati: false, true
--status

Impostare il nuovo stato della richiesta pull.

valori accettati: abandoned, active, completed
--title

Nuovo titolo per la richiesta pull.

--transition-work-items

Eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo. (ad esempio, Attivo -> Risolto).

valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.