Поделиться через

Azure DevOps

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

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Метаданные соединителя
Publisher Microsoft

Чтобы использовать эту интеграцию, вам потребуется доступ к учетной записи Azure DevOps с включенным доступом к API. Чтобы сделать подключение, нажмите кнопку "Войти". Затем вам будет предложено предоставить учетную запись Azure DevOps Services. Следуйте остальным экранам, чтобы создать подключение.

При использовании подключения, если вы не видите список проектов, которые вы ожидаете, проверьте учетную запись, с помощью которую вы создали подключение и повторите попытку. Дополнительные сведения см. в Visual Studio Marketplace.

Теперь вы готовы начать использовать эту интеграцию.

Отправка вложений

Вы можете создать вложения файлов с помощью действия "Отправить HTTP-запрос в Azure DevOps ", а затем выполнить следующие действия:

  1. Преобразуйте содержимое файла в строку Base64 и поместите его в параметр Body.
  2. Задайте для параметра Body is Base64 значение "Да".

Создание планов тестирования

Перед созданием тестового плана с помощью действия создания рабочего элемента необходимо сначала создать набор test Suite. Вы можете использовать то же действие "Создать рабочий элемент" для создания наборов тестов, а затем создать план тестирования со ссылкой на набор Test Suite.

Самый простой вариант — вызвать планы тестирования— создать API непосредственно с помощью отправки HTTP-запроса в действие Azure DevOps . API автоматически создает связанный набор тестов.

Параметр "Другие поля"

Создайте рабочий элемент и обновите действия рабочего элемента с поддержкой Other Fields параметра. Эти поля обеспечивают дополнительную гибкость при обновлении рабочих элементов. Пары "ключ-значение" преобразуются в следующий код JSON:

{
  "op": "add",
  "path": "/fields/<key>",
  "value": <value>
}

Обратите внимание, что это константа иop, как ожидается, <key> будет допустимым именем поля в перечислении DevOps/fields.

Ниже приведены несколько примеров использования. Дополнительные примеры см. в разделе "Рабочие элементы" — обновление REST API.

  1. Обновление key журнала = System.History value = Переход на правильный путь к области'
  2. Перемещение рабочих элементов: key = System.TeamProject value = Fabrikam-Scrum

Известные проблемы и ограничения

В следующем списке приведены известные ограничения использования соединителя Azure DevOps.

  1. Триггер при обновлении рабочего элемента будет пропущен при добавлении или удалении новых ссылок на рабочий элемент.

  2. Действие Get work item details and work item based triggers can miss some fields (например System.AttachedFileCount) в ответе, так как это ограничение REST API Azure DevOps. Чтобы устранить эту проблему, можно выполнить одно из следующих действий:

  3. Действие "Отправить HTTP-запрос в Azure DevOps " имеет ограниченный набор областей, которые управляют доступом к ресурсам, к которым можно получить доступ с помощью действия, и какие операции, которые разрешено выполнять с этими ресурсами.

    Области:

    • vso.agentpools_manage
    • vso.build_execute
    • vso.chat_manage
    • vso.code_manage
    • vso.code_status
    • vso.connected_server
    • vso.доски_управление
    • vso.entitlements
    • vso.extension.data_write
    • управление_расширением_vso
    • vso.identity
    • vso.loadtest_write
    • vso.packaging_manage
    • vso.управление_проектами
    • vso.управление_выпуском
    • vso.тестовая_запись
    • vso.work_write

  4. Соединитель Azure DevOps предназначен для работы только от имени текущих учетных данных пользователя. Невозможно изменить подключение или переключиться между учетными записями.

  5. Обратите внимание, что изменения паролей в учетной записи Azure DevOps не повлияют на существующее подключение.

  6. Маркеры личного доступа Azure DevOps не поддерживаются для проверки подлинности с помощью соединителя.

  7. Действие "Создание рабочего элемента" имеет ограничение для параметра Repro Steps. Изображение размером более 30 КБ может отображаться неправильно в созданном элементе. Изображение размером более 500 КБ можно удалить из запроса. Рекомендуемый размер изображения должен быть меньше 30 КБ.

  8. Действие "Создание рабочего элемента " очень редко может возвращать код ответа 404. Чаще всего это происходит по следующей причине: сразу после создания элемента запрашиваются все его поля. Запрос можно отправить в скопированную базу данных. Изменения синхронизированы почти в режиме реального времени, но иногда это занимает несколько секунд. Из-за этого запрос GET может возвращать пустой результат, который представляет собой код состояния 404 в ответе. Чтобы избежать этого исключения, можно использовать флаг "Вернуть все поля" и задать для него значение "Нет".

  9. Если вы не получаете ожидаемую организацию при работе с несколькими каталогами, выберите организацию, которую вы ожидаете на странице профиля Azure DevOps и настроите новое подключение.

Замечание

В действии "Создание рабочего элемента"

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
Проверка подлинности сертификата клиента Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX Все регионы Доступный для общего пользования
Вход с помощью учетных данных Azure DevOps Вход с помощью учетных данных Azure DevOps Только Azure для государственных организаций и государственных организаций США (GCC) Недоступен для совместного использования
Вход с помощью идентификатора Microsoft Entra Вход с помощью идентификатора Microsoft Entra Только ДЛЯ РАБОЧЕЙ СРЕДЫ Недоступен для совместного использования
аутентификации субъекта-службы Использование приложения идентификатора Microsoft Entra для проверки подлинности субъекта-службы Все регионы Доступный для общего пользования
По умолчанию [не рекомендуется] Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. Все регионы Недоступен для совместного использования

Проверка подлинности сертификата клиента

Идентификатор проверки подлинности: CertOauth

Применимо: все регионы

Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя Тип Description Обязательно
Tenant струна True
Идентификатор клиента струна Идентификатор клиента для приложения Идентификатора Microsoft Entra True
Секрет сертификата клиента клиентский сертификат Секрет сертификата клиента, разрешенный этим приложением True

Вход с помощью учетных данных Azure DevOps

Идентификатор проверки подлинности: ADO3pAuthForGCC

