Retrieve device-to-device mode of a service profile
Retrieves the device-to-device (D2D) mode of a service profile. D2D controls whether devices assigned to the service profile can exchange IP traffic with other devices in the same organization and region.
A service profile that has never been configured returns disabled with modified_at set to null.
Device-to-device is opt-in and enabled per organization.
Until it’s enabled for your organization, requests return 403.
To request access, contact emnify support.
Authentication
An auth_token should be provided to authenticate a session.
To obtain an auth_token, see the /api/v1/authenticate POST request.
Path parameters
Query parameters
Numeric ID of a child organization to act on.
Omit to use your own organization.
Returns 403 if the organization isn’t a child of yours.
The service profile must belong to that organization, and device-to-device must be enabled for it.
Response
Device-to-device mode of the service profile:
disabled(default): Traffic between devices is dropped.enabled: Traffic is delivered directly between devices, as long as the service profiles of both devices have device-to-device enabled.forward_to_backend: Traffic between devices is routed through your Cloud Connect backend, for example so your own firewall can inspect it.
When the mode was last changed.
null if device-to-device has never been configured on the service profile.
Advisory messages about the configuration.
Only present in PUT responses, and only when there’s something to report, for example after setting forward_to_backend.