Compartir a través de

az repos pr

Note

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

 Extension GA
az repos pr create

Cree una solicitud de incorporación de cambios.

 Extension GA
az repos pr list

Enumerar solicitudes de incorporación de cambios.

 Extension GA
az repos pr policy

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

 Extension GA
az repos pr policy list

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

 Extension GA
az repos pr policy queue

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

 Extension GA
az repos pr reviewer

Administrar revisores de solicitudes de incorporación de cambios.

 Extension GA
az repos pr reviewer add

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

 Extension GA
az repos pr reviewer list

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

 Extension GA
az repos pr reviewer remove

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

 Extension GA
az repos pr set-vote

Vote por una solicitud de incorporación de cambios.

 Extension GA
az repos pr show

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

 Extension GA
az repos pr update

Actualice una solicitud de incorporación de cambios.

 Extension GA
az repos pr work-item

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

 Extension GA
az repos pr work-item add

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

 Extension GA
az repos pr work-item list

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

 Extension GA
az repos pr work-item remove

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

 Extension 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

Identificador de la solicitud de incorporación de cambios.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--remote-name

Nombre de git remoto con el que se genera la solicitud de incorporación de cambios.

Propiedad Valor
Valor predeterminado: origin
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Valor predeterminado: False
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.

Propiedad Valor
Valor predeterminado: False
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.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--draft

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

Propiedad Valor
Valores aceptados: false, true
--labels

Etiquetas asociadas a la solicitud de incorporación de cambios. Espacio separado.

--merge-commit-message

Mensaje que se muestra cuando se combinan confirmaciones.

--open

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

Propiedad Valor
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. Espacio separado.

--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

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

--repository -r

Nombre o identificador del repositorio para crear la solicitud de incorporación de cambios.

--required-reviewers

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

--source-branch -s

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

--squash

Squash las confirmaciones en la rama de origen al combinar en la rama de destino.

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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 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).

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--work-items

Identificadores de los elementos de trabajo para vincular a la nueva solicitud de incorporación de cambios. Espacio separado.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az repos pr list

Enumerar solicitudes de incorporación de cambios.

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 opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--creator

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

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--include-links

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

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

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

--repository -r

Nombre o identificador del repositorio.

--reviewer

Limite 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

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

--status

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

Propiedad Valor
Valores aceptados: abandoned, active, all, completed
--target-branch -t

Limite 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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --organization]

Parámetros requeridos

--id

Identificador de la solicitud de incorporación de cambios.

--vote

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

Propiedad Valor
Valores aceptados: approve, approve-with-suggestions, reject, reset, wait-for-author

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --organization]

Parámetros requeridos

--id

Identificador de la solicitud de incorporación de cambios.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--open

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

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Parámetros requeridos

--id

Identificador de la solicitud de incorporación de cambios.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

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

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

Propiedad Valor
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

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--draft

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

Propiedad Valor
Valores aceptados: false, true
--merge-commit-message

Mensaje que se muestra cuando se combinan confirmaciones.

--org --organization

Dirección 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 a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--squash

Squash las confirmaciones en la rama de origen al combinar en la rama de destino.

Propiedad Valor
Valores aceptados: false, true
--status

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

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

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False