Применимо: только Azure для государственных организаций и государственных организаций США (GCC)

Вход с помощью учетных данных Azure DevOps

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Вход с помощью идентификатора Microsoft Entra

Идентификатор проверки подлинности: EntraOAuth

Применимо: только для рабочей среды

Вход с помощью идентификатора Microsoft Entra

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Аутентификация служебного принципала

Идентификатор проверки подлинности: OauthSP

Применимо: все регионы

Использование приложения идентификатора Microsoft Entra для проверки подлинности субъекта-службы

Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт

Имя Тип Description Обязательно
Tenant струна True
Идентификатор клиента струна Идентификатор клиента для приложения Идентификатора Microsoft Entra True
Секрет клиента securestring True

По умолчанию [не рекомендуется]

Применимо: все регионы

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

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Ограничения на регулирование

Имя Звонки Период продления
Вызовы API для каждого подключения 300 60 секунд

Действия

Вывод списка запросов в папке

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

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

Возвращает первые 10000 запусков для определенного конвейера
Вывод списка типов рабочих элементов

Извлекает список типов рабочих элементов, доступных в заданном проекте Azure DevOps.
Обновить рабочий элемент

Обновите существующий рабочий элемент по идентификатору.
Отправка HTTP-запроса в Azure DevOps

Создайте запрос REST API Azure DevOps для вызова. См. следующую ссылку для всех доступных конечных точек: https://docs.microsoft.com/rest/api/azure/devops
Очередь новой сборки

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

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

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

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

Получает профиль пользователя.
Получение результатов запроса

Извлекает результат запроса рабочего элемента.
Получение результатов запроса [DEPRECATED]

Это действие устарело. Вместо этого используйте результаты запроса.

Извлекает результат запроса рабочего элемента.
Получение сведений о рабочем элементе

Получение сведений об одном рабочем элементе.
Создание нового выпуска

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

Создайте новый рабочий элемент с предоставленными атрибутами.
Список итераций

Извлекает список итерации для проекта.
Список конвейеров

Извлекает список конвейеров в проекте.
Список проектов

Извлекает список проектов в организации.
Список рабочих элементов

Возвращает список рабочих элементов.
Список репозиториев Git

Извлекает список репозиториев Git в проекте.

Вывод списка запросов в папке

ID операции:
ListQueriesInFolder

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Путь к папке
 folderPath True string

Путь к папке, в которой следует искать запросы.

Возвращает

Список моделей VSTS.

Тело
VstsList[QueryHierarchyItem]

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

ID операции:
ListRootQueryFolders

Извлекает список запросов рабочих элементов корневого уровня в проекте.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.

Возвращает

Список моделей VSTS.

Тело
VstsList[QueryHierarchyItem]

Вывод списка запусков конвейера

ID операции:
ListPipelineRuns

Возвращает первые 10000 запусков для определенного конвейера

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор конвейера
 pipelineId True integer

Идентификатор конвейера

Возвращает

Тело
Run

Вывод списка типов рабочих элементов

ID операции:
ListWorkItemTypes

Извлекает список типов рабочих элементов, доступных в заданном проекте Azure DevOps.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.

Возвращает

Список моделей VSTS.

Тело
VstsList[WorkItemType]

Обновить рабочий элемент

ID операции:
UpdateWorkItem

Обновите существующий рабочий элемент по идентификатору.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Идентификатор рабочего элемента
 id True string

Уникальный идентификатор рабочего элемента для обновления.
Имя проекта
 project string

Имя проекта в указанной организации.
Тип рабочего элемента
 type string

Тип рабочего элемента для создания схемы.
Сведения о рабочем элементе
 workItem True dynamic

Сведения о рабочем элементе.

Возвращает

Выходные данные этой операции являются динамическими.

Отправка HTTP-запроса в Azure DevOps

ID операции:
HttpRequest

Создайте запрос REST API Azure DevOps для вызова. См. следующую ссылку для всех доступных конечных точек: https://docs.microsoft.com/rest/api/azure/devops

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Метод
 Method True string

Метод HTTP.
Относительный универсальный код ресурса (URI)
 Uri True string

Относительный универсальный код ресурса (URI). Пример: {project}/{team}/_apis/wit/templates?api-version=5.0-preview.1.
Headers
 Headers object

Заголовки запроса.
Тело
 Body string

Содержимое запроса. Может быть объектом JSON или двоичными данными, закодированными как строка Base64.
Основной текст — Base64
 IsBase64 boolean

Значение true, если содержимое запроса закодировано как строка Base64.

Возвращает

response
ObjectWithoutType

Очередь новой сборки

ID операции:
QueueNewBuild

Создайте сборку на основе существующего определения сборки и добавьте ее в очередь сборки.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор определения сборки
 buildDefId True string

Идентификатор используемого определения сборки.
Исходная ветвь
 sourceBranch string

Исходная ветвь сборки.
Параметры
 parameters string

Словарь JSON необязательных параметров сборки.

Возвращает

Результат сборки

Тело
BuildResult

Перечисление определений выпуска

ID операции:
ListReleaseDefinitions

Извлекает список определений выпуска, связанных с проектом.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.

Возвращает

Список моделей VSTS.

Тело
VstsList[ReleaseDefinition]

Перечисление организаций

ID операции:
ListAccounts

Извлекает список организаций, в которые пользователь входит.

Возвращает

Список моделей VSTS.

Тело
VstsList[Account]

Получение дочерних элементов рабочих элементов

ID операции:
GetWorkItemChildren

Получение списка дочерних элементов (максимальный размер 1000) одного рабочего элемента.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор рабочего элемента
 id True string

Уникальный идентификатор рабочего элемента, для получения дочерних элементов.
Тип дочерних рабочих элементов
 workItemType string

Тип дочерних рабочих элементов

Возвращает

Выходные данные этой операции являются динамическими.

Получение профиля пользователя

ID операции:
GetProfile

Получает профиль пользователя.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор профиля
 id True string

Идентификатор профиля в той же организации или "я", чтобы получить профиль текущего пользователя, прошедшего проверку подлинности.

