az repos pr

  • Referencia

Nota:

Esta referencia forma parte de la extensión azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az repos pr . Obtenga más información sobre las extensiones.

Administrar solicitudes de incorporación de cambios.

Comandos

Nombre Description Tipo Estado
az repos pr checkout

Desproteger la rama de origen de pr localmente, si no hay cambios locales.

 Extensión GA
az repos pr create

Cree una solicitud de incorporación de cambios.

 Extensión GA
az repos pr list

Enumerar solicitudes de incorporación de cambios.

 Extensión GA
az repos pr policy

Administrar la directiva de solicitud de incorporación de cambios.

 Extensión GA
az repos pr policy list

Enumera las directivas de una solicitud de incorporación de cambios.

 Extensión GA
az repos pr policy queue

Poner en cola una evaluación de una directiva para una solicitud de incorporación de cambios.

 Extensión GA
az repos pr reviewer

Administrar revisores de incorporación de cambios.

 Extensión GA
az repos pr reviewer add

Agregue uno o varios revisores a una solicitud de incorporación de cambios.

 Extensión GA
az repos pr reviewer list

Enumera los revisores de una solicitud de incorporación de cambios.

 Extensión GA
az repos pr reviewer remove

Quite uno o varios revisores de una solicitud de incorporación de cambios.

 Extensión GA
az repos pr set-vote

Vote por una solicitud de incorporación de cambios.

 Extensión GA
az repos pr show

Obtenga los detalles de una solicitud de incorporación de cambios.

 Extensión GA
az repos pr update

Actualice una solicitud de incorporación de cambios.

 Extensión GA
az repos pr work-item

Administrar elementos de trabajo asociados a solicitudes de incorporación de cambios.

 Extensión GA
az repos pr work-item add

Vincule uno o varios elementos de trabajo a una solicitud de incorporación de cambios.

 Extensión GA
az repos pr work-item list

Enumerar elementos de trabajo vinculados para una solicitud de incorporación de cambios.

 Extensión GA
az repos pr work-item remove

Desvincular uno o varios elementos de trabajo de una solicitud de incorporación de cambios.

 Extensión GA

az repos pr checkout

Desproteger la rama de origen de pr localmente, si no hay cambios locales.

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

Parámetros requeridos

--id

Id. de la PR.

Parámetros opcionales

--remote-name

Nombre del repositorio remoto Git sobre el que se genera la solicitud de incorporación de cambios.

valor predeterminado: origin
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az repos pr create

Cree una solicitud de incorporación de cambios.

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 opcionales

--auto-complete

Establezca la solicitud de incorporación de cambios para que se complete automáticamente cuando se hayan pasado todas las directivas y la rama de origen se pueda combinar en la rama de destino.

valores aceptados: false, true
valor predeterminado: False
--bypass-policy

Omita las directivas necesarias (si las hay) y complete la solicitud de incorporación de cambios una vez que se pueda combinar.

valores aceptados: false, true
valor predeterminado: False
--bypass-policy-reason

Motivo para omitir las directivas necesarias.

--delete-source-branch

Elimine la rama de origen una vez completada y combinada la solicitud de incorporación de cambios en la rama de destino.

valores aceptados: false, true
valor predeterminado: False
--description -d

Descripción de la nueva solicitud de incorporación de cambios. Puede incluir Markdown. Cada valor enviado a este argumento será una nueva línea. Por ejemplo: --description "Primera línea" "Segunda línea".

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--draft

Use esta marca para crear la solicitud de incorporación de cambios en modo borrador/trabajo en curso.

valores aceptados: false, true
--labels

Etiquetas asociadas a la solicitud de incorporación de cambios. Separados por espacios.

--merge-commit-message

Mensaje que se muestra cuando se combinan confirmaciones.

--open

Abra la solicitud de incorporación de cambios en el explorador web.

valor predeterminado: False
--optional-reviewers --reviewers

Usuarios o grupos adicionales que se van a incluir como revisores opcionales en la nueva solicitud de incorporación de cambios. Separados por espacios.

--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Es obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git.

--repository -r

Nombre o id. del repositorio en el que se va a crear la PR.

--required-reviewers

Usuarios o grupos adicionales que se incluirán como revisores necesarios en la nueva solicitud de incorporación de cambios. Separados por espacios.

