Retrieve provisioning files for vehicle sensors by activation IDs
post
/fleetMonitoring/clientapi/v2/provisioner
This operation returns the provisioning files of the vehicle sensors that are registered in the system by providing their activation IDs.
Request
Supported Media Types
- application/json
- application/vnd.oracle.resource+json;type=singular
Root Schema : VehicleProvisioningRequest_create
Type:
Show Source
object
-
activationIDs:
array activationIDs
Identifier of the entity to get provisioning information.
-
passphrase:
string
Passphrase that would be used to encrypt the provisioning attributes.
-
transport:
string
Transport used by devices to communicate with the IoT Cloud service. Values are "https".
Nested Schema : activationIDs
Type:
array
Identifier of the entity to get provisioning information.
Show Source
Response
Supported Media Types
- application/zip
200 Response
Successfully processed.
400 Response
Bad Request. The request could not be understood by the server due to malformed syntax. The client SHOULD NOT repeat the request without modifications.
401 Response
Unauthorized. The request requires user authentication.
410 Response
Gone. The request could not be completed because the resource is intentionally unavailable. This code is only allowed in situations where it is expected that resource is intentionally unavailable. The request can only be repeated if the cause for the unavailability changes
503 Response
Service Unavailable. The request could not be completed because the resource is in busy and is not available. The request can be repeated if at a later time, when it can succeed
Examples
curl -X POST
-u <username>:<password>
-H 'Content-Type: application/json'
https://iotserver/fleetMonitoring/clientapi/v2/provisioner
Example of Request Body
The following example shows the content of the request body in JSON format:
{
"activationIDs":[
"activationIDs_1",
"activationIDs_2",
"activationIDs_3"
],
"passphrase":"Passphrase that would be used to encrypt the provisioning attributes.",
"transport":"Transport used by devices to communicate with the IoT Cloud service. Values are 'https'."
}
Complete cURL Example
The following example shows the complete cURL command that can be used to perform the described operation:
curl -X POST
-u <username>:<password>
-H 'Content-Type: application/json'
-d '{"activationIDs":["activationIDs_1","activationIDs_2","activationIDs_3"],"passphrase":"Passphrase that would be used to encrypt the provisioning attributes.","transport":"Transport used by devices to communicate with the IoT Cloud service. Values are 'https'."}'
https://iotserver/fleetMonitoring/clientapi/v2/provisioner
Note that in the request,
https://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
.