Возвращает

Profile

Тело
Profile

Получение результатов запроса

ID операции:
GetQueryResultsV2

Извлекает результат запроса рабочего элемента.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор запроса
 queryId True string

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

Максимальное количество рабочих элементов для получения (1 – 20000)
Сбой при изменении результатов запроса
 throwIfQueryChanged boolean

Если результаты запроса изменяются во время выполнения потока, выполнение потока не должно избежать несоответствий.

Возвращает

Выходные данные этой операции являются динамическими.

Получение результатов запроса [DEPRECATED]

ID операции:
GetQueryResults

Это действие устарело. Вместо этого используйте результаты запроса.

Извлекает результат запроса рабочего элемента.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор запроса
 queryId True string

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

Возвращает

Список моделей VSTS.

Тело
VstsList[JObject]

Получение сведений о рабочем элементе

ID операции:
GetWorkItemDetails

Получение сведений об одном рабочем элементе.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Тип рабочего элемента
 typeName True string

Тип рабочего элемента рабочего элемента.
Идентификатор рабочего элемента
 id True string

Уникальный идентификатор рабочего элемента для получения сведений. Рабочий элемент должен иметь тип, указанный в поле "Тип рабочего элемента".

Возвращает

Выходные данные этой операции являются динамическими.

Создание нового выпуска

ID операции:
CreateRelease

Создайте выпуск на основе существующего определения выпуска.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификатор определения выпуска
 releaseDefId True string

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

Описание метаданных запуска выпуска.
Является черновиком
 IsDraft boolean

Указывает, является ли выпуск черновиком.
Причина
 Reason string

Причина запуска выпуска метаданных.
Имя
 Name True string

Имя переменной конфигурации.
Ценность
 Value string

Значение переменной конфигурации.

Возвращает

Релиз

Тело
Release

Создание рабочего элемента

ID операции:
CreateWorkItem

Создайте новый рабочий элемент с предоставленными атрибутами.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Тип рабочего элемента
 type True string

Тип этого рабочего элемента
Возврат всех полей
 shouldReturnAllFields boolean

При задании значения "Нет" возвращается только идентификатор рабочего элемента. Если значение равно "Да", будут возвращены все поля созданного элемента вместе с идентификатором. Значение по умолчанию — "Да"
Сведения о рабочем элементе
 workItem True dynamic

Сведения для включения в новый рабочий элемент

Возвращает

Выходные данные этой операции являются динамическими.

Список итераций

ID операции:
ListIterations

Извлекает список итерации для проекта.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя группы
 team True string

Имя команды в проекте.

Возвращает

Список моделей VSTS.

Тело
VstsList[TeamSettingsIteration]

Список конвейеров

ID операции:
ListPipelines

Извлекает список конвейеров в проекте.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.

Возвращает

Тело
Pipeline

Список проектов

ID операции:
ListProjects

Извлекает список проектов в организации.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.

Возвращает

Список моделей VSTS.

Тело
VstsList[Project]

Список рабочих элементов

ID операции:
ListWorkItems

Возвращает список рабочих элементов.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Идентификаторы рабочих элементов
 workItemIds True string

Разделенный запятыми список запрошенных идентификаторов рабочих элементов.
Тип рабочего элемента
 workItemType string

Тип рабочего элемента для создания схемы.

Возвращает

Выходные данные этой операции являются динамическими.

Список репозиториев Git

ID операции:
ListGitRepositories

Извлекает список репозиториев Git в проекте.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.

Возвращает

Список моделей VSTS.

Тело
VstsList[GitRepository]

Триггеры

После завершения сборки

Активирует поток после завершения сборки.
При закрытии запроса на вытягивание (Git)

Активирует поток при закрытии запроса на вытягивание, соответствующего предоставленным критериям.
При закрытии рабочего элемента

Активирует поток при закрытии рабочего элемента, соответствующего предоставленным критериям.
При закрытии рабочего элемента [DEPRECATED]

Это действие устарело. Используйте вместо этого рабочий элемент, если рабочий элемент закрыт .

Активирует поток при закрытии рабочего элемента, соответствующего предоставленным критериям.
При назначении рабочего элемента

Активирует поток, когда рабочий элемент, соответствующий заданным критериям, назначается указанному пользователю.
При назначении рабочего элемента [DEPRECATED]

Это действие устарело. Используйте вместо этого рабочий элемент .

Активирует поток, когда рабочий элемент, соответствующий заданным критериям, назначается указанному пользователю.
При обновлении рабочего элемента

Активирует поток при обновлении рабочего элемента, соответствующего заданным критериям.
При обновлении рабочего элемента [DEPRECATED]

Это действие устарело. Используйте вместо этого , когда рабочий элемент обновляется .

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

Активирует поток при отправке кода в репозиторий Git.
При проверке кода (TFVC)

Активирует поток при входе кода в проект Управления версиями Team Foundation.
При создании запроса на вытягивание (Git)

Активирует поток при создании запроса на вытягивание, соответствующего заданным критериям.
При создании рабочего элемента

Активирует поток при создании рабочего элемента, соответствующего заданным критериям.
При создании рабочего элемента [DEPRECATED]

Это действие устарело. Используйте вместо этого рабочий элемент .

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

После завершения сборки

ID операции:
OnBuildCompleted

Активирует поток после завершения сборки.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Фильтрация по результату
 resultFilter string

Параметр, указывающий, какой результат сборки следует активировать. Допустимые параметры включают '', 'успешно', 'частично'succeeded', 'failed' или 'canceled'.
Фильтр по идентификатору определения
 definitions string

Параметр, указывающий идентификатор определения сборки для активации.

Возвращает

Список моделей VSTS.

Тело
VstsList[BuildResult]

При закрытии запроса на вытягивание (Git)

ID операции:
OnGitPullClosed

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя репозитория
 repository True string

Имя репозитория в указанном проекте.
Имя источника ссылок
 sourceRefName string

Имя ссылки на Git, например ветвь или тег.
Имя целевого ссылок
 targetRefName string