--source-branch -s

Nombre de la rama de origen. Ejemplo: "dev".

--squash

Fusiona mediante combinación con "squash" las confirmaciones de la rama de origen en la rama de destino.

valores aceptados: false, true
valor predeterminado: False
--target-branch -t

Nombre de la rama de destino. Si no se especifica, el valor predeterminado es la rama predeterminada del repositorio de destino.

--title

Título de la nueva PR.

--transition-work-items

Realice la transición de los elementos de trabajo vinculados a la solicitud de incorporación de cambios al siguiente estado lógico. (por ejemplo, Activo-> Resuelto).

valores aceptados: false, true
valor predeterminado: False
--work-items

Identificadores de los elementos de trabajo para vincular a la nueva solicitud de incorporación de cambios. Separados por espacios.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az repos pr list

Enumerar solicitudes de incorporación de cambios.

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 opcionales

--creator

Limitar los resultados a las solicitudes de incorporación de cambios creadas por este usuario.

--detect

Detectar automáticamente la organización.

valores aceptados: false, true
--include-links

Incluir _links para cada solicitud de incorporación de cambios.

valor predeterminado: False
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o se recoge a través de la configuración de Git.

--repository -r

Nombre o id. del repositorio.

--reviewer

Limitar los resultados a las solicitudes de incorporación de cambios en las que este usuario es un revisor.

--skip

Número de solicitudes de incorporación de cambios que se van a omitir.

--source-branch -s

Limitar los resultados a las solicitudes de incorporación de cambios que se originan en esta rama de origen.

--status

Limitar los resultados a las solicitudes de incorporación de cambios con este estado.

valores aceptados: abandoned, active, all, completed
--target-branch -t

Limitar los resultados a las solicitudes de incorporación de cambios destinadas a esta rama.

--top

Número máximo de solicitudes de incorporación de cambios que se van a enumerar.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az repos pr set-vote

Vote por una solicitud de incorporación de cambios.

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

Parámetros requeridos

--id

Id. de la PR.

--vote

Nuevo valor de voto para la solicitud de incorporación de cambios.

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

Parámetros opcionales

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az repos pr show

Obtenga los detalles de una solicitud de incorporación de cambios.

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

Parámetros requeridos

--id

Id. de la PR.

Parámetros opcionales

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--open

Abra la solicitud de incorporación de cambios en el explorador web.

valor predeterminado: False
--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az repos pr update

Actualice una solicitud de incorporación de cambios.

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 requeridos

--id

Id. de la PR.

Parámetros opcionales

--auto-complete

Establezca la solicitud de incorporación de cambios para que se complete automáticamente cuando se hayan pasado todas las directivas y la rama de origen se pueda combinar en la rama de destino.

valores aceptados: false, true
--bypass-policy

Omita las directivas necesarias (si las hay) y complete la solicitud de incorporación de cambios una vez que se pueda combinar.

valores aceptados: false, true
--bypass-policy-reason

Motivo para omitir las directivas necesarias.

--delete-source-branch

Elimine la rama de origen una vez completada y combinada la solicitud de incorporación de cambios en la rama de destino.

valores aceptados: false, true
--description -d

Nueva descripción de la solicitud de incorporación de cambios. Puede incluir Markdown. Cada valor enviado a este argumento será una nueva línea. Por ejemplo: --description "Primera línea" "Segunda línea".

--detect

Detecta automáticamente la organización.

valores aceptados: false, true
--draft

Publique la solicitud de incorporación de cambios o convierta en modo borrador.

valores aceptados: false, true
--merge-commit-message

Mensaje que se muestra cuando se combinan confirmaciones.

--org --organization

URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Es obligatorio si no está configurada como predeterminada o seleccionada mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--squash

Fusiona mediante combinación con "squash" las confirmaciones de la rama de origen en la rama de destino.

valores aceptados: false, true
--status

Establece el nuevo estado de la solicitud de incorporación de cambios.

valores aceptados: abandoned, active, completed
--title

Nuevo título para la solicitud de incorporación de cambios.

--transition-work-items

Realice la transición de los elementos de trabajo vinculados a la solicitud de incorporación de cambios al siguiente estado lógico. (por ejemplo, Activo-> Resuelto).

valores aceptados: false, true
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.