你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Configuration - Get Configurations

Gets configurations on the IoT Hub for automatic device/module management. Pagination is not supported.

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

URI Parameters

Name In Required Type Description
api-version
query True

string

Version of the Api.

top
query

integer

int32

The number of configurations to retrieve. Value will be overridden if greater than the maximum deployment count for the IoT Hub.

Responses

Name Type Description
200 OK

Configuration[]

OK.

Definitions

Name Description
Configuration

The configuration for Iot Hub device and module twins.

ConfigurationContent

The configuration content for devices or modules on edge devices.

ConfigurationMetrics

The configuration metrics for Iot Hub devices and modules.

Configuration

The configuration for Iot Hub device and module twins.

Name Type Description
content

ConfigurationContent

The content of the configuration.

createdTimeUtc

string

The creation date and time of the configuration.

etag

string

The ETag of the configuration.

id

string

The unique identifier of the configuration.

labels

object

The key-value pairs used to describe the configuration.

lastUpdatedTimeUtc

string

The update date and time of the configuration.

metrics

ConfigurationMetrics

The custom metrics specified by the developer as queries against twin reported properties.

priority

integer

The priority number assigned to the configuration.

schemaVersion

string

The schema version of the configuration.

systemMetrics

ConfigurationMetrics

The system metrics computed by the IoT Hub that cannot be customized.

targetCondition

string

The query used to define the targeted devices or modules. The query is based on twin tags and/or reported properties.

ConfigurationContent

The configuration content for devices or modules on edge devices.

Name Type Description
deviceContent

object

The device configuration content.

moduleContent

object

The module configuration content.

modulesContent

object

The modules configuration content.

ConfigurationMetrics

The configuration metrics for Iot Hub devices and modules.

Name Type Description
queries

object

The key-value pairs with queries and their identifier.

results

object

The results of the metrics collection queries.