Update Device Location with New Values
post
/iot/api/v2/devices/{device-id}/location
Updates specified portion of the device location information. Resulting location must include at least the following fields: latitude, longitude
Request
Supported Media Types
- application/json
Path Parameters
-
device-id: string
ID of device to be retrieved from Cloud Service
Header Parameters
-
X-HTTP-Method-Override: string
To perform a partial update of the device location, POST request should be orchestrated with method override set to PATCH
Root Schema : LocationImpl_update
Type:
Show Source
object
-
altitude(optional):
integer
Property description was not set
-
empty(optional):
boolean
Property description was not set
-
geoLocationString(optional):
string
Property description was not set
-
latitude:
integer
Property description was not set
-
latLonString(optional):
string
Property description was not set
-
longitude:
integer
Property description was not set
-
origin(optional):
string
One of [ASSIGNED, REPORTED, DERIVED].
-
uncertainty(optional):
integer
Property description was not set
Response
Supported Media Types
- application/json
- application/vnd.oracle.resource+json;type=singular
200 Response
Successfully processed.
Root Schema : LocationImpl_receive
Type:
Show Source
object
-
altitude:
integer
Property description was not set
-
lastModified:
integer
Property description was not set
-
lastModifiedAsDate:
integer
Property description was not set
-
latitude:
integer
Property description was not set
-
longitude:
integer
Property description was not set
-
uncertainty:
integer
Property description was not set
405 Response
Method Not Allowed. The method specified in the Request-Line is not allowed for the resource identified by the Request-URI.
406 Response
Request Not Acceptable. The resource identified by the request is only capable of generating response entities which have content characteristics not acceptable according to the accept headers sent in the request.
415 Response
Unsupported Media Type. The request entity has a media type which the server or resource does not support.