Sending a Raw Command from a Digital Twin Instance

Send a raw command to a device.

Depending on the type of data you want to send, use the following CLI commands and API operation to send a raw JSON command, a raw plain text command, or a raw binary command to a device.

  • Use the oci iot digital-twin-instance invoke-raw-<data-type>-command command and required parameters to invoke a raw JSON, binary, or text command on a device. Replace the <digital-twin-instance-OCID> with the digital twin instance OCID for your environment:

    Example to invoke a raw JSON command:

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

    Example to invoke a raw binary command:

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

    Example to invoke a raw text command:

    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

    For a complete list of parameters and values for CLI commands, see CLI Command Reference.

  • Run the InvokeRawCommand operation and the required parameter to send a raw command to a device. The following data types are supported:
    • JSON
    • binary
    • text