Opération

Article
07/19/2023

Représente l'état actuel d'une opération de longue durée. Les exemples d'opérations de longue durée incluent le démarrage, l'arrêt et la suppression d'une entité Origin.

Cette rubrique offre une vue d'ensemble de l'entité Operation, et montre comment exécuter diverses opérations avec l'API REST Media Services.

Propriétés de l’entité d’opération
Opérations de requête
Codes d'erreur de l'opération

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement de l’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés de l'entité Operation

`Property`	Type	Description
`Id` Lecture seule.	String	ID d’opération, attribué par Media Services lors de la création d’une opération. Le format est le suivant : `nb:opid:UUID:<GUID>`.
`ErrorCode` Lecture seule.	String	Le code d'erreur de l'opération ayant échoué. Pour plus d’informations sur les codes d’erreur possibles, consultez Codes d’erreur d’opération.
`ErrorMessage` Lecture seule.	String	Le message d'erreur détaillé de l'opération ayant échoué.
`State` Lecture seule.	String	État actuel. Les valeurs possibles incluent : - Succeeded Échec - InProgress
`TargetEntityId` Lecture seule.	String	ID de la cible de l'action.

Opérations de requête

Interroge l'opération spécifiée.

Méthode	URI de demande	Version HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Exemple de demande

Pour obtenir la dernière version x-ms-version:, consultez REST 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 cas de succès, le code d'état 200 OK est renvoyé avec un message d'état dans le corps de la réponse, comme indiqué dans l'exemple suivant.

Exemple de réponse

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}

Codes d'erreur de l'opération

Les codes d'erreur de l'opération sont répertoriés ici.

Code d'erreur	Description
BadRequest	Envoyé quand aucune autre erreur n'est applicable ou quand l'erreur exacte est inconnue.
InsufficientCapacity	La capacité du centre de données est insuffisante.
InternalError	Des erreurs inattendues se sont produites à partir du service.
InvalidIdentifierFormat	Le format d'ID de l'entité n'est pas valide.
InvalidOperation	La demande n'est pas valide en l'état actuel de l'entité.
InvalidResourceName	Le nom Origin spécifié n'est pas valide.
OperationInProgress	Une autre opération est déjà en cours sur l'entité spécifiée.
OperationNotFound	L’enregistrement d’opération est introuvable pour l’ID d’opération spécifié. L’opération a peut-être été supprimée après un intervalle de temps, ou l’ID est incorrect.
ResourceNameTaken	Tentative de création d'une nouvelle entité Origin avec un nom déjà utilisé.
ResourceNotFound	La ressource spécifiée est introuvable.
ExceededResourceQuota	La demande dépasse la limite du quota des ressources.
Délai d'expiration	L'opération asynchrone a expiré.
DeleteNotAllowedOnDefaultOrigin	Vous avez essayé de supprimer l'entité Origin par défaut.
SettingsUpdateInProgress	Une mise à jour est déjà en cours.

Partager via