Partager via

az repos pr

  • Référence

Remarque

Cette référence fait partie de l’extension azure-devops pour Azure CLI (version 2.30.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az repos pr . En savoir plus sur les extensions.

Gérer les demandes de tirage.

Commandes

Nom Description Type Statut
az repos pr checkout

Vérifiez la branche source de demande de tirage localement, si aucune modification locale n’est présente.

 Extension GA
az repos pr create

Créer une demande de tirage.

 Extension GA
az repos pr list

Répertorier les demandes de tirage( pull request).

 Extension GA
az repos pr policy

Gérer la stratégie de demande de tirage (pull request).

 Extension GA
az repos pr policy list

Répertorier les stratégies d’une demande de tirage( pull request).

 Extension GA
az repos pr policy queue

Mettre en file d’attente une évaluation d’une stratégie pour une demande de tirage.

 Extension GA
az repos pr reviewer

Gérer les réviseurs de demande de tirage.

 Extension GA
az repos pr reviewer add

Ajoutez un ou plusieurs réviseurs à une demande de tirage.

 Extension GA
az repos pr reviewer list

Répertorier les réviseurs d’une demande de tirage.

 Extension GA
az repos pr reviewer remove

Supprimez un ou plusieurs réviseurs d’une demande de tirage.

 Extension GA
az repos pr set-vote

Votez sur une demande de tirage.

 Extension GA
az repos pr show

Obtenez les détails d’une demande de tirage.

 Extension GA
az repos pr update

Mettez à jour une demande de tirage( pull request).

 Extension GA
az repos pr work-item

Gérer les éléments de travail associés aux demandes de tirage.

 Extension GA
az repos pr work-item add

Lier un ou plusieurs éléments de travail à une demande de tirage.

 Extension GA
az repos pr work-item list

Répertorier les éléments de travail liés pour une demande de tirage.

 Extension GA
az repos pr work-item remove

Dissociez un ou plusieurs éléments de travail d’une demande de tirage.

 Extension GA

az repos pr checkout

Vérifiez la branche source de demande de tirage localement, si aucune modification locale n’est présente.

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

Paramètres obligatoires

--id

ID de la demande de tirage.

Paramètres facultatifs

--remote-name

Nom de dépôt distant git sur lequel la demande de tirage est effectuée.

valeur par défaut: origin
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az repos pr create

Créer une demande de tirage.

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]

Paramètres facultatifs

--auto-complete

Définissez la demande de tirage automatiquement lorsque toutes les stratégies sont passées et que la branche source peut être fusionnée dans la branche cible.

valeurs acceptées: false, true
valeur par défaut: False
--bypass-policy

Contournez les stratégies requises (le cas échéant) et terminez la demande de tirage une fois qu’elle peut être fusionnée.

valeurs acceptées: false, true
valeur par défaut: False
--bypass-policy-reason

Raison de contourner les stratégies requises.

--delete-source-branch

Supprimez la branche source une fois la demande de tirage terminée et fusionnée dans la branche cible.

valeurs acceptées: false, true
valeur par défaut: False
--description -d

Description de la nouvelle demande de tirage. Peut inclure markdown. Chaque valeur envoyée à cet argument sera une nouvelle ligne. Par exemple : --description « Première ligne » « Deuxième ligne ».

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--draft

Utilisez cet indicateur pour créer la demande de tirage en mode brouillon/travail en cours.

valeurs acceptées: false, true
--labels

Étiquettes associées à la demande de tirage. Espace séparé.

--merge-commit-message

Message affiché lorsque les validations sont fusionnées.

--open

Ouvrez la demande de tirage dans votre navigateur web.

valeur par défaut: False
--optional-reviewers --reviewers

Utilisateurs ou groupes supplémentaires à inclure en tant que réviseurs facultatifs sur la nouvelle demande de tirage. Espace séparé.

--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config.

--repository -r

Nom ou ID du référentiel dans lequel créer la demande de tirage.

--required-reviewers

