Массовый перенос задач в другую очередь

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

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

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

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

  1. Формат запроса
  2. Формат ответа

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

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

Чтобы перенести задачи в другую очередь, используйте HTTP-запрос с методом POST:

POST /v2/bulkchange/_move
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>

{
  "queue": "<ключ очереди>",
  "issues": ["TEST-1, TEST-2, TEST-3"]
}
Параметры запроса
Параметр Описание Тип данных
Дополнительные параметры
notify Признак уведомления об изменении задачи:
  • true – пользователи, указанные в полях задачи, получат уведомления;
  • false – (по умолчанию) пользователи не получат уведомления.
 Логический.
Параметр Описание Тип данных
Дополнительные параметры
notify Признак уведомления об изменении задачи:
  • true – пользователи, указанные в полях задачи, получат уведомления;
  • false – (по умолчанию) пользователи не получат уведомления.
 Логический.
Параметры тела запроса
Параметр Описание Тип данных
Обязательные параметры
queue Ключ очереди, в которую планируется перенести задачи. Строка.
issues Идентификаторы задач, которые необходимо перенести. Строка.
Дополнительные параметры
values Параметры задач, которые будут изменены при переносе. Используйте параметры, доступные при редактировании задачи. Строка.
moveAllFields

Перенос версий, компонентов и проектов задачи в новую очередь:

  • true – перенести, если в новой очереди существуют соответствующие версии, компоненты, проекты;
  • false (по умолчанию) – очистить версии, компоненты, проекты.
 Логический.
initialStatus

Сброс статуса задачи в начальное значение. Статус необходимо сбросить, если задача переносится в очередь с другим воркфлоу:

  • true – статус будет сброшен;
  • false (по умолчанию) – статус останется без изменений.
 Логический.
Параметр Описание Тип данных
Обязательные параметры
queue Ключ очереди, в которую планируется перенести задачи. Строка.
issues Идентификаторы задач, которые необходимо перенести. Строка.
Дополнительные параметры
values Параметры задач, которые будут изменены при переносе. Используйте параметры, доступные при редактировании задачи. Строка.
moveAllFields

Перенос версий, компонентов и проектов задачи в новую очередь:

  • true – перенести, если в новой очереди существуют соответствующие версии, компоненты, проекты;
  • false (по умолчанию) – очистить версии, компоненты, проекты.
 Логический.
initialStatus

Сброс статуса задачи в начальное значение. Статус необходимо сбросить, если задача переносится в очередь с другим воркфлоу:

  • true – статус будет сброшен;
  • false (по умолчанию) – статус останется без изменений.
 Логический.

Пример: Перенести задачи.

  • Используется HTTP-метод POST.

  • Задачи «TEST-1», «TEST-2», «TEST-3» перемещаются в очередь «CHECK».
  • Каждой перемещенной задаче присваивается тег «перемещено».
POST /v2/bulkchange/_move
Host: https://api.tracker.yandex.net
Authorization: OAuth <OAuth-токен>
X-Org-Id: <идентификатор организации>
{
  "queue": "CHECK",
  "issues": ["TEST-1","TEST-2","TEST-3"],
  "values": {
    "tags":{
      "add":["перемещено"]
    }
  },
  "moveAllFields": true
}

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

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

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

{
    "id": "1ab23cd4e56789012fg345h6",
    "self": "https://api.tracker.yandex.net/v2/bulkchange/1ab23cd4e56789012fg345h6",
    "createdBy": {
        "self": "https://api.tracker.yandex.net/v2/users/1234567890",
        "id": "1234567890",
        "display": "Имя Фамилия"
    },
    "createdAt": "2020-12-15T11:52:53.665+0000",
    "status": "CREATED",
    "statusText": "Операция массового редактирования задач создана.",
    "executionChunkPercent": 0,
    "executionIssuePercent": 0
}
Параметры ответа
Параметр Описание Тип данных
id Идентификатор операции массового редактирования. Строка.
self Адрес ресурса API, который содержит информацию о массовом редактировании. Строка.
createdBy Объект с информацией об инициаторе массового редактирования. Объект.
createdAt Дата и время создания операции массового редактирования. Строка.
status Статус операции массового редактирования. Строка.
statusText Описание статуса операции массового редактирования. Строка.
executionChunkPercent Служебный параметр. Число.
executionIssuePercent Служебный параметр. Число.
Поля объекта createdBy
self

Адрес ресурса API, который содержит информацию о пользователе.

Строка.
id

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

Число.
display

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

Строка.
Параметр Описание Тип данных
id Идентификатор операции массового редактирования. Строка.
self Адрес ресурса API, который содержит информацию о массовом редактировании. Строка.
createdBy Объект с информацией об инициаторе массового редактирования. Объект.
createdAt Дата и время создания операции массового редактирования. Строка.
status Статус операции массового редактирования. Строка.
statusText Описание статуса операции массового редактирования. Строка.
executionChunkPercent Служебный параметр. Число.
executionIssuePercent Служебный параметр. Число.
Поля объекта createdBy
self

Адрес ресурса API, который содержит информацию о пользователе.

Строка.
id

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

Число.
display

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

Строка.