Закрыть обучение

POST /trainings/{id}/close-for-update

Закрывает обучающий пул для редактирования.

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

В результате запросов создается операция. Чтобы отслеживать ход операции, отправьте запрос к ресурсу /operations.

Примеры запросов

curl -X POST 'https://tasks.yandex.ru/api/v1/trainings/1239110/close-for-update' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here'

import requests

url = "https://tasks.yandex.ru/api/v1/trainings/1239110/close-for-update"
headers = {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
response = requests.post(url, headers=headers)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://tasks.yandex.ru/api/v1/trainings/1239110/close-for-update',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

id*

string

Идентификатор обучающего пула.

Заголовки

Заголовок

Описание

Authorization

API-токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Ответ

Примечание

Если текущий статус обучающего пула совпадает с запрашиваемым, то возвращается пустой ответ со статусом 204.

{
  "id": "52829015-033f-4c3a-a7cc-0d7eff235663",
  "type": "TRAINING.CLOSE",
  "status": "SUCCESS",
  "submitted": "2022-04-07T16:06:15.902",
  "started": "2022-04-07T16:06:15.902",
  "finished": "2022-04-07T16:06:15.902",
  "progress": 100,
  "parameters": {
    "training_id": "123456"
  },
  "details": {}
}

Параметр

Описание

id

string

Идентификатор операции.

type

string

Тип операции: TRAINING.CLOSE — закрыть обучение.

status

string

Статус операции:

  • PENDING — выполнение не началось;
  • RUNNING — выполняется;
  • SUCCESS — успешно выполнена;
  • FAIL — не выполнена.

submitted

string

Дата и время отправки запроса по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

started

string

Дата и время начала операции по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

finished

string

Дата и время окончания операции по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

progress

integer

Ход выполнения операции в процентах.

parameters.training_id

string

Идентификатор обучающего пула.

details

object

Детали выполнения операции.

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

Предыдущая
Закрыть обучение
Следующая
Открыть обучение