Имя ссылки на Git, например ветвь или тег.

Возвращает

Список моделей VSTS.

Тело
VstsList[GitPullRequest]

При закрытии рабочего элемента

ID операции:
OnWorkItemClosedV2

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Закрытое состояние
 closedState string

Разделенный запятыми список значений поля State, указывающий, как рабочий элемент был закрыт (готово, закрыто, завершено, неактивно).
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При закрытии рабочего элемента [DEPRECATED]

ID операции:
OnWorkItemClosed

Это действие устарело. Используйте вместо этого рабочий элемент, если рабочий элемент закрыт .

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Командный проект
 wiql__System_TeamProject string

Командный проект, к которому принадлежит этот рабочий элемент.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При назначении рабочего элемента

ID операции:
OnWorkItemAssignedV2

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team True string

Имя команды, из которой нужно выбрать участника.
Assigned To
 wiql__System_AssignedTo True string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При назначении рабочего элемента [DEPRECATED]

ID операции:
OnWorkItemAssigned

Это действие устарело. Используйте вместо этого рабочий элемент .

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Assigned To
 wiql__System_AssignedTo True string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать участника.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Командный проект
 wiql__System_TeamProject string

Командный проект, к которому принадлежит этот рабочий элемент.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При обновлении рабочего элемента

ID операции:
OnWorkItemUpdatedV2

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При обновлении рабочего элемента [DEPRECATED]

ID операции:
OnWorkItemUpdated

Это действие устарело. Используйте вместо этого , когда рабочий элемент обновляется .

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Командный проект
 wiql__System_TeamProject string

Командный проект, к которому принадлежит этот рабочий элемент.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При отправке кода (Git)

ID операции:
OnGitPush

Активирует поток при отправке кода в репозиторий Git.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя репозитория
 repository True string

Имя репозитория в указанном проекте.
Имя ссылки
 refName string

Имя ссылки на Git, например ветвь или тег.

Возвращает

Список моделей VSTS.

Тело
VstsList[GitPush]

При проверке кода (TFVC)

ID операции:
OnTfvcCheckIn

Активирует поток при входе кода в проект Управления версиями Team Foundation.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя группы
 team string

Имя команды, которую нужно выбрать автора.
Член группы
 author string

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

Возвращает

Список моделей VSTS.

Тело
VstsList[TfvcChangeset]

При создании запроса на вытягивание (Git)

ID операции:
OnGitPullCreated

Активирует поток при создании запроса на вытягивание, соответствующего заданным критериям.

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя репозитория
 repository True string

Имя репозитория в указанном проекте.
Имя источника ссылок
 sourceRefName string

Имя ссылки на Git, например ветвь или тег.
Имя целевого ссылок
 targetRefName string

Имя ссылки на Git, например ветвь или тег.

Возвращает

Список моделей VSTS.

Тело
VstsList[GitPullRequest]

При создании рабочего элемента

ID операции:
OnWorkItemCreatedV2

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

При создании рабочего элемента [DEPRECATED]

ID операции:
OnWorkItemCreated

Это действие устарело. Используйте вместо этого рабочий элемент .

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

Параметры

Имя Ключ Обязательно Тип Описание
Название организации
 account True string

Имя организации. Это можно найти в URL-адресе экземпляра, например {Organization}.visualstudio.com. Организация должна иметь доступ к сторонним приложениям через OAuth, чтобы предотвратить ошибки в операции.
Имя проекта
 project True string

Имя проекта в указанной организации.
Имя команды (для выбора назначенного)
 team string

Имя команды, из которой нужно выбрать назначаемого.
Assigned To
 wiql__System_AssignedTo string

Имя члена группы, которому в настоящее время принадлежит рабочий элемент.
Тип
 wiql__System_WorkItemType string

Имя типа рабочего элемента.
Областной путь
 wiql__System_AreaPath string

Компонент продукта или область группы, в которая находится рабочий элемент.
Сравнение пути к области
 areaPathComparison string

Правило, используемое при сравнении поля "Путь к области".
Путь итерации
 wiql__System_IterationPath string

Именованный спринт или период времени, в который находится рабочий элемент.
Сравнение пути итерации
 iterationPathComparison string

Правило, используемое при сравнении поля пути итерации.
Priority
 wiql__Microsoft_VSTS_Common_Priority string

Субъективная оценка ошибки, проблемы, задачи или тестового случая, как это относится к бизнесу.
Командный проект
 wiql__System_TeamProject string

Командный проект, к которому принадлежит этот рабочий элемент.
Создано автором
 wiql__System_CreatedBy string

Имя члена группы, создавшего рабочий элемент.

Возвращает

Выходные данные этой операции являются динамическими.

Определения

VstsList[Account]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of Account

Модели VSTS

Счет

Счет

Имя Путь Тип Описание
Идентификатор учетной записи
 accountId string

Идентификатор учетной записи.
URI учетной записи
 accountUri string

Универсальный код ресурса (URI) учетной записи.
Имя учетной записи
 accountName string

Имя учетной записи.
Владелец учетной записи
 accountOwner string

Владелец набора учетной записи.
Название организации
 organizationName string

Имя организации, соответствующее учетной записи.
Тип учетной записи
 accountType string

Тип учетной записи.

Profile

Profile

Имя Путь Тип Описание
отображаемое имя
 displayName string

Отображаемое имя пользователя
id
 id string

Уникальный идентификатор профиля.
publicAlias
 publicAlias string

Общедоступный псевдоним.
Электронная почта
 emailAddress string

Адрес электронной почты учетной записи.
Метка времени
 timeStamp date-time

Время, когда этот профиль был изменен в последний раз.
ревизия
 revision integer

Максимальный номер редакции любого атрибута.
CoreRevision
 coreRevision integer

CoreRevision

VstsList[TeamSettingsIteration]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of TeamSettingsIteration

Модели VSTS

TeamSettingsIteration

Итерация работы (гибкая)

Имя Путь Тип Описание
Attributes
 Attributes TeamIterationAttributes

Атрибуты итерации команды
Идентификатор
 Id string

