Operación

Representa el estado actual de una operación de larga duración. Entre los ejemplos de operaciones de larga duración se incluyen el inicio, la detención y la eliminación de un elemento Origin.

En este tema encontrará un resumen de la entidad Operation y una demostración de cómo ejecutar distintas operaciones con la API de REST de Media Services.

• Propiedades de entidad de operación

• Operaciones de consulta

• Códigos de error de operación

Importante

Al obtener acceso a las entidades de Media Services, debe establecer los campos de encabezado específicos y los valores en las solicitudes HTTP.
Para obtener más información, consulte Configuración del desarrollo de la API de REST de Media Services y Conexión a Media Services con la API de REST de Media Services.

Propiedades de entidad de operación

Property	Tipo	Descripción
Id Solo lectura.	String	El identificador de la operación, asignado por Media Services al crear una operación. El formato es: nb:opid:UUID:<GUID>.
ErrorCode Solo lectura.	String	El código de error de la operación con error. Para obtener información sobre los posibles códigos de error, vea Códigos de error de operación.
ErrorMessage Solo lectura.	String	Mensaje de error detallado de la operación con error.
State Solo lectura.	String	El estado actual. Los valores posibles son: - Correcto Con error - En curso
TargetEntityId Solo lectura.	String	Identificador del destino de la acción.

Operaciones de consulta

Consulta la operación especificada.

Método	URI de solicitud	Versión de HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Solicitud de ejemplo

Para obtener la versión más reciente x-ms-version:, consulte REST de Media Services.

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  
  

En caso de ser correcto, se devuelve un código de estado 200 OK junto con un mensaje de estado en el cuerpo de la respuesta, tal como se muestra en el ejemplo siguiente.

Respuesta de ejemplo

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}  

Códigos de error de operación

Los códigos de error de operación se muestran aquí.

Código de error	Descripción
BadRequest	Se envía cuando no hay otro error aplicable o se desconoce el error exacto.
InsufficientCapacity	El centro de datos tiene una capacidad insuficiente.
InternalError	Se produjeron errores inesperados desde el servicio.
InvalidIdentifierFormat	El formato de identificador de entidad no es válido.
InvalidOperation	La solicitud no es válida en el estado actual de la entidad.
InvalidResourceName	El nombre del elemento Origin especificado no es válido.
OperationInProgress	Ya hay otra operación en curso en la entidad especificada.
OperationNotFound	No se encuentra el registro de la operación para el identificador de operación especificado. Es posible que la operación se haya quitado después de un intervalo de tiempo o que el identificador sea incorrecto.
ResourceNameTaken	Intentando crear un nuevo elemento Origin con un nombre que ya se está usando.
ResourceNotFound	No se encuentra el recurso especificado.
ExceededResourceQuota	La solicitud supera el límite de cuota del recurso.
Tiempo de espera	Se ha superado el tiempo de espera de la operación asincrónica.
DeleteNotAllowedOnDefaultOrigin	Ha intentado eliminar el elemento Origin predeterminado.
SettingsUpdateInProgress	Ya hay una actualización en curso.