Partilhar 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 será instalada automaticamente na primeira vez que você executar um comando az repos pr. Saiba mais sobre extensões.

Gerencie solicitações pull.

Comandos

Name Description Tipo Status
az repos pr checkout

Faça checkout da ramificação de origem de RP localmente, se nenhuma alteração local estiver presente.

 Extension disponibilidade geral
az repos pr create

Crie uma solicitação pull.

 Extension disponibilidade geral
az repos pr list

Listar solicitações pull.

 Extension disponibilidade geral
az repos pr policy

Gerencie a política de pull request.

 Extension disponibilidade geral
az repos pr policy list

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

 Extension disponibilidade geral
az repos pr policy queue

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

 Extension disponibilidade geral
az repos pr reviewer

Gerencie revisores de solicitação pull.

 Extension disponibilidade geral
az repos pr reviewer add

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

 Extension disponibilidade geral
az repos pr reviewer list

Listar revisores de uma solicitação pull.

 Extension disponibilidade geral
az repos pr reviewer remove

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

 Extension disponibilidade geral
az repos pr set-vote

Vote em um pull request.

 Extension disponibilidade geral
az repos pr show

Obtenha os detalhes de um pull request.

 Extension disponibilidade geral
az repos pr update

Atualize uma solicitação pull.

 Extension disponibilidade geral
az repos pr work-item

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

 Extension disponibilidade geral
az repos pr work-item add

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

 Extension disponibilidade geral
az repos pr work-item list

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

 Extension disponibilidade geral
az repos pr work-item remove

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

 Extension disponibilidade geral

az repos pr checkout

Faça checkout da ramificação de origem de RP localmente, se nenhuma alteração local estiver presente.

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

Parâmetros Obrigatórios

--id

Identificador do pedido de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--remote-name

Nome do repositório remoto git para o qual o pedido de pull (PR) é criado.

Propriedade Valor
Default value: origin
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az repos pr create

Crie uma solicitação 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 tornar-se necessários para que o comando seja executado com êxito.

--auto-complete

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--bypass-policy

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--bypass-policy-reason

Razão para ignorar as políticas necessárias.

--delete-source-branch

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--description -d

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

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--draft

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

Propriedade Valor
Valores aceites: 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 pull no seu navegador da Web.

Propriedade Valor
Default value: False
--optional-reviewers --reviewers

Usuários ou grupos adicionais para incluir 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. Necessário se não configurado como padrão ou captado via git config. 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. Necessário se não configurado como padrão ou captado via git config.

--repository -r

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

--required-reviewers

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

--source-branch -s

Nome da ramificação de origem. Exemplo: "dev".

--squash

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--target-branch -t

Nome da ramificação de destino. Se não for especificado, o padrão será a ramificação padrão do repositório de destino.

--title

Título da nova solicitação pull.

--transition-work-items

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

Propriedade Valor
Default value: False
Valores aceites: false, true
--work-items

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az repos pr list

Listar solicitações 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 tornar-se necessários para que o comando seja executado com êxito.

--creator

Limite os resultados às solicitações de pull criadas por este utilizador.

--detect

Detete automaticamente a organização.

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

Inclua _links para cada pull request.

Propriedade Valor
Default value: 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. Necessário se não configurado como padrão ou captado via git config. 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. Necessário se não configurado como padrão ou captado via git config.

--repository -r

Nome ou ID do repositório.

--reviewer

Limite os resultados a pedidos de pull onde este utilizador é revisor.

--skip

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

--source-branch -s

Limite os resultados para receber solicitações originadas dessa ramificação de origem.

--status

Limite os resultados para receber solicitações com esse status.

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

Limite os resultados para solicitações de pull direcionadas a essa ramificação.

--top

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

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az repos pr set-vote

Vote em um pull request.

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

Parâmetros Obrigatórios

--id

Identificador do pedido de pull.

--vote

Novo valor de voto para o pull request.

Propriedade Valor
Valores aceites: 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 tornar-se necessários para que o comando seja executado com êxito.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az repos pr show

Obtenha os detalhes de um pull request.

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

Parâmetros Obrigatórios

--id

Identificador do pedido de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--open

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

Propriedade Valor
Default value: 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. Necessário se não configurado como padrão ou captado via git config. Exemplo: https://dev.azure.com/MyOrganizationName/.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False

az repos pr update

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

Parâmetros Obrigatórios

--id

Identificador do pedido de pull.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--auto-complete

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

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

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

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

Razão para ignorar as políticas necessárias.

--delete-source-branch

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

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

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

--detect

Detete automaticamente a organização.

Propriedade Valor
Valores aceites: false, true
--draft

Publique o PR ou converta para o modo de rascunho.

Propriedade Valor
Valores aceites: 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. Necessário se não configurado como padrão ou captado via 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.

Propriedade Valor
Valores aceites: false, true
--status

Defina o novo estado da solicitação pull.

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

Novo título para o pull request.

--transition-work-items

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

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Default value: False