Информация о выполнении пакетной операции

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

GET

https://api.tracker.yandex.net/v3/bulkchange/<id>

Получить статус выполнения пакетной операции

Формат запроса

Перед выполнением запроса получите доступ к API.

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

GET /v3/bulkchange/<id>
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки
  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Трекеру привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Трекеру привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу АдминистрированиеОрганизации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
<id> Идентификатор запущенной пакетной операции в формате 593cd211ef7e8a33********. Строка

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

Тело ответа содержит информацию о статусе пакетной операции в формате JSON.

{
   "id": "593cd211ef7e8a33********",
   "self": "https://api.tracker.yandex.net/v3/bulkchange/593cd211ef7e8a33********",
   "createdBy": {
      "self": "https://api.tracker.yandex.net/v3/users/11********",
      "id": "11********",
      "display": "Имя Фамилия",
      "cloudUid": "ajeppa7dgp53********",
      "passportUid": 11********
   },
   "createdAt": "2024-06-26T19:00:47.451+0000",
   "status": "FAILED",
   "statusText": "Изменения не выполнены",
   "executionChunkPercent": 100,
   "executionIssuePercent": 100,
   "totalIssues": 24,
   "totalCompletedIssues": 0
}
Параметры ответа
Параметр Описание Тип данных
id Идентификатор пакетной операции. Строка
self Адрес ресурса API, который содержит информацию о пакетной операции. Строка
createdBy Информация об инициаторе пакетной операции. Объект
createdAt Дата и время создания пакетной операции. Строка
status Статус пакетной операции. Строка
statusText Описание статуса пакетной операции. Строка
executionChunkPercent Служебный параметр. Число
executionIssuePercent Служебный параметр. Число
totalIssues Количество задач, которые должны быть отредактированы. Число
totalCompletedIssues Количество задач, для которых пакетная операция завершилась успешно. Число

Поля объекта createdBy

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
422
Ошибка валидации JSON, запрос отклонен.

Получить список задач, для которых операция завершилась с ошибкой

Формат запроса

Перед выполнением запроса получите доступ к API.

Чтобы получить список задач, для которых пакетная операция завершилась с ошибкой, используйте HTTP-запрос с методом GET.

GET /v3/bulkchange/{id}/issues
Host: api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-ID или X-Cloud-Org-ID: <идентификатор_организации>
Заголовки
  • Host: адрес узла, предоставляющего API.

  • Authorization: токен для авторизации в одном из форматов:

    • OAuth <OAuth-токен> при авторизации по протоколу OAuth 2.0. Читать подробнее

    • Bearer <IAM-токен> при авторизации с помощью IAM-токена — если к Трекеру привязана организация Yandex Cloud Organization. Читать подробнее

  • X-Org-ID или X-Cloud-Org-ID: идентификатор организации.

    • Используйте заголовок X-Org-ID, если к Трекеру привязана организация Яндекс 360 для бизнеса.

    • Используйте заголовок X-Cloud-Org-ID, если к Трекеру привязана организация Yandex Cloud Organization.

    Чтобы узнать идентификатор организации, перейдите на страницу АдминистрированиеОрганизации и скопируйте значение поля идентификатор.

Ресурс
Параметр Описание Тип данных
<id> Идентификатор запущенной пакетной операции в формате 593cd211ef7e8a33********. Строка

Формат ответа

В случае успешного выполнения запроса API возвращает ответ с кодом 200 OK.

Тело ответа содержит список задач, для которых пакетная операция завершилась с ошибкой, в формате JSON.

[
   {
      "issue": {
            "self": "https://api.tracker.yandex.net/v3/issues/TEST-1",
            "id": "593cd211ef668a33********",
            "key": "TEST-1",
            "display": "My issue"
      },
      "status": "FAILED",
      "statusText": "Изменения не выполнены",
      "error": {
            "errors": {
               "resolution": "Выбранную резолюцию нельзя использовать для задачи этого типа в данной очереди."
            },
            "errorMessages": []
      }
   },
   {
      "issue": {
            "self": "https://api.tracker.yandex.net/v3/issues/TEST-4",
            "id": "593cd211ef756a33********",
            "key": "TEST-4",
            "display": "Задача"
      },
      "status": "FAILED",
      "statusText": "Изменения не выполнены",
      "error": {
            "errors": {
               "resolution": "Выбранную резолюцию нельзя использовать для задачи этого типа в данной очереди."
            },
            "errorMessages": []
      }
   },
   ...
]
Параметры ответа
Параметр Описание Тип данных
issue Блок с информацией о задаче. Объект
status Тип ошибки выполнения пакетной операции. Строка
statusText Описание ошибки выполнения пакетной операции. Строка
error Блок с информацией об ошибках, возникших в задаче при выполнении пакетной операции. Объект

Поля объекта createdBy

Параметр Описание Тип данных
self Адрес ресурса API, который содержит информацию о пользователе. Строка
id Идентификатор пользователя. Строка
display Отображаемое имя пользователя. Строка
passportUid Уникальный идентификатор аккаунта пользователя в организации Яндекс 360 для бизнеса и Яндекс ID. Число
cloudUid Уникальный идентификатор пользователя в Yandex Cloud Organization. Строка

Поля объекта error

Параметр Описание Тип данных
errors Описание ошибок. Объект
errorMessages Служебный параметр. Массив

Если запрос не был успешно обработан, API возвращает ответ с кодом ошибки:

400
Один или несколько параметров запроса имеют недопустимое значение.
401
Пользователь не авторизован. Проверьте, были ли выполнены действия, описанные в разделе Доступ к API.
403
У вас не хватает прав на выполнение этого действия. Наличие прав можно перепроверить в интерфейсе Трекера — для выполнения действия при помощи API и через интерфейс требуются одинаковые права.
422
Ошибка валидации JSON, запрос отклонен.