Soracom Orbit writing to IoT SIM tags now supported
Soracom Orbit is a bi-directional inline data processing service that allows you to write your own AssemblyScript, Rust, C/C++, or TinyGo function for modifying IoT device data as it is sent from or to a device and Unified Endpoint.
Previously, Orbit allowed for reading IoT SIM tags when executing your function. This lets you incorporate tag values into your function logic, such as appending the IoT SIM name to the data, or applying different data processing logic based on the value of a device model, firmware, or other tag.
With this update, Orbit now also allows for writing and deleting IoT SIM tags. This new functionality enables new use cases, such as updating an IoT device's tags based on the data it sends. You can then utilize existing User Console and Soracom API features such as searching for and sorting SIMs based on a specific tag to streamline SIM and device management workflows.
The Orbit SDKs have been updated for this new functionality. Below is a summary of updates for each SDK:
AssemblyScript SDK
- Added
setTagValue(name: string, value: string): void
- Added
deleteTag(name: string): void
- Added
getOriginalRequest(): string
Rust SDK
- Added
set_tag_value(name: &str, value: &str)
- Added
delete_tag(name: &str)
- Added
get_original_request() -> String
C/C++ SDK
- Added
void soracom_set_tag_value(const char* name, const char* value)
- Added
void soracom_delete_tag(const char* name)
- Added
int32_t soracom_get_original_request_as_string(const char** buf, size_t* siz)
- Added
void soracom_release_buffer(const char* buf)
- Deprecated
void soracom_release_input_buffer(const char* buf)
(usesoracom_release_buffer()
instead) - Deprecated
void soracom_release_userdata(const char* buf)
(usesoracom_release_buffer()
instead)
TinyGo SDK
- Added
func SetTagValue(name string, value string)
- Added
func DeleteTag(name string)
- Added
func GetUserdata() ([]byte, error)
- Added
func GetOriginalRequest() ([]byte, error)
For additional details, refer to the Orbit: SDK Reference documentation.