Операция

Статья
10/24/2024

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

В данном разделе приводится описание сущности Operation и демонстрируется выполнение различных операций с API REST служб мультимедиа.

Свойства сущности «Операция»
Операции запросов
Коды ошибок операции

Важно!

При доступе к сущностям в службах мультимедиа необходимо задать определенные поля и значения заголовков в HTTP-запросах.
Дополнительные сведения см. в разделе Настройка разработки REST API Служб мультимедиа и подключение к службам мультимедиа с помощью REST API Служб мультимедиа.

Свойства сущности «Операция»

`Property`	Тип	Описание
`Id` Только для чтения.	Строка	Идентификатор операции, назначенный службами мультимедиа при создании операции. Формат будет следующим: `nb:opid:UUID:<GUID>`.
`ErrorCode` Только для чтения.	Строка	Код ошибки неудачного выполнения операции. Сведения о возможных кодах ошибок см. в разделе Коды ошибок операций.
`ErrorMessage` Только для чтения.	Строка	Подробное сообщение об ошибке неудачного выполнения операции.
`State` Только для чтения.	Строка	Текущее состояние. Возможные значения: - Succeeded. Сбой - InProgress.
`TargetEntityId` Только для чтения.	Строка	Идентификатор цели действия.

Операции запросов

Запрашивает указанную операцию.

Метод	Универсальный код ресурса (URI) запроса	параметр "Версия HTTP"
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

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

Сведения о том, как получить последнюю версию x-ms-version:, см. в разделе REST Служб мультимедиа.

GET api/Operations('nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b') HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: <host URI>  
Content-Length: 0

При успешном выполнении возвращается код состояния 200 ОК вместе с сообщением о состоянии в тексте ответа, как показано в следующем примере.

Пример ответа

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 280  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Server: Microsoft-IIS/7.5  
request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
x-ms-request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Wed, 15 Jan 2014 19:31:13 GMT  
  
{"odata.metadata":"https://wamsbayclus001rest-hs.cloudapp.net/api/$metadata#Operations/@Element","Id":"nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b","State":"Succeeded","TargetEntityId":"nb:chid:UUID:1e518dbc-91ef-4044-a8bd-d20769dae833","ErrorCode":null,"ErrorMessage":null}

Коды ошибок операции

Коды ошибок операции перечислены ниже.

Код ошибки	Описание
BadRequest	Отправляется, когда другие ошибки неприменимы или конкретная ошибка неизвестна.
InsufficientCapacity	Недостаточная емкость центра обработки данных.
InternalError	Возникли непредвиденные ошибки из службы.
InvalidIdentifierFormat	Недопустимый формат идентификатора сущности.
InvalidOperation	Запрос недопустим в текущем состоянии сущности.
InvalidResourceName	Указано недопустимое имя источника.
OperationInProgress	В указанной сущности уже выполняется другая операция.
OperationNotFound	Для указанного идентификатора операции не найдена запись операции. Операция могла быть удалена через определенное время или неправильный идентификатор.
ResourceNameTaken	Попытка создания нового источника с именем, который уже используется.
ResourceNotFound	Указанный ресурс не найден.
ExceededResourceQuota	Запрос превышает лимит ресурсов.
Время ожидания	Время асинхронной операции истекло.
DeleteNotAllowedOnDefaultOrigin	Попытка удаления источника по умолчанию.
SettingsUpdateInProgress	Обновление уже выполняется.

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