az repos pr

Note

Эта ссылка является частью расширения azure-devops для Azure CLI (версия 2.30.0 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az repos pr. Подробнее о расширениях.

Управление запросами на вытягивание.

Команды

Имя	Описание	Тип	Состояние
az repos pr checkout	Если локальные изменения отсутствуют, проверьте ветвь источника PR локально.	Extension	GA
az repos pr create	Создайте pull request.	Extension	GA
az repos pr list	Вывод списка запросов на вытягивание.	Extension	GA
az repos pr policy	Управление политикой запроса на вытягивание.	Extension	GA
az repos pr policy list	Список политик запроса на вытягивание.	Extension	GA
az repos pr policy queue	Очередь оценки политики для запроса на вытягивание.	Extension	GA
az repos pr reviewer	Управление рецензентами запросов на вытягивание.	Extension	GA
az repos pr reviewer add	Добавьте одного или нескольких рецензентов в запрос на вытягивание.	Extension	GA
az repos pr reviewer list	Вывод списка рецензентов запроса на вытягивание.	Extension	GA
az repos pr reviewer remove	Удалите одного или нескольких рецензентов из запроса на вытягивание.	Extension	GA
az repos pr set-vote	Проголосуйте по запросу на вытягивание.	Extension	GA
az repos pr show	Получение сведений о запросе на вытягивание.	Extension	GA
az repos pr update	Обновление запроса на вытягивание.	Extension	GA
az repos pr work-item	Управление рабочими элементами, связанными с запросами на вытягивание.	Extension	GA
az repos pr work-item add	Связывание одного или нескольких рабочих элементов с запросом на вытягивание.	Extension	GA
az repos pr work-item list	Вывод списка связанных рабочих элементов для запроса на вытягивание.	Extension	GA
az repos pr work-item remove	Отмена связи одного или нескольких рабочих элементов из запроса на вытягивание.	Extension	GA

az repos pr checkout

Если локальные изменения отсутствуют, проверьте ветвь источника PR локально.

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

Обязательные параметры

--id

Идентификатор запроса на вытягивание.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--remote-name

Имя удаленного git, в отношении которого вызывается PR.

Свойство	Значение
Default value:	origin

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az repos pr create

Создайте pull request.

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]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--auto-complete

Настройте запрос на вытягивание автоматически, когда все политики прошли и исходная ветвь может быть объединена в целевую ветвь.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--bypass-policy

Обходить необходимые политики (если таковые есть) и завершают запрос на вытягивание после его объединения.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--bypass-policy-reason

Причина обхода необходимых политик.

--delete-source-branch

Удалите исходную ветвь после завершения запроса на вытягивание и объедините ее в целевую ветвь.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--description -d

Описание нового запроса на вытягивание. Может включать markdown. Каждое значение, отправленное этому arg, будет новой строкой. Например: --description "First Line" "Second Line".

--detect

Автоматическое определение организации.

Свойство	Значение
Допустимые значения:	false, true

--draft

Этот флаг используется для создания запроса на вытягивание в черновике или работе в режиме выполнения.

Свойство	Значение
Допустимые значения:	false, true

--labels

Метки, связанные с запросом на вытягивание. Пространство разделено.

--merge-commit-message

Сообщение, отображаемое при слиянии фиксаций.

--open

Откройте запрос на вытягивание в веб-браузере.

Свойство	Значение
Default value:	False

--optional-reviewers --reviewers

Дополнительные пользователи или группы для включения в качестве необязательных рецензентов в новом запросе на вытягивание. Пространство разделено.

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--repository -r

Имя или идентификатор репозитория для создания запроса на вытягивание.

--required-reviewers

Дополнительные пользователи или группы для включения в качестве необходимых рецензентов в новом запросе на вытягивание. Пространство разделено.

--source-branch -s

Имя исходной ветви. Пример: "dev".

--squash

Сквашируйте фиксации в исходной ветви при слиянии с целевой ветвью.

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--target-branch -t

