Operação

Artigo
08/05/2023

Representa o estado atual de uma operação com execução longa. Exemplos de operações com execução longa inclui iniciar, parar e excluir uma origem.

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

Propriedades de entidades de operação
Operações de consulta
Códigos de erro de operação

Importante

Ao acessar entidades nos serviços de mídia, você deve definir valores e campos de cabeçalho específicos nas suas solicitações HTTP.
Para obter mais informações, consulte Instalação para desenvolvimento de API REST dos Serviços de Mídia e Conexão aos Serviços de Mídia com a API REST dos Serviços de Mídia.

Propriedades de entidades de operação

`Property`	Type	Descrição
`Id` Somente leitura.	String	A ID da operação, atribuída pelos Serviços de Mídia na criação de uma operação. O formato é: `nb:opid:UUID:<GUID>`.
`ErrorCode` Somente leitura.	String	O código de erro da operação que falhou. Para obter informações sobre possíveis códigos de erro, consulte Códigos de erro de operação.
`ErrorMessage` Somente leitura.	String	A mensagem de erro detalhada da operação que falhou.
`State` Somente leitura.	String	O estado atual. Os valores possíveis incluem: - Êxito - Com falha - InProgress
`TargetEntityId` Somente leitura.	String	O ID do destino da ação.

Operadores de consulta

Consulta a operação especificada.

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

Solicitação de Exemplo

Para obter o mais recente x-ms-version:, consulte REST dos Serviços de Mídia.

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 a operação for bem-sucedida, um código de status 200 OK será emitido junto com a mensagem de status no corpo da resposta, como mostrado no exemplo a seguir.

Exemplo de Resposta

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 são listados aqui.

Código do Erro	Descrição
BadRequest	Enviado quando nenhum outro erro é aplicável ou o erro exato é desconhecido.
InsufficientCapacity	O data center não tem capacidade suficiente.
InternalError	Erros inesperados ocorridos no serviço.
InvalidIdentifierFormat	O formato de ID da entidade é inválido.
InvalidOperation	A solicitação é inválida no estado atual da entidade.
InvalidResourceName	O nome de Origem especificado é inválido.
OperationInProgress	Outra operação já está em andamento na entidade especificada.
OperationNotFound	O registro da operação não foi encontrado para a ID da operação especificada. A operação pode ter sido removida após um período de tempo ou a ID está errada.
ResourceNameTaken	Tentativa de criar uma nova Origem com um nome que já está em uso.
ResourceNotFound	O recurso especificado não foi encontrado.
ExceededResourceQuota	A solicitação excede o limite de cota de recursos.
Tempo limite	A operação assíncrona atingiu o tempo limite.
DeleteNotAllowedOnDefaultOrigin	Você tentou excluir a Origem padrão.
SettingsUpdateInProgress	Uma atualização já está em andamento.

Compartilhar via