az repos pr

  • Referência

Nota

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 Estado
az repos pr checkout

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

 Extensão GA
az repos pr create

Crie uma solicitação pull.

 Extensão GA
az repos pr list

Listar solicitações pull.

 Extensão GA
az repos pr policy

Gerencie a política de pull request.

 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

Gerencie revisores de solicitação 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 pull request.

 Extensão GA
az repos pr show

Obtenha os detalhes de um pull request.

 Extensão GA
az repos pr update

Atualize uma solicitação pull.

 Extensão GA
az repos pr work-item

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

 Extensão GA
az repos pr work-item add

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

ID do pull request.

Parâmetros Opcionais

--remote-name

Nome do git remoto contra o qual o PR é levantado.

valor predefinido: origin
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

valores aceites: false, true
valor predefinido: False
--bypass-policy

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

valores aceites: false, true
valor predefinido: False
--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.

valores aceites: false, true
valor predefinido: False
--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.

valores aceites: false, true
--draft

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

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.

valor predefinido: 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.

valores aceites: false, true
valor predefinido: False
--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).

valores aceites: false, true
valor predefinido: False
--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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 para receber solicitações criadas por esse usuário.

--detect

Detete automaticamente a organização.

valores aceites: false, true
--include-links

Inclua _links para cada solicitação pull.

valor predefinido: 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 para receber solicitações em que esse usuário é um 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.

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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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]

Parâmetros Obrigatórios

--id

ID do pull request.

--vote

Novo valor de voto para o pull request.

valores aceites: approve, approve-with-suggestions, reject, reset, wait-for-author

Parâmetros Opcionais

--detect

Detete automaticamente a organização.

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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az repos pr show

Obtenha os detalhes de um pull request.

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

Parâmetros Obrigatórios

--id

ID do pull request.

Parâmetros Opcionais

--detect

Detete automaticamente a organização.

valores aceites: false, true
--open

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

valor predefinido: 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Parâmetros Obrigatórios

--id

ID do pull request.

Parâmetros Opcionais

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

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.

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.

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.

valores aceites: false, true
--draft

Publique o PR ou converta para o modo de rascunho.

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.

valores aceites: false, true
--status

Defina o novo estado da solicitação pull.

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).

valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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