| Cloud Admin | Enterprise Admin | User |
|---|---|---|
 |
 |
|
Contents:
Rack Resource offers the functionality of managing the rack infrastructure in a logical way. Feel free to distribute your machines into the Rack resource.
Rack Data Model
| Field Name | Type | Occurs | Required | Description |
|---|---|---|---|---|
| name | String | 1 | true | The name of the rack |
| shortDescripton | String | 1 | optional | The description of the rack in a short way |
| largeDescription | String | 1 | optional | The description of the rack in a large way |
| machines | Link | 1 | true | Link to the list of machines |
| edit | Link | 1 | true | Link to the url for edit the resource |
Methods related to Rack Resource
Retrieve a list of Racks
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/racks
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve a list of Racks.
Response Headers: Content-Length, Content-Type.
Response Message Body: Rack.
Response Status: 200, 401, 403.
Example Response: Response of the GET over Racks
Create a new Rack
Synopsis: POST http://{$hostIp}/api/admin/datacenters/{$datacenterId}/racks
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: Rack.
Request example: Create new Rack
Response Headers: Content-Length, Content-Type, Location.
Response Message Body: URI.
Response Status: 201, 400, 401, 403.
Response example: The creation response
Retrieve a Rack
Synopsis: GET http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$rackId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Retrieve information about a Rack.
Response Headers: Content-Length, Content-Type.
Response Message Body: Rack.
Response Status: 200, 401, 403.
Example Response: Response of the GET over a Rack
Update an existing Rack
Synopsis: PUT http://example.com/api/admin/datacenters/{$datacenterId}/racks/{$idRack}
Request Headers: Accept, Content-Type
Request Parameters: N/A.
Request Message Body: Rack.
Example Request: Update Rack entity.
Response Headers: Content-Length, Content-Type.
Response Message Body: N/A.
Response Status: 200, 400, 401, 403.
Delete a Rack
Synopsis: DELETE http://{$hostIp}/api/admin/datacenters/{$datacenterId}/racks/{$rackId}
Request Headers: Accept, Content-Type.
Request Parameters: N/A.
Request Message Body: N/A.
Example Request: Delete Rack entity.
Response Headers: Content-Length, Content-Type.
Response Message Body: N/A.
Response Status: 200, 401, 403, 409
Example Response: Response of the deletion
