Devices - Replace Twin

  • リファレンス
Service:
IoT Hub
API Version:
2020-05-31-preview

デバイス ツインのタグと必要なプロパティを置き換えます。 詳細については、「 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-device-twins 」を参照してください。

PUT https://fully-qualified-iothubname.azure-devices.net/twins/{id}?api-version=2020-05-31-preview

URI パラメーター

名前 / 必須 型 説明
id
 path True

string

デバイスの一意識別子。
api-version
 query True

string

Api のバージョン。

要求ヘッダー

名前 必須 型 説明
If-Match

string

RFC7232に従って、デバイス ツインの弱い ETag を表す文字列。 置換操作を実行する必要があるかどうかを決定します。

要求本文

名前 型 説明
authenticationType enum:
  • sas
  • selfSigned
  • certificateAuthority
  • none

デバイスで使用される認証の種類。
capabilities

DeviceCapabilities

デバイスで有効になっている機能の状態。
cloudToDeviceMessageCount

integer

送信されたクラウドからデバイスへのメッセージの数。
connectionState enum:
  • Disconnected
  • Connected

デバイスの接続状態。
deviceEtag

string

RFC7232に従って、デバイスの ETag を表す文字列。
deviceId

string

IoT Hubの ID レジストリ内のデバイスの一意識別子。 ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字)、次の特殊文字 {'-'、':'、'.'、'%'、'_'、'_'、'#'、'*'、'?'、'!'、'('、')'、'、'='、'='、'@'、';'、'$'、'}} です。
deviceScope

string

デバイスのスコープ。
etag

string

RFC7232に従って、デバイス ツインの ETag を表す文字列。
lastActivityTime

string

デバイスが最後に接続またはメッセージを受信または送信した日時。 日付と時刻は、UTC ISO8601 datetime 形式で区切られます (例: 2015-01-28T16:24:48.789Z)。 デバイスが HTTP/1 プロトコルを使用してメッセージング操作を実行する場合、この値は更新されません。
moduleId

string

IoT Hubの ID レジストリ内のモジュールの一意識別子。 ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字)、次の特殊文字 {'-'、':'、'.'、'%'、'_'、'_'、'#'、'*'、'?'、'!'、'('、')'、'、'='、'='、'@'、';'、'$'、'}} です。
properties

TwinProperties

ツインの必要なプロパティと報告されたプロパティ。
status enum:
  • enabled
  • disabled

デバイスの有効な状態。 無効にした場合、デバイスはサービスに接続できません。
statusReason

string

デバイスの現在の状態の理由 (存在する場合)。
statusUpdateTime

string

デバイスの状態が最後に更新された日時。
tags

object

ソリューション バックエンドによって読み取られ、書き込まれたキーと値のペアのコレクション。 デバイス アプリには表示されません。 これらのキーは UTF-8 でエンコードされ、大文字と小文字が区別され、最大 1 KB の長さです。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 値は JSON オブジェクトで、最大 4 KB の長さです。
version

integer

タグと必要なプロパティを含むデバイス ツインのバージョン
x509Thumbprint

X509Thumbprint

デバイスの X509 拇印。

応答

名前 型 説明
200 OK

Twin

OK です。

定義

名前 説明
DeviceCapabilities

デバイスで有効になっている機能の状態。
Twin

デバイスまたはモジュールの状態情報。 これは、対応するデバイス/モジュール ID がIoT Hubで作成または削除されるときに暗黙的に作成および削除されます。
TwinProperties

ツインの必要なプロパティと報告されたプロパティ。 オブジェクトの最大深度は 10 です。
X509Thumbprint

DeviceCapabilities

デバイスで有効になっている機能の状態。

名前 型 説明
iotEdge

boolean

デバイスがエッジ デバイスかどうかを決定する プロパティ。

Twin

デバイスまたはモジュールの状態情報。 これは、対応するデバイス/モジュール ID がIoT Hubで作成または削除されるときに暗黙的に作成および削除されます。

名前 型 説明
authenticationType enum:
  • certificateAuthority
  • none
  • sas
  • selfSigned

デバイスで使用される認証の種類。
capabilities

DeviceCapabilities

デバイスで有効になっている機能の状態。
cloudToDeviceMessageCount

integer

送信されたクラウドからデバイスへのメッセージの数。
connectionState enum:
  • Connected
  • Disconnected

デバイスの接続状態。
deviceEtag

string

RFC7232に従って、デバイスの ETag を表す文字列。
deviceId

string

IoT Hubの ID レジストリ内のデバイスの一意識別子。 ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字)、次の特殊文字 {'-'、':'、'.'、'%'、'_'、'_'、'#'、'*'、'?'、'!'、'('、')'、'、'='、'='、'@'、';'、'$'、'}} です。
deviceScope

string

デバイスのスコープ。
etag

string

RFC7232に従って、デバイス ツインの ETag を表す文字列。
lastActivityTime

string

デバイスが最後に接続またはメッセージを受信または送信した日時。 日付と時刻は、UTC ISO8601 datetime 形式で区切られます (例: 2015-01-28T16:24:48.789Z)。 デバイスが HTTP/1 プロトコルを使用してメッセージング操作を実行する場合、この値は更新されません。
moduleId

string

IoT Hubの ID レジストリ内のモジュールの一意識別子。 ASCII 7 ビット英数字文字の大文字と小文字を区別する文字列 (最大 128 文字)、次の特殊文字 {'-'、':'、'.'、'%'、'_'、'_'、'#'、'*'、'?'、'!'、'('、')'、'、'='、'='、'@'、';'、'$'、'}} です。
properties

TwinProperties

ツインの必要なプロパティと報告されたプロパティ。
status enum:
  • disabled
  • enabled

デバイスの有効な状態。 無効にした場合、デバイスはサービスに接続できません。
statusReason

string

デバイスの現在の状態の理由 (存在する場合)。
statusUpdateTime

string

デバイスの状態が最後に更新された日時。
tags

object

ソリューション バックエンドによって読み取られ、書き込まれたキーと値のペアのコレクション。 デバイス アプリには表示されません。 これらのキーは UTF-8 でエンコードされ、大文字と小文字が区別され、最大 1 KB の長さです。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 値は JSON オブジェクトで、最大 4 KB の長さです。
version

integer

タグと必要なプロパティを含むデバイス ツインのバージョン
x509Thumbprint

X509Thumbprint

デバイスの X509 拇印。

TwinProperties

ツインの必要なプロパティと報告されたプロパティ。 オブジェクトの最大深度は 10 です。

名前 型 説明
desired

object

目的のプロパティ キーと値のペアのコレクション。 キーは UTF-8 でエンコードされ、大文字と小文字が区別され、最大 1 KB の長さです。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 必要な値は、最大 4 KB の長さの JSON オブジェクトです。
reported

object

報告されるプロパティのキーと値のペアのコレクション。 キーは UTF-8 でエンコードされ、大文字と小文字が区別され、最大 1 KB の長さです。 使用できる文字は、UNICODE 制御文字 (セグメント C0 および C1)、'.'、'$'、およびスペースを除外します。 報告されるプロパティ値は、最大 4 KB の長さの JSON オブジェクトです。

X509Thumbprint

名前 型 説明
primaryThumbprint

string

X509 クライアント証明書のプライマリ拇印。
secondaryThumbprint

string

X509 クライアント証明書のセカンダリ拇印。