Operação

Artigo
08/05/2023

Representa o estado atual de uma operação de execução prolongada. Exemplos de operações de execução prolongada incluem iniciar, parar e eliminar uma Origem.

Este tópico fornece uma descrição geral da Operation entidade e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Propriedades da Entidade de Operação
Operações de Consulta
Códigos de Erro de Operação

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API ( Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades da Entidade de Operação

`Property`	Tipo	Description
`Id` Só de leitura.	String	O ID da operação, atribuído pelos Serviços de Multimédia na criação de uma operação. O formato é: `nb:opid:UUID:<GUID>`.
`ErrorCode` Só de leitura.	String	O código de erro da operação falhada. Para obter informações sobre possíveis códigos de erro, consulte Códigos de Erro de Operação.
`ErrorMessage` Só de leitura.	String	A mensagem de erro detalhada da operação falhada.
`State` Só de leitura.	String	O estado atual. Valores possíveis incluem: - Bem-sucedido - Falhado - InProgress
`TargetEntityId` Só de leitura.	String	O ID do destino da ação.

Operações de Consulta

Consulta a operação especificada.

Método	URI do pedido	Versão HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Pedido de Amostra

Para obter as versões mais recentes x-ms-version:, veja Serviços de Multimédia 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

Se for bem-sucedido, é devolvido um código de estado 200 OK juntamente com uma mensagem de estado no corpo da resposta, conforme mostrado no exemplo seguinte.

Resposta de Amostra

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 Erro de Operação

Os códigos de erro de operação estão listados aqui.

Código de Erro	Description
BadRequest	Enviado quando não é aplicável outro erro ou se o erro exato é desconhecido.
InsufficientCapacity	O datacenter não tem capacidade suficiente.
InternalError	Erros inesperados ocorridos a partir do serviço.
InvalidIdentifierFormat	O formato do ID da entidade é inválido.
InvalidOperation	O pedido é inválido no estado atual da entidade.
InvalidResourceName	O nome de Origem especificado é inválido.
OperationInProgress	Outra operação já está em curso na entidade especificada.
OperationNotFound	O registo de operação não foi encontrado para o ID de operação especificado. A operação pode ter sido removida após um intervalo de tempo ou o ID está errado.
ResourceNameTaken	A tentar criar uma nova Origem com um nome que já está a ser utilizado.
ResourceNotFound	O recurso especificado não foi encontrado.
ExceededResourceQuota	O pedido excede o limite de quota de recursos.
Tempo Limite	A operação assíncrona excedeu o tempo limite.
DeleteNotAllowedOnDefaultOrigin	Tentou eliminar a Origem predefinida.
SettingsUpdateInProgress	Já está em curso uma atualização.

Partilhar via