Enable Roaming
This API enables or disables voice and data roaming on an iOS 5 device. However, note the following:
- Voice roaming is available only on certain carriers. If you use this API to enable voice roaming on a device, the API returns success regardless of whether voice roaming is available on that device’s carrier.
- If you disable voice roaming, you are also disabling data roaming, even if you specify true (enable) for the data roaming query parameter.
- The API returns success regardless of whether the device supports the setting. To see whether a device has data or voice roaming enabled, see the Voice Roaming Enabled and DataRoamingEnabled fields in the response to a Get Device API. See iOS Details Key-Value Descriptions.
Example:
https://<Ivanti EPMM>/api/v1/dm/devices/enableroaming/ee8198d9-5d79-4961-94c4-e21bf04b2467?voice=true&data=false
URI: https:///api/v1/dm/devices/enableroaming/ | The specified deviceuuid indicates the device on which to change roaming settings. |
|---|---|
Http Method: | PUT |
Format: | xml, json |
Request: | |
deviceuuid | Required. Unique ID of the iOS device. This ID can be retrieved in the response of other API calls, such as Get Devices by Status. |
voice | Required. This parameter is a query parameter. Set to true to enable voice roaming. Set to false to disable voice roaming. |
data | Required. This parameter is a query parameter. Set to true to enable data roaming. Set to false to disable data roaming. If you set the voice parameter to false, data roaming is disabled even if you set the data parameter to true. |
Response Status Code: | |
‘404 – No Data Found’ | There is no data. |
‘200 – OK’ | Data is present and the response is returned. |
Response: | |
<deviceManagementWebServiceResponse> | |
<deviceUuid> 190eb32e-32e1-4fe2-baa1-06a4488aaa4c </deviceUuid> | |
<messages> | |
<message> Device voice roaming settings updated successfully. The voice roaming setting is available only on certain carriers. Disabling voice roaming also disables data roaming. </message> | Status message for voice roaming. Success is shown if the method execution is successful. A descriptive error message is shown if the method execution failed. |
<message> Device data roaming settings updated successfully. </message> | Status message for data roaming. Success is shown if the method execution is successful. A descriptive error message is shown if the method execution failed. |
</messages> | |
< /deviceManagementWebServiceResponse> | |
| |
