Configuration - Create Or Update

Service:

IoT Hub

API Version:

2021-04-12

Otomatik cihaz/modül yönetimi için IoT Hub yapılandırma oluşturur veya güncelleştirir. Yapılandırma tanımlayıcısı ve İçerik güncelleştirilemiyor.

PUT https://fully-qualified-iothubname.azure-devices.net/configurations/{id}?api-version=2021-04-12

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
id	path	True	string	Yapılandırmanın benzersiz tanımlayıcısı.
api-version	query	True	string	Api sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
If-Match		string	RFC7232 göre yapılandırma için zayıf bir ETag'i temsil eden dize. Bu ayar yapılandırma oluşturulurken ayarlanmamalıdır, ancak bir yapılandırma güncelleştirilirken ayarlanabilir.

İstek Gövdesi

Name	Tür	Description
content	ConfigurationContent	Yapılandırmanın içeriği.
createdTimeUtc	string	Yapılandırma oluşturma tarihi ve saati.
etag	string	Yapılandırmanın ETag'i.
id	string	Yapılandırmanın benzersiz tanımlayıcısı.
labels	object	Yapılandırmayı açıklamak için kullanılan anahtar-değer çiftleri.
lastUpdatedTimeUtc	string	Yapılandırmanın güncelleştirme tarihi ve saati.
metrics	ConfigurationMetrics	Geliştirici tarafından ikiz tarafından bildirilen özelliklere yönelik sorgular olarak belirtilen özel ölçümler.
priority	integer	Yapılandırmaya atanan öncelik numarası.
schemaVersion	string	Yapılandırmanın şema sürümü.
systemMetrics	ConfigurationMetrics	özelleştirilemeyen IoT Hub tarafından hesaplanan sistem ölçümleri.
targetCondition	string	Hedeflenen cihazları veya modülleri tanımlamak için kullanılan sorgu. Sorgu, ikiz etiketlerini ve/veya bildirilen özellikleri temel alır.

Yanıtlar

Name	Tür	Description
200 OK	Configuration	Tamam ögesini seçin.
201 Created	Configuration	Oluşturulan.

Tanımlar

Name	Description
Configuration	IoT Hub cihazı ve modül ikizleri için yapılandırma.
ConfigurationContent	Uç cihazlardaki cihazlar veya modüller için yapılandırma içeriği.
ConfigurationMetrics	Iot Hub cihazları ve modülleri için yapılandırma ölçümleri.

Configuration

IoT Hub cihazı ve modül ikizleri için yapılandırma.

Name	Tür	Description
content	ConfigurationContent	Yapılandırmanın içeriği.
createdTimeUtc	string	Yapılandırma oluşturma tarihi ve saati.
etag	string	Yapılandırmanın ETag'i.
id	string	Yapılandırmanın benzersiz tanımlayıcısı.
labels	object	Yapılandırmayı açıklamak için kullanılan anahtar-değer çiftleri.
lastUpdatedTimeUtc	string	Yapılandırmanın güncelleştirme tarihi ve saati.
metrics	ConfigurationMetrics	Geliştirici tarafından ikiz tarafından bildirilen özelliklere yönelik sorgular olarak belirtilen özel ölçümler.
priority	integer	Yapılandırmaya atanan öncelik numarası.
schemaVersion	string	Yapılandırmanın şema sürümü.
systemMetrics	ConfigurationMetrics	özelleştirilemeyen IoT Hub tarafından hesaplanan sistem ölçümleri.
targetCondition	string	Hedeflenen cihazları veya modülleri tanımlamak için kullanılan sorgu. Sorgu, ikiz etiketlerini ve/veya bildirilen özellikleri temel alır.

ConfigurationContent

Uç cihazlardaki cihazlar veya modüller için yapılandırma içeriği.

Name	Tür	Description
deviceContent	object	Cihaz yapılandırma içeriği.
moduleContent	object	Modül yapılandırma içeriği.
modulesContent	object	Modül yapılandırma içeriği.

ConfigurationMetrics

Iot Hub cihazları ve modülleri için yapılandırma ölçümleri.

Name	Tür	Description
queries	object	Anahtar-değer, sorgular ve tanımlayıcılarıyla eşler.
results	object	Ölçüm koleksiyonu sorgularının sonuçları.