Compartilhar via

az repos pr

  • Referência

Observação

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 será instalada 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

Faça check-out da ramificação de origem do PR localmente, se nenhuma alteração local estiver presente.

 Extensão GA
az repos pr create

Criar uma solicitação de pull.

 Extensão GA
az repos pr list

Listar solicitações pull.

 Extensão GA
az repos pr policy

Gerenciar política de solicitação pull.

 Extensão GA
az repos pr policy list

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

 Extensão GA
az repos pr policy queue

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

 Extensão GA
az repos pr reviewer

Gerenciar revisores de solicitação de pull.

 Extensão GA
az repos pr reviewer add

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

 Extensão GA
az repos pr reviewer list

Listar revisores de uma solicitação pull.

 Extensão GA
az repos pr reviewer remove

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

 Extensão GA
az repos pr set-vote

Vote em um pedido de puxada.

 Extensão GA
az repos pr show

Obtenha os detalhes de uma solicitação pull.

 Extensão GA
az repos pr update

Atualizar uma solicitação pull.

 Extensão GA
az repos pr work-item

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

 Extensão GA
az repos pr work-item add

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

 Extensão GA
az repos pr work-item list

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

 Extensão GA
az repos pr work-item remove

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

 Extensão GA

az repos pr checkout

Faça check-out da ramificação de origem do 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

--remote-name

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

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

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az repos pr create

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

Parâmetros Opcionais

--auto-complete

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

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

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

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

Motivo para ignorar as políticas necessárias.

--delete-source-branch

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

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

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

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--draft

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

Valores aceitos: false, true
--labels

Os rótulos associados à solicitação 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.

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

Usuários ou grupos adicionais a serem incluídos como revisores opcionais na nova solicitação 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 conforme necessário na nova solicitação pull. Espaço separado.

--source-branch -s

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

--squash

Esmague os commits no branch de origem ao mesclar no branch de destino.

Valores aceitos: false, true
Valor padrão: False
--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 quaisquer itens de trabalho vinculados à solicitação pull para o próximo estado lógico. (por exemplo, Ativo -> Resolvido).

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

IDs dos itens de trabalho a serem vinculados à nova solicitação pull. Espaço separado.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az repos pr list

Listar solicitações 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]

Parâmetros Opcionais

--creator

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

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--include-links

Inclua _links para cada solicitação de pull.

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 a 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 a solicitações de pull originadas desse branch de origem.

--status

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

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

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

--top

Número máximo de solicitações de pull a serem listadas.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az repos pr set-vote

Vote em um pedido de puxada.

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

Parâmetros Exigidos

--id

ID da solicitação de pull.

--vote

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

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

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az repos pr show

Obtenha os detalhes de uma solicitação pull.

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

Parâmetros Exigidos

--id

ID da solicitação de pull.

Parâmetros Opcionais

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--open

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

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.

az repos pr update

Atualizar uma solicitação 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}]

Parâmetros Exigidos

--id

ID da solicitação de pull.

Parâmetros Opcionais

--auto-complete

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

Valores aceitos: false, true
--bypass-policy

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

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

Motivo para ignorar as políticas necessárias.

--delete-source-branch

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

Valores aceitos: false, true
--description -d

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

--detect

Detectar a organização automaticamente.

Valores aceitos: false, true
--draft

Publique o PR ou converta para o modo de rascunho.

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 de git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

--squash

Esmague as confirmações na ramificação de origem ao mesclar na ramificação de destino.

Valores aceitos: false, true
--status

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

Valores aceitos: abandoned, active, completed
--title

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

--transition-work-items

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

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

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--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 o detalhamento do log. Use --debug para logs de depuração completos.