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