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

Modules - Create Or Update Identity

在 IoT 中心为设备创建或更新模块标识。用户无法更新 moduleId 和 generationId。

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

URI 参数

名称	必需	类型	说明
If-Match		string	根据RFC7232表示模块的弱 ETag 的字符串。创建模块时不应设置此项，但在更新模块时可以设置。

名称	类型	说明
authentication	AuthenticationMechanism	连接到服务和边缘中心时模块使用的身份验证机制。
cloudToDeviceMessageCount	integer (int32)	当前排队等待发送到模块的云到模块消息的数量。
connectionState	enum: Disconnected Connected	设备的连接状态。
connectionStateUpdatedTime	string (date-time)	上次更新连接状态的日期和时间。
deviceId	string	设备的唯一标识符。
etag	string	根据RFC7232表示模块标识的弱 ETag 的字符串。
generationId	string	IoT 中心生成了长达 128 个字符的区分大小写的字符串。此值用于区分具有相同 moduleId 的模块，在删除并重新创建模块时。
lastActivityTime	string (date-time)	设备上次连接、接收或发送消息的日期和时间。
managedBy	string	标识管理此模块的人。例如，如果边缘运行时拥有此模块，则此值为“IotEdge”。
moduleId	string	模块的唯一标识符。

名称	类型	说明
200 OK	Module	还行。
201 Created	Module	创建。

Object

名称	类型	说明
symmetricKey	SymmetricKey	用于基于 SAS 的身份验证的主密钥和辅助密钥。
type	enum: certificateAuthority none sas selfSigned	用于连接到服务的身份验证类型。
x509Thumbprint	X509Thumbprint	用于基于 x509 的身份验证的主要和辅助 x509 指纹。

Object

设备上的模块标识。

名称	类型	说明
authentication	AuthenticationMechanism	连接到服务和边缘中心时模块使用的身份验证机制。
cloudToDeviceMessageCount	integer (int32)	当前排队等待发送到模块的云到模块消息的数量。
connectionState	enum: Connected Disconnected	设备的连接状态。
connectionStateUpdatedTime	string (date-time)	上次更新连接状态的日期和时间。
deviceId	string	设备的唯一标识符。
etag	string	根据RFC7232表示模块标识的弱 ETag 的字符串。
generationId	string	IoT 中心生成了长达 128 个字符的区分大小写的字符串。此值用于区分具有相同 moduleId 的模块，在删除并重新创建模块时。
lastActivityTime	string (date-time)	设备上次连接、接收或发送消息的日期和时间。
managedBy	string	标识管理此模块的人。例如，如果边缘运行时拥有此模块，则此值为“IotEdge”。
moduleId	string	模块的唯一标识符。

Object

名称	类型	说明
primaryKey	string	设备的 base64 编码主键。
secondaryKey	string	设备的 base64 编码辅助密钥。

Object

名称	类型	说明
primaryThumbprint	string	X509 客户端证书主指纹。
secondaryThumbprint	string	X509 客户端证书辅助指纹。