GET /switches/{uuid}/configurationData
Use this method to return information about all configuration-data files in Lenovo XClarity Administrator for a specific RackSwitch or Flex System switch.
Authentication
Authentication with username and password is required.
Request URL
GET https://{management_server_IP}/switches/{uuid}/configurationData
where {uuid} is the UUID of the managed switch to be retrieved. To obtain the switch UUID, use the GET /switches method.
Query parameters
None
Request body
None
Response codes
| Code | Description | Comments |
|---|---|---|
| 200 | OK | The request completed successfully. |
| 400 | Bad Request | A query parameter or request attribute is missing or not valid, or the operation is not supported. A descriptive error message is returned in the response body. |
| 403 | Forbidden | The orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request. |
| 409 | Conflict | There is a conflict with the current state of the resource. A descriptive error message is returned in the response body. |
| 500 | Internal Server Error | An internal error occurred. A descriptive error message is returned in the response body. |
Response body
| Attributes | Type | Description | ||
|---|---|---|---|---|
| switches | Array of objects | Information about configuration-back files for the switches. | ||
| configurationData | Array of objects | Information about each configuration-data file. | ||
| comment | String | The date when the configuration-data file was created.. | ||
| date | String | The date when the configuration-data file was created. | ||
| fileId | String | The ID of the configuration-data file | ||
| filename | String | The name of the configuration-data file | ||
| fwVersion | String | The version of firmware that is running on the switch | ||
| size | String | The size of the configuration-data file | ||
| switchUuid | String | The UUID of the switch | ||
| hostname | String | The hostname for the switch | ||
| ipAddress | String | The IP address of the switch | ||
| type | String | The type of switch | ||
| uuid | String | The UUID of the switch | ||
The following example is returned if the request is successful.
{
"switches": [{
"configurationData": [{
"comment": "comment2",
"date": "2017-03-06T01:47:57Z",
"fileId": "hwpdo"
"filename": "config2.cfg",
"fwVersion": "10.3.1.3",
"size": "11375",
"switchUuid": "00000000000010008000A897DCF89800"
},
{
"comment": "comment1",
"date": "2017-03-06T01:45:25Z",
"fileId": "ihwdZ",
"filename": "config1.cfg",
"fwVersion": "10.3.1.3",
"size": "11375",
"switchUuid": "00000000000010008000A897DCF89800"
}],
"hostname": "G8296_CNOS",
"ipAddress": "10.240.196.152",
"type": "LENOVO G8296",
"uuid": "00000000000010008000A897DCF89800"
}]
}
Give documentation feedback