az repos pr

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.