Vorgang

Artikel
08/05/2023

Stellt den aktuellen Status eines langen Vorgangs dar. Zu den Beispielen langer Vorgänge gehören das Starten, Stoppen und Löschen eines Ursprungs.

Dieses Thema enthält eine Übersicht über die Entität Operation. Darüber hinaus wird gezeigt, wie unterschiedliche Vorgänge mit der Media Services REST-API ausgeführt werden.

Vorgangsentitätseigenschaften
Abfragevorgänge
Vorgangsfehlercodes

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

Vorgangsentitätseigenschaften

`Property`	type	BESCHREIBUNG
`Id` Schreibgeschützt.	String	Die Vorgangs-ID, die von Media Services bei der Erstellung eines Vorgangs zugewiesen wird. Das Format lautet: `nb:opid:UUID:<GUID>`.
`ErrorCode` Schreibgeschützt.	String	Der Fehlercode eines Vorgangsfehlers. Informationen zu möglichen Fehlercodes finden Sie unter Vorgangsfehlercodes.
`ErrorMessage` Schreibgeschützt.	String	Die detaillierte Fehlermeldung eines Vorgangsfehlers.
`State` Schreibgeschützt.	String	Der aktuelle Status. Mögliche Werte sind: - Erfolgreich - Fehler - InProgress
`TargetEntityId` Schreibgeschützt.	String	Die ID des Ziels der Aktion.

Abfragevorgänge

Ruft den angegebenen Vorgang ab.

Methode	Anforderungs-URI	HTTP-Version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services 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

Bei Erfolg wird der Statuscode 200 OK mit einer Statusnachricht im Antworttext wie im folgenden Beispiel gezeigt zurückgegeben.

Beispiel für eine Antwort

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}

Vorgangsfehlercodes

Die Vorgangsfehlercodes werden hier aufgeführt.

Fehlercode	BESCHREIBUNG
BadRequest	Wird gesendet, wenn kein anderer Fehler zutrifft oder der genaue Fehler nicht bekannt ist.
InsufficientCapacity	Der Data Center hat nicht genügend Kapazität.
InternalError	Unerwartete Fehler vom Dienst sind aufgetreten.
InvalidIdentifierFormat	Das Format der Entitäts-ID ist ungültig.
InvalidOperation	Die Anforderung ist beim aktuellen Status der Entität ungültig.
InvalidResourceName	Der angegebene Ursprungsname ist ungültig.
OperationInProgress	Ein anderer Vorgang ist auf der angegebenen Entität bereits in Bearbeitung.
OperationNotFound	Der Vorgangsdatensatz wurde für die angegebene Vorgangs-ID nicht gefunden. Der Vorgang wurde möglicherweise nach einer Zeitspanne entfernt, oder die ID ist falsch.
ResourceNameTaken	Versuch, einen neuen Ursprung mit einem Namen zu erstellen, der bereits verwendet wird.
ResourceNotFound	Die angegebene Ressource wurde nicht gefunden.
ExceededResourceQuota	Die Anforderung überschreitet die Kontingentgrenze der Ressource.
Timeout	Timeout beim asynchronen Vorgang.
DeleteNotAllowedOnDefaultOrigin	Sie haben versucht, den Standardursprung zu löschen.
SettingsUpdateInProgress	Eine Aktualisierung ist bereits in Bearbeitung.

Freigeben über