İşlem

Uzun süre çalışan bir işlemin geçerli durumunu temsil eder. Uzun süre çalışan işlemlere örnek olarak Bir Kaynağı başlatma, durdurma ve silme verilebilir.

Bu konu, varlığa genel bir bakış Operation sağlar ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'e Bağlanma.

İşlem Varlığı Özellikleri

Property Tür Description
Id

Salt okunur.
Dize Media Services tarafından bir işlem oluşturulurken atanan işlem kimliği. Biçim:

nb:opid:UUID:<GUID>.
ErrorCode

Salt okunur.
Dize Başarısız işlemin hata kodu. Olası hata kodları hakkında bilgi için bkz . İşlem Hata Kodları.
ErrorMessage

Salt okunur.
Dize Başarısız işlemin ayrıntılı hata iletisi.
State

Salt okunur.
Dize Geçerli durum. Olası değerler şunlardır:

- Başarılı oldu
- Başarısız oldu
- Devam Ediyor
TargetEntityId

Salt okunur.
Dize Eylemin hedefinin kimliği.

Sorgu İşlemleri

Belirtilen işlemi sorgular.

Yöntem İstek URI'si HTTP sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId') HTTP/1.1

Örnek İstek

En son x-ms-version:sürümü edinmek için bkz. 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  
  

Başarılı olursa, aşağıdaki örnekte gösterildiği gibi yanıt gövdesinde bir durum iletisiyle birlikte 200 Tamam durum kodu döndürülür.

Örnek Yanıt

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}  

İşlem Hata Kodları

İşlem hata kodları burada listelenmiştir.

Hata Kodu Description
BadRequest Başka bir hata geçerli olmadığında veya tam olarak bilinmeyen bir hata olduğunda gönderilir.
InsufficientCapacity Veri merkezinin kapasitesi yetersiz.
InternalError Hizmetten beklenmeyen hatalar oluştu.
InvalidIdentifierFormat Varlık kimliği biçimi geçersiz.
InvalidOperation İstek, varlığın geçerli durumunda geçersiz.
InvalidResourceName Belirtilen Kaynak adı geçersiz.
OperationInProgress Belirtilen varlıkta başka bir işlem zaten devam ediyor.
OperationNotFound Belirtilen işlem kimliği için işlem kaydı bulunamadı. İşlem bir zaman aralığından sonra kaldırılmış olabilir veya kimlik yanlıştır.
ResourceNameTaken Zaten kullanımda olan bir adla yeni bir Kaynak oluşturulmaya çalışılıyor.
ResourceNotFound Belirtilen kaynak bulunamadı.
ExceededResourceQuota İstek, kaynak kota sınırını aşıyor.
Zaman aşımı Zaman uyumsuz işlem zaman aşımına uğradı.
DeleteNotAllowedOnDefaultOrigin Varsayılan Kaynak'ı silmeyi denediniz.
AyarlarGüncelleştirmeInProgress Bir güncelleştirme zaten devam ediyor.