Updates - Get Update

Service:

Device Update

API Version:

2020-09-01

Belirli bir güncelleştirme sürümünü alın.

GET https://{accountEndpoint}/deviceupdate/{instanceId}/v2/updates/providers/{provider}/names/{name}/versions/{version}

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ı.
name	path	True	string	Adı güncelleştirin.
provider	path	True	string	Sağlayıcıyı güncelleştirin.
version	path	True	string	Sürümü güncelleştirin.

İ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	Update	İstenen güncelleştirme sürümü.
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_GetUpdate

Sample Request

HTTP

GET https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/updates/providers/microsoft/names/adu/versions/1.0.0.0

Sample Response

Status code:

200

{
  "updateId": {
    "provider": "microsoft",
    "name": "adu",
    "version": "1.0.0.0"
  },
  "updateType": "image",
  "installedCriteria": "SwVer=5",
  "compatibility": [
    {
      "deviceManufacturer": "Microsoft",
      "deviceModel": "Toaster"
    }
  ],
  "manifestVersion": "0.1",
  "importedDateTime": "2020-04-22T21:01:43.8408797+00:00",
  "createdDateTime": "2019-09-12T00:00:00.0000000+00:00",
  "etag": "\"3fed3378-0c67-47d2-b796-296962c66cbb\""
}

Status code:

304

Status code:

404

Status code:

429

Tanımlar

Name	Description
Compatibility	Uyumluluk bilgilerini güncelleştirin.
Update	Meta verileri güncelleştirin.
UpdateId	Tanımlayıcıyı güncelleştirin.

Compatibility

Uyumluluk bilgilerini güncelleştirin.

Name	Tür	Description
deviceManufacturer	string	Güncelleştirmenin uyumlu olduğu cihaz üreticisi.
deviceModel	string	Güncelleştirmenin uyumlu olduğu cihazın modeli.

Update

Meta verileri güncelleştirin.

Name	Tür	Description
compatibility	Compatibility[]	Güncelleştirme uyumluluğu bilgilerinin listesi.
createdDateTime	string	Güncelleştirmenin oluşturulduğu UTC tarihi ve saati.
etag	string	ETag'i güncelleştirin.
importedDateTime	string	Güncelleştirmenin içeri aktarıldığı UTC tarihi ve saati.
installedCriteria	string	Güncelleştirmenin cihazda yüklü olup olmadığını belirlemek için Cihaz Güncelleştirmesi istemcisi tarafından yorumlanan dize.
manifestVersion	string	Güncelleştirmeyi içeri aktarmak için kullanılan bildirimin şema sürümü.
updateId	UpdateId	Kimliği güncelleştirin.
updateType	string	Güncelleştirme türü.

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.