Partager via


az repos pr

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). L’extension installe automatiquement la première fois que vous exécutez une commande az repos pr. Learn more about extensions.

Gérer les demandes de tirage.

Commandes

Nom Description Type État
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éez une demande de tirage ( pull request).

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--remote-name

Nom de git distant sur lequel la demande de tirage est déclenchée.

Propriété Valeur
Valeur par défaut: origin
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az repos pr create

Créez une demande de tirage ( pull request).

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-complete

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

Propriété Valeur
Valeur par défaut: False
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.

Propriété Valeur
Valeur par défaut: False
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.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

Propriété Valeur
Valeurs acceptées: false, true
--draft

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

Propriété Valeur
Valeurs acceptées: false, true
--labels

Étiquettes associées à la demande de tirage. Space separated.

--merge-commit-message

Message affiché lorsque les validations sont fusionnées.

--open

Ouvrez la demande de tirage dans votre navigateur web.

Propriété Valeur
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. Space separated.

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 ce paramètre n’est pas configuré par défaut ou récupéré avec 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. Space separated.

--source-branch -s

Nom de la branche source. Example: "dev".

--squash

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

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--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).

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--work-items

ID des éléments de travail à lier à la nouvelle demande de tirage. Space separated.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az repos pr list

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

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

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--creator

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

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--include-links

Incluez _links pour chaque demande de tirage.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. 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 ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

--reviewer

Limitez les résultats aux demandes d’extraction où 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.

Propriété Valeur
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 la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

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

Paramètres obligatoires

--id

ID de la demande de tirage.

--vote

Nouvelle valeur de vote pour la demande de tirage.

Propriété Valeur
Valeurs acceptées: approve, approve-with-suggestions, reject, reset, wait-for-author

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az repos pr show

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

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

Paramètres obligatoires

--id

ID de la demande de tirage.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--open

Ouvrez la demande de tirage dans votre navigateur web.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

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 --organization]
                   [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-complete

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

Propriété Valeur
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.

Propriété Valeur
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.

Propriété Valeur
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.

Propriété Valeur
Valeurs acceptées: false, true
--draft

Publiez la demande de tirage ou convertissez en mode brouillon.

Propriété Valeur
Valeurs acceptées: false, true
--merge-commit-message

Message affiché lorsque les validations sont fusionnées.

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--squash

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

Propriété Valeur
Valeurs acceptées: false, true
--status

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

Propriété Valeur
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).

Propriété Valeur
Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Output format.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False