Идентификатор ресурса.
Имя
 Name string

Имя ресурса.
Путь
 Path string

Относительный путь к итерации.
Links
 _links object

Коллекция ссылок, относящихся к ресурсу.
URL
 Url string

Полная http-ссылка на ресурс.

TeamIterationAttributes

Атрибуты итерации команды

Имя Путь Тип Описание
Дата окончания
 FinishDate date-time

Атрибут итерации команды окончания.
Дата начала
 StartDate date-time

Атрибут итерации команды начала.

Links

Имя Путь Тип Описание
веб
 web WebLinks

Веб-ссылки

Веб-ссылки

Имя Путь Тип Описание
HTML-ссылка
 href string

URL-адрес веб-страницы сведений о сборке

BuildResult

Результат сборки

Имя Путь Тип Описание
Идентификатор сборки
 id integer

Уникальный идентификатор сборки.
Номер сборки
 buildNumber string

Номер сборки.
Исходная ветвь
 sourceBranch string

Ветвь системы управления версиями используется сборка.
Исходная версия
 sourceVersion string

Версия системы управления версиями, используемая сборка.
Состояние
 status string

Состояние сборки.
Priority
 priority string

Приоритет сборки.
Время очереди
 queueTime date-time

Время, когда сборка была поставлена в очередь.
Время начала
 startTime date-time

Время начала сборки.
Время окончания
 finishTime date-time

Время завершения сборки.
Причина
 reason string

Причина сборки.
Result
 result string

Результат сборки.
запрошенные для
 requestedFor BuildRequestUser

Пользователь запроса на сборку
Параметры
 parameters string

Параметры, передаваемые в сборку, если таковые есть.
Определение
 definition BuildResultDefinition

Определение результата сборки
_дюны
 _links Links

Links

BuildRequestUser

Пользователь запроса на сборку

Имя Путь Тип Описание
Запрошено для
 uniqueName string

Для пользователя было запрошено уникальное имя сборки.

BuildResultDefinition

Определение результата сборки

Имя Путь Тип Описание
Идентификатор определения сборки
 id integer

Идентификатор определения сборки.
Имя определения сборки
 name string

Имя определения сборки.

VstsList[BuildResult]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of BuildResult

Модели VSTS

VstsList[GitRepository]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of GitRepository

Модели VSTS

GitRepository

Репозиторий Git

Имя Путь Тип Описание
Идентификатор репозитория
 id string

Уникальный идентификатор репозитория.
Имя репозитория
 name string

Имя репозитория.
URL-адрес браузера репозитория
 url string

URL-адрес — это конечная точка API для репозитория.
Удаленный URL-адрес репозитория
 remoteUrl string

URL-адрес, с помощью которого git может синхронизироваться с этим репозиторием.

VstsList[GitPush]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of GitPush

Модели VSTS

GitPush

Отправка Git

Имя Путь Тип Описание
репозиторий
 repository GitRepository

Репозиторий Git
pushedBy
 pushedBy GitPushUser

Git Push User
Обновления ссылок
 refUpdates array of GitRefUpdate

Ссылки, которые были обновлены в рамках этой принудительной отправки.
Push Id
 pushId integer

Уникальный идентификатор push-отправки.
Date
 date date-time

Дата создания отправки.

GitPushUser

Git Push User

Имя Путь Тип Описание
Идентификатор push-указателя
 id string

Уникальный идентификатор пользователя, создавшего push-отправку.
Имя push-указателя
 displayName string

Имя пользователя, создавшего push-отправку.
Уникальное имя push-указателя
 uniqueName string

Уникальное имя пользователя, создавшего push-отправку.
URL-адрес образа push-указателя
 imageUrl string

URL-адрес изображения для этого пользователя.

VstsList[GitPullRequest]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of GitPullRequest

Модели VSTS

GitPullRequest

Запрос на вытягивание Git

Имя Путь Тип Описание
репозиторий
 repository GitRepository

Репозиторий Git
Идентификатор запроса на вытягивание
 pullRequestId integer

Уникальный идентификатор запроса на вытягивание.
создано кем
 createdBy PullRequestCreatedBy

Запрос на вытягивание, созданный с помощью
Дата создания
 creationDate date-time

Дата создания запроса на вытягивание
Дата закрытия
 closedDate date-time

Дата закрытия запроса на вытягивание (завершена, отменена или объединена внешне)
Название
 title string

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

Описание запроса на вытягивание
Имя источника ссылок
 sourceRefName string

Имя исходной ветви запроса на вытягивание
Имя целевого ссылок
 targetRefName string

Имя целевой ветви запроса на вытягивание
Является черновиком
 isDraft boolean

Черновик / запрос на вытягивание WIP
Рецензенты
 reviewers array of PullRequestReviewer

Группы или команды, к которым способствовал этот рецензент.
Список рецензентов
 reviewerList string

Разделенный точкой с запятой список уникальных имен рецензента, которые являются допустимыми адресами электронной почты
Список обязательных рецензентов
 requiredReviewerList string

Разделенный точкой с запятой список обязательных имен проверяющего уникальных имен, которые являются допустимыми адресами электронной почты
Фиксации
 commits array of GitCommitRef

Фиксации, содержащиеся в запросе на вытягивание.
completionOptions
 completionOptions PullRequestCompletionOptions

Параметры завершения запроса на вытягивание
mergeOptions
 mergeOptions PullRequestMergeOptions

Параметры слияния запросов на вытягивание
Сообщение об ошибке слияния
 mergeFailureMessage string

Если задано, слияние запроса на вытягивание завершилось сбоем по этой причине.
closedBy
 closedBy PullRequestClosedBy

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

Автоматическое заполнение запроса на вытягивание по
URL-адрес
 url string

URL-адрес запроса на вытягивание.
Удаленный URL-адрес
 remoteUrl string

Удаленный URL-адрес запроса на вытягивание.
Идентификатор артефакта
 artifactId string

Строка, которая однозначно идентифицирует этот запрос на вытягивание.
Идентификатор слияния
 mergeId string

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

