Operace
Představuje aktuální stav dlouhotrvající operace. Mezi příklady dlouhotrvajících operací patří spuštění, zastavení a odstranění zdroje.
Toto téma poskytuje přehled Operation
entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.
Důležité
Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.
Vlastnosti entity operace
Property |
Typ | Description |
---|---|---|
Id Jen pro čtení. |
Řetězec | ID operace přiřazené službou Media Services při vytvoření operace. Formát je:nb:opid:UUID:<GUID> . |
ErrorCode Jen pro čtení. |
Řetězec | Kód chyby neúspěšné operace. Informace o možných kódech chyb najdete v tématu Kódy chyb operací. |
ErrorMessage Jen pro čtení. |
Řetězec | Podrobná chybová zpráva neúspěšné operace. |
State Jen pro čtení. |
Řetězec | Aktuální stav. Mezi možné hodnoty patří: - Úspěch - Neúspěch - Probíhá zpracování |
TargetEntityId Jen pro čtení. |
Řetězec | ID cíle akce. |
Operace dotazů
Dotazuje se na zadanou operaci.
Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
---|---|---|
GET | <https:// název_účtu.restv2>.<location.media.azure.net/api/Operations>('OperationId') | HTTP/1.1 |
Ukázkový požadavek
Nejnovější verzi najdete v x-ms-version:
tématu 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
V případě úspěchu se v textu odpovědi vrátí stavový kód 200 OK spolu se stavovou zprávou, jak je znázorněno v následujícím příkladu.
Ukázková odpověď
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}
Kódy chyb operací
Tady jsou uvedené kódy chyb operací.
Kód chyby | Description |
---|---|
BadRequest | Odesláno, pokud není k dispozici žádná jiná chyba nebo je přesná chyba neznámá. |
Nedostatečná kapacita | Datové centrum nemá dostatečnou kapacitu. |
InternalError | Ve službě došlo k neočekávaným chybám. |
InvalidIdentifierFormat | Formát ID entity je neplatný. |
Neplatná operace | Požadavek je v aktuálním stavu entity neplatný. |
Neplatný název zdroje | Zadaný název původu je neplatný. |
OperaceInProgress | U zadané entity již probíhá jiná operace. |
Operace Nenalezeno | Pro zadané ID operace nebyl nalezen záznam operace. Operace se možná po uplynutí časového intervalu odebrala nebo je id nesprávné. |
ResourceNameTaken | Pokus o vytvoření nového zdroje s názvem, který se už používá. |
ResourceNotFound | Zadaný prostředek nebyl nalezen. |
ExceededResourceQuota | Požadavek překračuje maximální kvótu prostředků. |
Časový limit | Vypršel časový limit asynchronní operace. |
DeleteNotAllowedOnDefaultOrigin | Pokusili jste se odstranit výchozí origin. |
NastaveníUpdateInProgress | Aktualizace už probíhá. |