Oracle Cloud Infrastructureドキュメント

デジタル・ツイン・インスタンスからのRAWコマンドの送信

コマンドをデバイスに送信します。

送信するデータのタイプに応じて、次のCLIコマンドおよびAPI操作を使用して、RAW JSONコマンド、RAWプレーン・テキスト・コマンドまたはRAWバイナリ・コマンドをデバイスに送信します。

ノート

現在、MQTT Secure (MQTTS)はポート8883を使用してのみサポートされています。

詳細は、シナリオ: MQTTを使用したコマンドの受信およびレスポンスの送信を参照してください。

  • oci iot digital-twin-instance invoke-raw-<data-type>-commandコマンドおよび必須パラメータを使用して、デバイスでRAW JSON、バイナリまたはテキスト・コマンドを呼び出します。<digital-twin-instance-OCID>を環境のデジタル・ツイン・インスタンスOCIDに置き換えます。

    oci iot digital-twin-instance invoke-raw-json-commandコマンドを使用して、RAW JSONコマンドを起動します。使用する環境の値を置換します。

    oci iot digital-twin-instance invoke-raw-json-command \
  --digital-twin-instance-id <digital-twin-instance-OCID> \
  --request-endpoint /endpoints/<device-id> \
  --request-data '{"temp": 34}' \
  --request-data-content-type application/json \
  --request-duration PT10M \
  --response-duration PT10M \
  --response-endpoint /endpoints/<response-device-id>

    oci iot digital-twin-instance invoke-raw-binary-commandコマンドを使用して、RAWバイナリ・コマンドを起動します。環境のパラメータ値を置き換えます。

    oci iot digital-twin-instance invoke-raw-binary-command \
--digital-twin-instance-id <digital-twin-instance-OCID> \
--request-endpoint /endpoints/1234 \
--request-data file:///mnt/data/binary_input.bin \
--request-data-content-type application/octet-stream \
--request-duration PT10M 
--response-duration PT10M 
--response-endpoint /endpoints/4321

    oci iot digital-twin-instance invoke-raw-text-commandコマンドを使用して、RAWテキスト・コマンドを起動します。環境のパラメータ値を置き換えます。

    oci iot digital-twin-instance invoke-raw-text-command \
--digital-twin-instance-id <digital-twin-instance-OCID> \
--request-endpoint /endpoints/1234 \
--request-data 'command input as text' \
--request-data-content-type text/plain \
--request-duration PT10M \
--response-duration PT10M \
--response-endpoint /endpoints/4321

    CLIコマンドのパラメータおよび値の完全なリストは、CLIコマンド・リファレンスを参照してください。

  • InvokeRawCommand操作と必要なパラメータを実行して、rawコマンドをデバイスに送信します。次のデータ型がサポートされています。
    • JSON
    • バイナリ
    • テキスト

コマンド応答

シナリオデバイスの状態予想されるコマンド状態コメント
未接続未接続、未登録 拒否済 コマンドの配信がすぐに失敗する
接続済ですがサブスクライブされていません接続済 拒否済デバイスはオンラインですが、コマンドを受信しません
サブスクライブしましたが、接続されていません サブスクライブのみ保留中 → 失効コマンドは待機します。タイムアウト後に期限切れになります。
サブスクライブされていますが、最初に接続されておらず、タイムアウト前に接続されています 初期オフライン 保留中 → 送信済コマンドを受信しました
接続済およびサブスクライブ済接続済およびサブスクライブ済 送信 コマンドを受信しました
一方向コマンド(応答なし)接続済およびサブスクライブ済 COMPLETED 応答は予期されず、追跡されます
双方向コマンド(応答を受信しませんでした)接続済およびサブスクライブ済 NOT_RESPONDEDデバイスがレスポンス期間のタイムアウト内に応答しません
双方向コマンド(レスポンスを受信) 接続済およびサブスクライブ済 COMPLETEDデバイスはレスポンス・タイムアウト内にデータを送信し、フローを完了します