1. REST API for Oracle Internet of Things Cloud Service
  2. Tasks
  3. IoT Device Resource

Retrieve a Metadata Key for the Device with Specified ID

get

/iot/api/v2/devices/{entity-id}/metadata/{key}

Retrieve metadata key device with id

Request

Path Parameters
Back to Top

Response

Supported Media Types

200 Response

Successfully processed.
Body ()
Root Schema : SerializableMetadataKey_receive
Type: object
Show Source

401 Response

Unauthorized. The request requires user authentication.

404 Response

Not Found. The server has not found anything matching the Request-URI. No indication is given of whether the condition is temporary or permanent.

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.
Back to Top

Examples

curl -X GET 
   -u <username>:<password> 
   http://iotserver/iot/api/v2/devices/{entity-id}/metadata/{key}

Example of Response Body

The following example shows the content of the response body in JSON format 


{
    "links":[
        {
            "rel":"self",
            "href":"http://iotserver/iot/api/version/resource/path"
        },
        {
            "rel":"canonical",
            "href":"http://iotserver/iot/api/version/resource/path"
        }
    ]
}



Complete cURL Example

The following example shows compete cURL comand that can be used to perform described operation

curl -X GET 
   -u <username>:<password> 
   http://iotserver/iot/api/v2/devices/7279301250a-3c03/metadata/key-name



Note that in the request, http://iotserver will be replaced by the name and port of your assigned IoT Cloud Service instance. The format of the Cloud Service instance is https:// myinstance-myidentitydomain.iot.us.oraclecloud.com and the default port is 443.
Back to Top