Retrieve Activation Parameters for a Device
/iot/api/v2/activation/policy
Request
-
OSName(optional): string
Name of the device OS
-
OSVersion(optional): string
Version information for the device OS
Response
- application/json
- application/vnd.oracle.resource+json;type=singular
200 Response
object
-
hashAlgorithm:
string
The message digest algorithm to be used with keyType to generate a digital signature (for example, sha256WithRSAEncryption, where sha256 is the hashAlgorithm)
-
keySize:
integer
The size of the key, in bits
-
keyType:
string
The algorithm used to generate keys (for example, RSA)
400 Response
401 Response
403 Response
406 Response
Examples
The following example shows how to view the activation parameters of Device with Activation ID 6e5e3e593bcf-1c79
for the operating system Windows 7 Version 6.1 by submitting a GET request on the REST resource using cURL. The authorization token is obtained by calling the Authentication API, where issuer is the device with Activation Id : 6e5e3e593bcf-1c79
and scope=oracle/iot/activation.
The format of the Cloud Service instance is https://
myinstance-myidentitydomain.iot.us.oraclecloud.com
and the default port is 443
.
For more information about cURL
, see Use cURL.rom
curl -H 'Accept: application/json' -H 'Authorization: Bearer 0a6eed78d32f0cd49c82586ba5f113f7' -H 'X-ActivationId: 6e5e3e593bcf-1c79' "http://iotserver/iot/api/v2/activation/policy?OSName=Windows+7&OSVersion=6.1"
Example of Response Header
The following shows an example of the response header when the request is successful.
HTTP/1.1 200 OK Content-Type: application/json
Example of Response Body
The following example shows the activation parameters for the requested operating system in JSON format.
{ "keyType":"RSA", "keySize":"2048", "hashAlgorithm":"SHA256withRSA" }