Utilisateurs ou groupes supplémentaires à inclure en tant que réviseurs requis sur la nouvelle demande de tirage. Espace séparé.

--source-branch -s

Nom de la branche source. Exemple : « dev ».

--squash

Supprimez les validations dans la branche source lors de la fusion dans la branche cible.

valeurs acceptées: false, true
valeur par défaut: False
--target-branch -t

Nom de la branche cible. S’il n’est pas spécifié, la branche par défaut du référentiel cible est définie par défaut.

--title

Titre de la nouvelle demande de tirage.

--transition-work-items

Effectuez la transition d’éléments de travail liés à la demande de tirage dans l’état logique suivant. (par exemple, Actif -> Résolu).

valeurs acceptées: false, true
valeur par défaut: False
--work-items

ID des éléments de travail à lier à la nouvelle demande de tirage. Espace séparé.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az repos pr list

Répertorier les demandes de tirage( pull request).

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]

Paramètres facultatifs

--creator

Limitez les résultats aux demandes de tirage créées par cet utilisateur.

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--include-links

Incluez _links pour chaque demande de tirage.

valeur par défaut: False
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire s’il n’est pas configuré par défaut ou récupéré via la configuration git.

--repository -r

Nom ou ID du référentiel.

--reviewer

Limitez les résultats aux demandes de tirage pour lesquelles cet utilisateur est un réviseur.

--skip

Nombre de demandes de tirage à ignorer.

--source-branch -s

Limitez les résultats aux demandes de tirage provenant de cette branche source.

--status

Limitez les résultats aux demandes de tirage avec cet état.

valeurs acceptées: abandoned, active, all, completed
--target-branch -t

Limitez les résultats aux demandes de tirage qui ciblent cette branche.

--top

Nombre maximal de demandes de tirage à lister.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az repos pr set-vote

Votez sur une demande de tirage.

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

Paramètres obligatoires

--id

ID de la demande de tirage.

--vote

Nouvelle valeur de vote pour la demande de tirage.

valeurs acceptées: approve, approve-with-suggestions, reject, reset, wait-for-author

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az repos pr show

Obtenez les détails d’une demande de tirage.

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

Paramètres obligatoires

--id

ID de la demande de tirage.

Paramètres facultatifs

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--open

Ouvrez la demande de tirage dans votre navigateur web.

valeur par défaut: False
--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az repos pr update

Mettez à jour une demande de tirage( 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]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

Paramètres obligatoires

--id

ID de la demande de tirage.

Paramètres facultatifs

--auto-complete

Définissez la demande de tirage automatiquement lorsque toutes les stratégies sont passées et que la branche source peut être fusionnée dans la branche cible.

valeurs acceptées: false, true
--bypass-policy

Contournez les stratégies requises (le cas échéant) et terminez la demande de tirage une fois qu’elle peut être fusionnée.

valeurs acceptées: false, true
--bypass-policy-reason

Raison de contourner les stratégies requises.

--delete-source-branch

Supprimez la branche source une fois la demande de tirage terminée et fusionnée dans la branche cible.

valeurs acceptées: false, true
--description -d

Nouvelle description de la demande de tirage. Peut inclure markdown. Chaque valeur envoyée à cet argument sera une nouvelle ligne. Par exemple : --description « Première ligne » « Deuxième ligne ».

--detect

Détectez automatiquement l’organisation.

valeurs acceptées: false, true
--draft

Publiez la demande de tirage ou convertissez en mode brouillon.

valeurs acceptées: false, true
--merge-commit-message

Message affiché lorsque les validations sont fusionnées.

--org --organization

URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--squash

Supprimez les validations dans la branche source lors de la fusion dans la branche cible.

valeurs acceptées: false, true
--status

Définissez le nouvel état de la demande de tirage.

valeurs acceptées: abandoned, active, completed
--title

Nouveau titre pour la demande de tirage.

--transition-work-items

Effectuez la transition d’éléments de travail liés à la demande de tirage dans l’état logique suivant. (par exemple, Actif -> Résolu).

valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.