Идентификатор проверки кода запроса на вытягивание.
Время очереди завершения
 completionQueueTime string

Последняя дата, по которой запрос на вытягивание ввел очередь для завершения.
Поддерживает итерации
 supportsIterations boolean

Если задано значение true, этот запрос на вытягивание поддерживает несколько итераций.

PullRequestCreatedBy

Запрос на вытягивание, созданный с помощью

Имя Путь Тип Описание
Создано отображаемым именем
 displayName string

Отображаемое имя создателя запроса на вытягивание.
Создание по уникальному имени
 uniqueName string

Уникальное имя создателя запроса на вытягивание.
Создан идентификатором
 id string

Идентификатор создателя запроса на вытягивание.
Создан по URL-адресу образа
 imageUrl string

URL-адрес изображения создателя запроса на вытягивание.
Создан по URL-адресу
 url string

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

PullRequestClosedBy

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

Имя Путь Тип Описание
Закрыто по отображаемого имени
 displayName string

Отображаемое имя запроса на вытягивание ближе.
Закрыто уникальным именем
 uniqueName string

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

Идентификатор запроса на вытягивание ближе.
Закрыто по URL-адресу изображения
 imageUrl string

URL-адрес изображения запроса на вытягивание ближе.
Закрыто по URL-адресу
 url string

URL-адрес запроса на вытягивание ближе.

PullRequestAutoCompleteSetBy

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

Имя Путь Тип Описание
Автоматическое заполнение по отображаемого имени
 displayName string

Отображаемое имя пользователя, который включил автоматическое завершение.
Автоматическое завершение по уникальному имени
 uniqueName string

Уникальное имя пользователя, который включил автоматическое завершение.
Автоматическое заполнение по идентификатору
 id string

Идентификатор пользователя, который включил автоматическое завершение.
Автозавержение по URL-адресу изображения
 imageUrl string

URL-адрес изображения пользователя, который включил автозавержение.
Автоматическое заполнение по URL-адресу
 url string

URL-адрес пользователя, который включил автоматическое завершение.

PullRequestReviewer

Рецензент запроса на вытягивание

Имя Путь Тип Описание
Отображаемое имя рецензента
 displayName string

Отображаемое имя рецензента запроса на вытягивание.
Уникальное имя рецензента
 uniqueName string

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

Идентификатор рецензента запроса на вытягивание.
URL-адрес рецензента
 url string

URL-адрес рецензента запроса на вытягивание.
Отклонено
 hasDeclined boolean

Указывает, отказался ли этот рецензент проверить этот запрос на вытягивание.
Помечается
 isFlagged boolean

Указывает, помечен ли этот рецензент для внимания по этому запросу на вытягивание.
Требуется
 isRequired boolean

Указывает, является ли это обязательным рецензентом для этого запроса на вытягивание.
Голос
 vote integer

Голосование по запросу на вытягивание: утверждено(10), утверждено с предложениями(5), нет голосов(0), ожидая автора (-5), отклонено (-10).
Проголосовали за
 votedFor array of PullRequestReviewer

Группы или команды, к которым способствовал этот рецензент.

PullRequestMergeOptions

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

Имя Путь Тип Описание
Нет быстрого переадресации
 noFastForward string

Двух родительское слияние без быстрого переадресации. Исходная ветвь не изменяется. Это поведение по умолчанию.
Ребейз
 rebase string

Перебазируйте исходную ветвь поверх фиксации HEAD целевой ветви и перенаправите целевую ветвь.
Перебазировать слияние
 rebaseMerge string

Перебазируйте исходную ветвь поверх фиксации HEAD целевой ветви и создайте двух родительский, без быстрого слияния.
Сквош
 squash string

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

PullRequestMergeStrategy

Стратегия слияния запросов на вытягивание

Имя Путь Тип Описание
Фиксации авторства конфликтов
 conflictAuthorshipCommits boolean

Если задано значение true, разрешения конфликтов, примененные во время слияния, будут помещены в отдельные фиксации для сохранения сведений о авторстве для вины Git.
Обнаружение ложноположительных срабатываний
 detectRenameFalsePositives boolean

Если значение true, обнаруживает переименование ложных срабатываний.
Отключение переименований
 disableRenames boolean

Если значение true, обнаружение переименования не будет выполнено во время слияния.

PullRequestCompletionOptions

Параметры завершения запроса на вытягивание

Имя Путь Тип Описание
Автоматическое завершение пропустить идентификаторы конфигурации
 autoCompleteIgnoreConfigIds array of integer

Список идентификаторов конфигурации политики, для которых автоматическое завершение не должно ожидать
Обход политики
 bypassPolicy boolean

Если значение true, политики будут явно обойдены во время завершения запроса на вытягивание.
Обход причины
 bypassReason string

Если политики обходятся, сохраняется причина использования обхода.
Удаление исходной ветви
 deleteSourceBranch boolean

Если true, исходная ветвь запроса pull будет удалена после завершения.
Сообщение об фиксации слияния
 mergeCommitMessage string

Если этот параметр установлен, он будет использоваться в качестве сообщения о коммите слияния.
mergeStrategy
 mergeStrategy PullRequestMergeStrategy

Стратегия слияния запросов на вытягивание
Слияние скваша
 squashMerge boolean

Если MergeStrategy не задан, стратегия слияния будет без быстрой перемотки, если этот флаг имеет значение false, или squash, если true.
Переход рабочих элементов
 transitionWorkItems boolean

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

CommitGitUserDate

Фиксация Git User Date

Имя Путь Тип Описание
Дата фиксации пользователя
 date string

Дата выполнения операции Git.
Фиксация электронной почты пользователя
 email string

Адрес электронной почты пользователя, выполняющего операцию Git.
Url-адрес фиксации изображения
 imageUrl string

URL для аватара пользователя.
Зафиксировать имя пользователя
 name string

Имя пользователя, выполняющего операцию Git.

GitCommitRef

Ссылка на фиксацию Git

Имя Путь Тип Описание
автор
 author CommitGitUserDate

