Позволяет получить информацию о задаче по ее идентификатору.
Метод:
GET /api/2.0/virtualization/tasks/{идентификатор}
где:
{идентификатор} – идентификатор задачи (обязательный параметр).
В случае успешного выполнения запроса REST API возвращает сведения о задаче в следующем виде:
<task id="{идентификатор}" created="{дата и время}" stateChanged="{дата и время}" changed="{дата и время}">
<state>{состояние}</state>
<type>{тип}</type>
<stage>{этап}</stage>
<progress>{процент выполнения}</progress>
<result>{результат}</result>
<!-- Если задача завершилась с ошибкой вместо результата отображается сообщение об ошибке. -->
<error>{сообщение об ошибке}</error>
</task>
где:
{идентификатор} – идентификатор задачи.created="{дата и время}" – время создания задачи в формате YYYY-MM-DDThh:mm:ss.stateChanged="{дата и время}" – время изменения состояния задачи в формате YYYY-MM-DDThh:mm:ss.changed="{дата и время}" – время изменения задачи в формате YYYY-MM-DDThh:mm:ss.{состояние} – состояние задачи.{тип} – тип задачи. Например:CreateTenant – задача, которая используется в процедуре создания клиента.ChangeTenantActivation – задача, которая используется в процедурах активации и деактивации клиента.DeleteTenant – задача, которая используется в процедуре удаления клиента.CreateTenantReport – задача, которая используется в процедуре формирования отчета о защите клиентов.{название} – название задачи.{этап} – этап выполнения задачи.{процент выполнения} – ход выполнения задачи в процентах.{результат} – результат выполнения задачи, например, информация о созданном клиенте или идентификатор отчета.{сообщение об ошибке} – если в ходе выполнения задачи произошла ошибка, отображается сообщение об ошибке.Коды возврата:
200 (OK) – запрос выполнен успешно.403 (Forbidden) – доступ к ресурсу запрещен. 404 (Not Found) – задача с указанным идентификатором не найдена в базе данных Сервера интеграции.