Freigeben über

Vorgang

  • Artikel

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.

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.