Фиксация Git User Date
Зафиксировать комментарий
 comment string

Комментарий или сообщение фиксации.
Усечение примечания фиксации
 commentTruncated string

Указывает, усечен ли комментарий из полного сообщения о фиксации Git.
Идентификатор фиксации
 commitId string

Идентификатор фиксации.
Коммиттер
 committer CommitGitUserDate

Фиксация Git User Date
Родители
 parents array of string

Перечисление идентификаторов родительских фиксаций для этой фиксации.
Фиксация удаленного URL-адреса
 remoteUrl string

Удаленный путь URL-адреса к фиксации.
URL-адрес фиксации
 url string

REST URL-адрес для этого ресурса.

GitRefUpdate

Обновление Git Ref

Имя Путь Тип Описание
Имя ссылки
 name string

Имя обновленного Git Ref.
Идентификатор репозитория
 repositoryId string

Уникальный идентификатор репозитория.
Старый идентификатор фиксации
 oldObjectId string

Идентификатор предыдущей фиксации, на который указывает ссылка перед обновлением.
Новый идентификатор фиксации
 newObjectId string

Идентификатор новой фиксации, на который указывает ссылка перед обновлением.

VstsList[Project]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of Project

Модели VSTS

Проект

Проект

Имя Путь Тип Описание
Идентификатор проекта
 id string

Уникальный идентификатор проекта.
Имя проекта
 name string

Имя проекта.
URL-адрес проекта
 url string

URL-адрес API проекта.

VstsList[ReleaseDefinition]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of ReleaseDefinition

Модели VSTS

ReleaseDefinition

Определение выпуска

Имя Путь Тип Описание
Комментарий
 Comment string

Комментарий определения выпуска.
Создано
 CreatedOn date-time

Дата создания определения выпуска.
Description
 Description string

Описание определения выпуска.
Идентификатор
 Id integer

Уникальный идентификатор определения выпуска.
ModifiedBy
 ModifiedBy IdentityRef

Ссылка на удостоверение
Изменено
 ModifiedOn date-time

Дата изменения определения выпуска.
Имя
 Name string

Имя определения выпуска.
Путь
 Path string

Путь определения выпуска.
Формат имени выпуска
 ReleaseNameFormat string

Формат имени выпуска определения выпуска.
Исправление
 Revision integer

Номер редакции определения выпуска.
Исходный материал
 Source string

Источник определения выпуска.
Метки
 Tags array of string

Список тегов определения выпуска.
URL
 Url string

URL-адрес для доступа к определению выпуска.

IdentityRef

Ссылка на удостоверение

Имя Путь Тип Описание
Псевдоним каталога
 DirectoryAlias string

Псевдоним каталога ссылки на удостоверение.
Отображаемое имя
 DisplayName string

Отображаемое имя ссылки на удостоверение.
Уникальное имя
 UniqueName string

Уникальное имя ссылки на удостоверение.
URL
 Url string

URL-адрес ссылки на удостоверение.
Идентификатор
 Id string

Идентификатор ссылки на удостоверение.

ReleaseDefinitionShallowReference

Неглубокая ссылка на определение выпуска

Имя Путь Тип Описание
Идентификатор
 Id integer

Уникальный идентификатор определения выпуска.
Имя
 Name string

Имя определения выпуска.
URL
 Url string

URL-адрес REST API для доступа к определению выпуска.

Object

ObjectWithoutType

Релиз

Релиз

Имя Путь Тип Описание
Комментарий
 Comment string

Комментарий к выпуску.
Создано пользователем
 CreatedBy IdentityRef

Ссылка на удостоверение
Создано
 CreatedOn date-time

Дата создания выпуска.
Description
 Description string

Описание выпуска.
Идентификатор
 Id integer

Уникальный идентификатор выпуска.
Сохранить навсегда
 KeepForever boolean

Следует ли исключить выпуск из политик хранения.
URL-адрес контейнера журналов
 LogsContainerUrl string

URL-адрес контейнера журнала этого выпуска.
ModifiedBy
 ModifiedBy IdentityRef

Ссылка на удостоверение
Изменено
 ModifiedOn date-time

Дата изменения выпуска.
Имя
 Name string

Имя выпуска.
Причина
 Reason string

Причина выпуска.
ReleaseDefinition
 ReleaseDefinition ReleaseDefinitionShallowReference

Неглубокая ссылка на определение выпуска
Состояние
 Status string

Состояние выпуска.
URL
 Url string

URL-адрес выпуска.

VstsList[TfvcChangeset]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of TfvcChangeset

Модели VSTS

TfvcChangeset

Набор изменений управления версиями Team Foundation

Имя Путь Тип Описание
Идентификатор набора изменений
 changesetId integer

Уникальный идентификатор набора изменений.
автор
 author ChangesetAuthor

Автор набора изменений
checkedInBy
 checkedInBy ChangesetCheckedInBy

Набор изменений, зарегистрированный по
Дата создания
 createdDate date-time

Дата создания набора изменений.
Комментарий
 comment string

Комментарий, описывающий набор изменений.

ChangesetAuthor

Автор набора изменений

Имя Путь Тип Описание
Имя автора
 displayName string

Имя пользователя, создавшего набор изменений.
Уникальное имя автора
 uniqueName string

Уникальное имя пользователя, создавшего набор изменений.

ChangesetCheckedInBy

Набор изменений, зарегистрированный по

Имя Путь Тип Описание
Возвращено по имени
 displayName string

Имя пользователя, который проверил набор изменений.
Зарегистрировано по уникальному имени
 uniqueName string

Уникальное имя пользователя, создавшего набор изменений.

VstsList[WorkItemType]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of WorkItemType

Модели VSTS.

WorkItemType

Тип рабочего элемента

Имя Путь Тип Описание
Description
 Description string

Описание типа.
Имя
 Name string

Имя типа.
XML-форма
 XmlForm string

XML-представление типа.
Fields
 FieldInstances array of WorkItemTypeFieldInstance

Список экземпляров полей, связанных с типом.
Идентификатор значка
 icon.id string