Имя целевой ветви. Если не указано, по умолчанию используется ветвь целевого репозитория по умолчанию.

--title

Заголовок нового запроса на вытягивание.

--transition-work-items

Перенесите все рабочие элементы, связанные с запросом на вытягивание, в следующее логическое состояние. (например, активный —> Разрешено).

Свойство	Значение
Default value:	False
Допустимые значения:	false, true

--work-items

Идентификаторы рабочих элементов для ссылки на новый запрос на вытягивание. Пространство разделено.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az repos pr list

Вывод списка запросов на вытягивание.

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]

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--creator

Ограничить результаты запросами на вытягивание, созданные этим пользователем.

--detect

Автоматическое определение организации.

Свойство	Значение
Допустимые значения:	false, true

--include-links

Включите _links для каждого запроса на вытягивание.

Свойство	Значение
Default value:	False

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--repository -r

Имя или идентификатор репозитория.

--reviewer

Ограничить результаты запросами на вытягивание, в которых этот пользователь является рецензентом.

--skip

Количество пропустить запросы на вытягивание.

--source-branch -s

Ограничить результаты для запросов на вытягивание, поступающие из этой исходной ветви.

--status

Ограничить результаты для запросов на вытягивание с таким состоянием.

Свойство	Значение
Допустимые значения:	abandoned, active, all, completed

--target-branch -t

Ограничить результаты для запросов на вытягивание, предназначенные для этой ветви.

--top

Максимальное количество запросов на вытягивание списка.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az repos pr set-vote

Проголосуйте по запросу на вытягивание.

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

Обязательные параметры

--id

Идентификатор запроса на вытягивание.

--vote

Новое значение голосования для запроса на вытягивание.

Свойство	Значение
Допустимые значения:	approve, approve-with-suggestions, reject, reset, wait-for-author

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--detect

Автоматическое определение организации.

Свойство	Значение
Допустимые значения:	false, true

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az repos pr show

Получение сведений о запросе на вытягивание.

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

Обязательные параметры

--id

Идентификатор запроса на вытягивание.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--detect

Автоматическое определение организации.

Свойство	Значение
Допустимые значения:	false, true

--open

Откройте запрос на вытягивание в веб-браузере.

Свойство	Значение
Default value:	False

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False

az repos pr update

Обновление запроса на вытягивание.

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

Обязательные параметры

--id

Идентификатор запроса на вытягивание.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--auto-complete

Настройте запрос на вытягивание автоматически, когда все политики прошли и исходная ветвь может быть объединена в целевую ветвь.

Свойство	Значение
Допустимые значения:	false, true

--bypass-policy

Обходить необходимые политики (если таковые есть) и завершают запрос на вытягивание после его объединения.

Свойство	Значение
Допустимые значения:	false, true

--bypass-policy-reason

Причина обхода необходимых политик.

--delete-source-branch

Удалите исходную ветвь после завершения запроса на вытягивание и объедините ее в целевую ветвь.

Свойство	Значение
Допустимые значения:	false, true

--description -d

Новое описание запроса на вытягивание. Может включать markdown. Каждое значение, отправленное этому arg, будет новой строкой. Например: --description "First Line" "Second Line".

--detect

Автоматическое определение организации.

Свойство	Значение
Допустимые значения:	false, true

--draft

Опубликуйте PR или преобразуйте его в режим черновика.

Свойство	Значение
Допустимые значения:	false, true

--merge-commit-message

Сообщение, отображаемое при слиянии фиксаций.

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--squash

Сквашируйте фиксации в исходной ветви при слиянии с целевой ветвью.

Свойство	Значение
Допустимые значения:	false, true

--status

Задайте новое состояние запроса на вытягивание.

Свойство	Значение
Допустимые значения:	abandoned, active, completed

--title

Новое название запроса на вытягивание.

--transition-work-items

Перенесите все рабочие элементы, связанные с запросом на вытягивание, в следующее логическое состояние. (например, активный —> Разрешено).

Свойство	Значение
Допустимые значения:	false, true

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство	Значение
Default value:	False