Compartilhar via

az repos pr

Note

Essa referência faz parte da extensão azure-devops para a CLI do Azure (versão 2.30.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az repos pr. Saiba mais sobre extensões.

Gerenciar solicitações de pull.

Comandos

Nome Description Tipo Status
az repos pr checkout

Verifique o branch de origem de PR localmente, se nenhuma alteração local estiver presente.

 Extension GA
az repos pr create

Crie uma solicitação de pull.

 Extension GA
az repos pr list

Listar solicitações de pull.

 Extension GA
az repos pr policy

Gerenciar a política de solicitação de pull.

 Extension GA
az repos pr policy list

Listar políticas de uma solicitação de pull.

 Extension GA
az repos pr policy queue

Enfileirar uma avaliação de uma política para uma solicitação de pull.

 Extension GA
az repos pr reviewer

Gerenciar revisores de solicitação de pull.

 Extension GA
az repos pr reviewer add

Adicione um ou mais revisores a uma solicitação de pull.

 Extension GA
az repos pr reviewer list

Listar revisores de uma solicitação pull.

 Extension GA
az repos pr reviewer remove

Remova um ou mais revisores de uma solicitação de pull.

 Extension GA
az repos pr set-vote

Vote em uma solicitação de pull.

 Extension GA
az repos pr show

Obtenha os detalhes de uma solicitação de pull.

 Extension GA
az repos pr update

Atualize uma solicitação de pull.

 Extension GA
az repos pr work-item

Gerenciar itens de trabalho associados a solicitações de pull.

 Extension GA
az repos pr work-item add

Vincule um ou mais itens de trabalho a uma solicitação de pull.

 Extension GA
az repos pr work-item list

Listar itens de trabalho vinculados para uma solicitação de pull.

 Extension GA
az repos pr work-item remove

Desvincular um ou mais itens de trabalho de uma solicitação de pull.

 Extension GA

az repos pr checkout

Verifique o branch de origem de PR localmente, se nenhuma alteração local estiver presente.

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

Parâmetros Exigidos

--id

ID da solicitação de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--remote-name

Nome do git remoto em relação ao qual a PR é gerada.

Propriedade Valor
Valor padrão: origin
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az repos pr create

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--auto-complete

Defina a solicitação de pull para ser concluída automaticamente quando todas as políticas tiverem passado e o branch de origem puder ser mesclado no branch de destino.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--bypass-policy

Ignore as políticas necessárias (se houver) e conclua a solicitação de pull assim que ela puder ser mesclada.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--bypass-policy-reason

Motivo para ignorar as políticas necessárias.

--delete-source-branch

Exclua o branch de origem depois que a solicitação de pull tiver sido concluída e mesclada no branch de destino.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--description -d

Descrição da nova solicitação de pull. Pode incluir markdown. Cada valor enviado a esse arg será uma nova linha. Por exemplo: --description "First Line" "Second Line".

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--draft

Use esse sinalizador para criar a solicitação de pull no modo de rascunho/trabalho em andamento.

Propriedade Valor
Valores aceitos: false, true
--labels

Os rótulos associados à solicitação de pull. Espaço separado.

--merge-commit-message

Mensagem exibida quando as confirmações são mescladas.

--open

Abra a solicitação de pull no navegador da Web.

Propriedade Valor
Valor padrão: False
--optional-reviewers --reviewers

Usuários ou grupos adicionais a serem incluídos como revisores opcionais na nova solicitação de pull. Espaço separado.

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

--repository -r

Nome ou ID do repositório para criar a solicitação de pull.

--required-reviewers

Usuários ou grupos adicionais a serem incluídos como revisores necessários na nova solicitação de pull. Espaço separado.

--source-branch -s

Nome do branch de origem. Exemplo: "dev".

--squash

Esmague as confirmações no branch de origem ao mesclar no branch de destino.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--target-branch -t

Nome do branch de destino. Se não for especificado, o padrão será o branch padrão do repositório de destino.

--title

Título da nova solicitação de pull.

--transition-work-items

Faça a transição de todos os itens de trabalho vinculados à solicitação de pull para o próximo estado lógico. (por exemplo, Ativo –> Resolvido).

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--work-items

IDs dos itens de trabalho para vincular à nova solicitação de pull. Espaço separado.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az repos pr list

Listar solicitações de pull.

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]

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--creator

Limite os resultados para solicitações de pull criadas por esse usuário.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--include-links

Inclua _links para cada solicitação de pull.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nome ou ID do projeto. Você pode configurar o projeto padrão usando az devops configure -d project=NAME_OR_ID. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração Git.

--repository -r

Nome ou ID do repositório.

--reviewer

Limite os resultados para solicitações de pull em que esse usuário é um revisor.

--skip

Número de solicitações de pull a serem ignoradas.

--source-branch -s

Limite os resultados para solicitações de pull originadas desse branch de origem.

--status

Limite os resultados a solicitações de pull com esse status.

Propriedade Valor
Valores aceitos: abandoned, active, all, completed
--target-branch -t

Limite os resultados para solicitações de pull direcionadas a esse branch.

--top

Número máximo de solicitações de pull para listar.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az repos pr set-vote

Vote em uma solicitação de pull.

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

Parâmetros Exigidos

--id

ID da solicitação de pull.

--vote

Novo valor de votação para a solicitação de pull.

Propriedade Valor
Valores aceitos: approve, approve-with-suggestions, reject, reset, wait-for-author

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az repos pr show

Obtenha os detalhes de uma solicitação de pull.

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

Parâmetros Exigidos

--id

ID da solicitação de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--open

Abra a solicitação de pull no navegador da Web.

Propriedade Valor
Valor padrão: False
--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az repos pr update

Atualize uma solicitação de 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 --organization]
                   [--squash {false, true}]
                   [--status {abandoned, active, completed}]
                   [--title]
                   [--transition-work-items {false, true}]

Parâmetros Exigidos

--id

ID da solicitação de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--auto-complete

Defina a solicitação de pull para ser concluída automaticamente quando todas as políticas tiverem passado e o branch de origem puder ser mesclado no branch de destino.

Propriedade Valor
Valores aceitos: false, true
--bypass-policy

Ignore as políticas necessárias (se houver) e conclua a solicitação de pull assim que ela puder ser mesclada.

Propriedade Valor
Valores aceitos: false, true
--bypass-policy-reason

Motivo para ignorar as políticas necessárias.

--delete-source-branch

Exclua o branch de origem depois que a solicitação de pull tiver sido concluída e mesclada no branch de destino.

Propriedade Valor
Valores aceitos: false, true
--description -d

Nova descrição da solicitação de pull. Pode incluir markdown. Cada valor enviado a esse arg será uma nova linha. Por exemplo: --description "First Line" "Second Line".

--detect

Detecte automaticamente a organização.

Propriedade Valor
Valores aceitos: false, true
--draft

Publique a PR ou converta no modo de rascunho.

Propriedade Valor
Valores aceitos: false, true
--merge-commit-message

Mensagem exibida quando as confirmações são mescladas.

--org --organization

URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado por meio da configuração git. Exemplo: https://dev.azure.com/MyOrganizationName/.

--squash

Esmague as confirmações no branch de origem ao mesclar no branch de destino.

Propriedade Valor
Valores aceitos: false, true
--status

Defina o novo estado da solicitação de pull.

Propriedade Valor
Valores aceitos: abandoned, active, completed
--title

Novo título para a solicitação de pull.

--transition-work-items

Faça a transição de todos os itens de trabalho vinculados à solicitação de pull para o próximo estado lógico. (por exemplo, Ativo –> Resolvido).

Propriedade Valor
Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False