Add one or more devices to a workspace. This API endpoint provides an asynchronous response and returns 202 Accepted
if basic input validations are successful. The location header in the response provides the URI to invoke to fetch 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 call this API endpoint.
Rate limits are enforced, and 25 requests per minute are supported per workspace. The API endpoint returns429
if this threshold is breached.
Accepts a maximum of five devices per request, combining the count of network, compute, and storage devices.
Request accepted
Bad request
Unauthorized request
The operation is forbidden
Validation error
Too many requests
Internal server error
{- "serialNumber": "SN12345678",
- "macAddress": "00:1B:44:11:3A:B7",
- "deviceType": "NETWORK",
- "tags": {
- "environment": "production"
}, - "location": {
- "id": "8cd9ad69-a8e5-4529-97ea-804b2c88d123"
}
}
{- "errorCode": "HPE_GL_ERROR_BAD_REQUEST",
- "message": "Bad Request",
- "debugId": "abbeeb59-12cb-49a3-9ce5-55edba12213f",
- "httpStatusCode": 400,
- "errorDetails": [
- {
- "type": "hpe.greenlake.bad_request",
- "issues": [
- {
- "source": "field",
- "subject": "serialNumber",
- "description": "serial number is blank."
}
]
}
]
}