Udostępnij za pośrednictwem

Operacja

  • Artykuł

Reprezentuje bieżący stan długotrwałej operacji. Przykłady długotrwałych operacji obejmują uruchamianie, zatrzymywanie i usuwanie źródła.

Ten temat zawiera omówienie Operation jednostki, a także pokazuje, jak wykonywać różne operacje za pomocą interfejsu API REST usługi Media Services.

Ważne

Podczas uzyskiwania dostępu do jednostek w usłudze Media Services należy ustawić określone pola nagłówka i wartości w żądaniach HTTP.
Aby uzyskać więcej informacji, zobacz Konfigurowanie tworzenia interfejsu API REST usługi Media Services i nawiązywanie połączenia z usługą Media Services przy użyciu interfejsu API REST usługi Media Services.

Właściwości jednostki operacji

Property Typ Opis
Id

Tylko do odczytu.		 Ciąg Identyfikator operacji przypisany przez usługę Media Services podczas tworzenia operacji. Format to:

nb:opid:UUID:<GUID>.
ErrorCode

Tylko do odczytu.		 Ciąg Kod błędu operacji, która zakończyła się niepowodzeniem. Aby uzyskać informacje na temat możliwych kodów błędów, zobacz Kody błędów operacji.
ErrorMessage

Tylko do odczytu.		 Ciąg Szczegółowy komunikat o błędzie operacji, który zakończył się niepowodzeniem.
State

Tylko do odczytu.		 Ciąg Bieżący stan. Możliwe wartości to:

— Powiodło się
— Nie powiodło się
— W toku
TargetEntityId

Tylko do odczytu.		 Ciąg Identyfikator elementu docelowego akcji.

Operacje zapytań

Wykonuje zapytania o określoną operację.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId') HTTP/1.1

Przykładowe żądanie

Aby uzyskać najnowszą wersję x-ms-version:, zobacz 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

W przypadku powodzenia kod stanu 200 OK jest zwracany wraz z komunikatem o stanie w treści odpowiedzi, jak pokazano w poniższym przykładzie.

Przykładowa odpowiedź

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}

Kody błędów operacji

Kody błędów operacji są wymienione tutaj.

Kod błędu Opis
BadRequest Wysłane, gdy nie ma zastosowania żaden inny błąd lub dokładny błąd jest nieznany.
Niewystarczającecapacity Centrum danych ma niewystarczającą pojemność.
InternalError Wystąpiły nieoczekiwane błędy z usługi.
InvalidIdentifierFormat Format identyfikatora jednostki jest nieprawidłowy.
InvalidOperation Żądanie jest nieprawidłowe w bieżącym stanie jednostki.
InvalidResourceName Określona nazwa źródła jest nieprawidłowa.
OperationInProgress Inna operacja jest już w toku w określonej jednostce.
OperationNotFound Rekord operacji nie został znaleziony dla określonego identyfikatora operacji. Operacja mogła zostać usunięta po upływie czasu lub identyfikator jest nieprawidłowy.
ResourceNameTaken Próbuje utworzyć nowe źródło o nazwie, która jest już używana.
ResourceNotFound Nie można odnaleźć określonego zasobu.
ExceededResourceQuota Żądanie przekracza limit przydziału zasobów.
Limit czasu Upłynął limit czasu operacji asynchronicznej.
DeleteNotAllowedOnDefaultOrigin Próbowano usunąć domyślne źródło.
SettingsUpdateInProgress Aktualizacja jest już w toku.