Updates - Get Operation

Service:

Device Update

API Version:

2020-09-01

İşlem durumunu alma.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/operations/{operationId}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountEndpoint	path	True	string	Hesap uç noktası.
instanceId	path	True	string	Hesap örneği tanımlayıcısı.
operationId	path	True	string	İşlem tanımlayıcısı.

İstek Başlığı

Name	Gerekli	Tür	Description
If-None-Match		string	If-None-Match koşulunu tanımlar. İşlem yalnızca sunucudaki ETag bu değerle eşleşmiyorsa gerçekleştirilir.

Yanıtlar

Name	Tür	Description
200 OK	Operation	İşlem durumu. Headers Retry-After: string
404 Not Found		Bulunamadı.
429 Too Many Requests		Çok fazla istek var; bir süre içinde kaç işlemin yürütülebileceğine ilişkin bir hız sınırı vardır.
Other Status Codes		Değiştirilmedi.

Güvenlik

azure_auth_implicit

Azure Active Directory OAuth2 Örtük Akışı

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

azure_auth_code

Azure Active Directory OAuth2 AccessCode Akışı

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

azure_auth_application

Azure Active Directory OAuth2 Uygulama Akışı

Type: oauth2
Flow: application
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

Name	Description
.default	istemci kimlik bilgisi kapsamı

azure_auth_password

Azure Active Directory OAuth2 Parola Akışı

Type: oauth2
Flow: password
Token URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Scopes

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Updates_GetOperation

Sample Request

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/operations/e4491c54-916f-443d-9094-bcca546ace2f

Sample Response

Status code:

200

{
  "operationId": "e4491c54-916f-443d-9094-bcca546ace2f",
  "status": "Succeeded",
  "resourceLocation": "/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0",
  "traceId": "2b881ef9deaf5d45b0a716ca5b4145ec",
  "createdDateTime": "2020-04-22T21:00:53.2548897+00:00",
  "lastActionDateTime": "2020-04-22T21:01:43.9401420+00:00",
  "etag": "\"a0f7b6f2-3f6c-4eb6-8a59-2f5411c23888\""
}

Status code:

304

Status code:

404

Status code:

429

Tanımlar

Name	Description
Error	Hata ayrıntıları.
InnerError	Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.
Operation	İşlem meta verileri.
OperationStatus	İşlem durumu.
UpdateId	Tanımlayıcıyı güncelleştirin.

Error

Hata ayrıntıları.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodu.
details	Error[]	Bildirilen hataya yol açan bir hata dizisi.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilen bir gösterimi.
occurredDateTime	string	Hatanın oluştuğu tarih ve utc saati.
target	string	Hatanın hedefi.

InnerError

Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.

Name	Tür	Description
code	string	İçeren hata tarafından sağlanandan daha özel bir hata kodu.
errorDetail	string	İç hata veya özel durum iletisi.
innerError	InnerError	Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilen bir gösterimi.

Operation

İşlem meta verileri.

Name	Tür	Description
createdDateTime	string	İşlemin oluşturulduğu tarih ve utc saati.
error	Error	Varsa işlem hatasıyla karşılaşıldı.
etag	string	İşlem ETag.
lastActionDateTime	string	İşlem durumunun son güncelleştirildiği UTC tarihi ve saati.
operationId	string	İşlem Kimliği.
resourceLocation	string	İşlem başarılı olduğunda içeri aktarılan güncelleştirmenin konumu.
status	OperationStatus	İşlem durumu.
traceId	string	sorun giderme için Microsoft Desteği tarafından kullanılabilen işlem bağıntı kimliği.
updateId	UpdateId	İçeri aktarılan veya silinen güncelleştirmenin kimliği. İçeri aktarma için, bu özellik yalnızca içeri aktarma bildirimi başarıyla işlendikten sonra doldurulur.

OperationStatus

İşlem durumu.

Name	Tür	Description
Failed	string	Arka plan işlemi hatayla tamamlandı.
NotStarted	string	Arka plan işlemi oluşturuldu ancak henüz başlatılmadı.
Running	string	Arka plan işlemi şu anda çalışıyor.
Succeeded	string	Arka plan işlemi başarıyla tamamlandı.
Undefined	string	Tanımsız işlem durumu.

UpdateId

Tanımlayıcıyı güncelleştirin.

Name	Tür	Description
name	string	Adı güncelleştirin.
provider	string	Sağlayıcıyı güncelleştirin.
version	string	Sürümü güncelleştirin.