Идентификатор значка
URL-адрес значка
 icon.url string

URL-адрес REST ресурса
States
 states array of WorkItemStateColor

Состояния типа рабочего элемента

WorkItemTypeFieldInstance

Экземпляр поля типа рабочего элемента

Имя Путь Тип Описание
Всегда обязательный
 AlwaysRequired boolean

Указывает, всегда ли требуется экземпляр поля.
Имя ссылки
 ReferenceName string

Имя ссылки экземпляра поля.
Имя
 Name string

Имя экземпляра поля.
URL
 Url string

URL-адрес, указывающий на сведения о экземпляре поля.

VstsList[JObject]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of Object

Модели VSTS

VstsList[QueryHierarchyItem]

Список моделей VSTS.

Имя Путь Тип Описание
Ценность
 value array of QueryHierarchyItem

Модели VSTS

QueryHierarchyItem

Элемент иерархии запросов

Имя Путь Тип Описание
Дети
 Children array of QueryHierarchyItem

Список дочерних элементов, связанных с элементом иерархии запросов.
Клаузулы
 Clauses WorkItemQueryClause

Предложение запроса рабочих элементов
Колонны
 Columns array of WorkItemFieldReference

Список столбцов полей рабочего элемента, связанных с элементом иерархии запросов.
Параметры фильтра
 FilterOptions string

Параметры фильтра элемента иерархии запросов.
Имеет детей
 HasChildren boolean

Указывает, имеет ли элемент иерархии запросов дочерние элементы.
Идентификатор
 Id string

Уникальный идентификатор элемента иерархии запросов.
Удаляется
 IsDeleted boolean

Указывает, удаляется ли элемент иерархии запросов.
Папка Is
 IsFolder boolean

Указывает, является ли элемент иерархии запросов папкой.
Недопустимый синтаксис
 IsInvalidSyntax boolean

Указывает, имеет ли элемент иерархии запросов недопустимый синтаксис.
Общедоступная
 IsPublic boolean

Указывает, является ли элемент иерархии запросов общедоступным.
LinkClauses
 LinkClauses WorkItemQueryClause

Предложение запроса рабочих элементов
Имя
 Name string

Имя элемента иерархии запросов.
Путь
 Path string

Путь к элементу иерархии запросов.
Тип запроса
 QueryType string

Тип запроса элемента иерархии запросов.
Сортировка столбцов
 SortColumns array of WorkItemQuerySortColumn

Список столбцов сортировки элемента иерархии запросов.
SourceClauses
 SourceClauses WorkItemQueryClause

Предложение запроса рабочих элементов
TargetClauses
 TargetClauses WorkItemQueryClause

Предложение запроса рабочих элементов
Wiql
 Wiql string

WIQL элемента иерархии запросов.
Links
 _links object

Коллекция ссылок, относящихся к элементу иерархии запросов.
URL
 Url string

Полная http-ссылка на элемент иерархии запросов.

WorkItemStateColor

Цвет состояния рабочего элемента

Имя Путь Тип Описание
категория состояния
 category string

категория состояния
Значение цвета
 color string

Значение цвета
имя состояния
 name string

Имя состояния типа рабочего элемента

WorkItemQueryClause

Предложение запроса рабочих элементов

Имя Путь Тип Описание
Клаузулы
 Clauses WorkItemQueryClause

Предложение запроса рабочих элементов
Поле
 Field WorkItemFieldReference

Справочник по полю рабочего элемента
FieldValue
 FieldValue WorkItemFieldReference

Справочник по полю рабочего элемента
Значение поля
 IsFieldValue boolean

Указывает, является ли предложение запроса рабочего элемента значением поля.
Логический оператор
 LogicalOperator string

Логический оператор предложения запроса рабочего элемента.
Operator
 Operator WorkItemFieldOperation

Операция поля рабочего элемента
Ценность
 Value string

Значение предложения запроса рабочего элемента.

WorkItemFieldReference

Справочник по полю рабочего элемента

Имя Путь Тип Описание
Имя
 Name string

Имя ссылки на поле рабочего элемента.
Имя ссылки
 ReferenceName string

Имя ссылки на поле рабочего элемента.
URL
 Url string

URL-адрес ссылки на поле рабочего элемента.

WorkItemQuerySortColumn

Столбец сортировки запросов рабочих элементов

Имя Путь Тип Описание
Descending
 Descending boolean

Указывает, убывает ли столбец сортировки запроса рабочего элемента.
Поле
 Field WorkItemFieldReference

Справочник по полю рабочего элемента

WorkItemFieldOperation

Операция поля рабочего элемента

Имя Путь Тип Описание
Имя
 Name string

Имя операции поля рабочего элемента.
Имя ссылки
 ReferenceName string

Имя ссылки для операции поля рабочего элемента.

Pipeline

Имя Путь Тип Описание
count
 count integer

count
value
 value array of object

Массив, имеющий список всех конвейеров
href
 value._links.self.href string

href
href
 value._links.web.href string

href
folder
 value.folder string

folder
id
 value.id integer

id
имя
 value.name string

имя
ревизия
 value.revision integer

ревизия
URL-адрес
 value.url string

URL-адрес

Run

Имя Путь Тип Описание
count
 count integer

count
value
 value array of object

Прогон конвейера
href
 value._links.self.href string
href
 value._links.web.href string
href
 value._links.pipeline.web.href string
href
 value._links.pipeline.href string
URL-адрес
 value.pipeline.url string
id
 value.pipeline.id integer
ревизия
 value.pipeline.revision integer
имя
 value.pipeline.name string
folder
 value.pipeline.folder string
государство
 value.state RunState

Состояние выполнения
дата создания
 value.createdDate string

дата создания
URL-адрес
 value.url string

URL-адрес конвейера
id
 value.id integer

Идентификатор конвейера
имя
 value.name string

имя
результат
 value.result RunResult

Результат выполнения
Готовоеdate
 value.finishedDate string

Дата завершения выполнения

RunResult

Результат выполнения

Результат выполнения

string

RunState

Состояние выполнения

Состояние выполнения

string