Add devices

post/devices/v1beta1/devices

Add one or more devices to a workspace. This API provides an asynchronous response and will always return 202 Accepted if basic input validations are successful. The location header in the response provides the URI to be invoked for fetching the progress of the device addition task. For details about the status fetch URL, refer to the API Get progress or status of async operations in devices.

NOTE: You need edit permissions for the Devices and Subscription service to invoke this API.

Rate limits are enforced on this API. Four requests per minute is supported per workspace. API will result in 429 if this threshold is breached.

SecurityBearer
Request
Request Body schema: application/json
required

Accepts a maximum of five devices per request, combining the count of network, compute, and storage devices.

required
Array of objects (RequestCompute)
required
Array of objects (RequestNetwork)
required
Array of objects (RequestStorage)
Responses
202

Request accepted

400

Bad request

401

Unauthorized request

403

The operation is forbidden

422

Validation error

429

Too many requests

500

Internal server error

Request samples
application/json
{
  • "network": [
    ],
  • "compute": [
    ],
  • "storage": [
    ]
}
Response samples
application/json
{
  • "code": 0,
  • "status": "100 CONTINUE",
  • "transactionId": "string"
}