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. 25 requests per minute is supported per workspace. The API returns429
if this threshold is breached.
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) |
Request accepted
Bad request
Unauthorized request
The operation is forbidden
Validation error
Too many requests
Internal server error
{- "network": [
- {
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "serialNumber": "string",
- "macAddress": "string"
}
], - "compute": [
- {
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "serialNumber": "string",
- "partNumber": "string"
}
], - "storage": [
- {
- "tags": {
- "property1": "string",
- "property2": "string"
}, - "serialNumber": "string",
- "partNumber": "string"
}
]
}
{- "code": 0,
- "status": "100 CONTINUE",
- "transactionId": "string"
}