Compartir a través de

Operación

  • Artículo

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.

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.