UpdateBareMetal2Chassis
API Request
URLs
PUT zstack/v1/baremetal2/chassis/{uuid}/actionsHeaders
Authorization: OAuth the-session-uuidBody
Note: In
the preceding sample, both systemTags and userTags are optional.
These two fields can be included in the body structure.
{
"updateBareMetal2Chassis": {
"name": "NEW_BM_CHASSIS",
"description": "This is a new bare metal chassis."
},
"systemTags": [],
"userTags": []
}
Note: In
the preceding sample, both systemTags and userTags are optional.
These two fields can be included in the body structure.Curl Sample
curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X PUT -d '{"updateBareMetal2Chassis":{"name":"NEW_BM_CHASSIS","description":"This is a new bare metal chassis."}}' http://localhost:8080/zstack/v1/baremetal2/chassis/4e99972d89a63a9fa061971a3267374f/actionsRequest Parameters
| Name | Type | Location | Description | Valid Value | Starting Version |
|---|---|---|---|---|---|
| uuid | String | url | The UUID of the bare metal chassis. | 4.0.0 | |
| name | String | body(contained in the updateBaremetalChassis structure) | Optional. The name of the bare metal chassis. | 4.0.0 | |
| description | String | body(contained in the updateBaremetalChassis structure) | Optional. The detailed description of the bare metal chassis. | 4.0.0 | |
| systemTags | List | body | Optional. The system tags. | 4.0.0 | |
| userTags | List | body | Optional. The user tags. | 4.0.0 |
API Response
Sample
Response
{
"inventory": {
"uuid": "ff9c61a4323b429eb53552098b3582e5",
"name": "BM_CHASSIS",
"description": "This is a bare metal chassis.",
"zoneUuid": "6324e249a6434599867f0bdc4166f89d",
"clusterUuid": "4569c6fc1b4e453691bfa3bed90d66d2",
"chassisOfferingUuid": "dfd1ef44f65f49a8b788a31727eeea17",
"type": "IPMI",
"state": "Enabled",
"status": "Available",
"powerStatus": "POWER_ON",
"createDate": "Nov 14, 2017 10:20:57 PM",
"lastOpDate": "Nov 14, 2017 10:20:57 PM"
}
}| Name | Type | Description | Starting Version |
|---|---|---|---|
| success | boolean | 4.3.6 | |
| error | ErrorCode | The error code. If not null, the operation fails, or vice versa. For more information, see error. | 4.0.0 |
| inventory | BaremetalChassisInventory | See inventory. | 4.0.0 |
#error
| Name | Type | Description | Starting Version |
|---|---|---|---|
| code | String | The error code, which is a numbered or alphanumeric code that specifies an error. For example, SYS.1000, HOST.1001. | 4.0.0 |
| description | String | The brief description of the error. | 4.0.0 |
| details | String | The details about the error. | 4.0.0 |
| elaboration | String | The reserved field. Default value: null. | 4.0.0 |
| opaque | LinkedHashMap | The reserved field. Default value: null. | 4.0.0 |
| cause | ErrorCode | The root error, which is the associated root cause of the current error. If no root error exists, this parameter is null. | 4.0.0 |
#inventory
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The UUID of the bare metal chassis. | 4.0.0 |
| name | String | The name of the bare metal chassis. | 4.0.0 |
| description | String | The detailed description of the bare metal chassis. | 4.0.0 |
| zoneUuid | String | The zone UUID. | 4.0.0 |
| clusterUuid | String | The cluster UUID. | 4.0.0 |
| chassisOfferingUuid | String | The chassis offering UUID. | 4.0.0 |
| type | String | The type of the protocol used to control bare metal chassis and instances. | 4.0.0 |
| state | String | The state of the chassis. | 4.0.0 |
| status | String | The distribution status of the chassis. | 4.0.0 |
| powerStatus | String | The power status of the chassis. | 4.0.0 |
| createDate | Timestamp | The time when the chassis was added to the cluster. | 4.0.0 |
| lastOpDate | Timestamp | The time when the chassis was last modified. | 4.0.0 |
| chassisNics | List | See chassisNics. | 4.0.0 |
| chassisDisks | List | See chassisDisks. | 4.0.0 |
| chassisOffering | BareMetal2ChassisOfferingInventory | See chassisOffering. | 4.0.0 |
#chassisNics
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The UUID of the bare metal chassis NIC. | 4.0.0 |
| chassisUuid | String | The UUID of the bare metal chassis. | 4.0.0 |
| mac | String | The MAC address of the chassis NIC. | 4.0.0 |
| speed | String | The data rate of the chassis NIC. | 4.0.0 |
| isProvisionNic | Boolean | Indicates whether the NIC is a provisioned NIC. | 4.0.0 |
| createDate | Timestamp | The time when the NIC was created. | 4.0.0 |
| lastOpDate | Timestamp | The time when the NIC was last modified. | 4.0.0 |
#chassisDisks
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The UUID of the chassis disk. | 4.0.0 |
| chassisUuid | String | The chassis UUID. | 4.0.0 |
| diskSize | Long | The size of the disk storage space, in bytes. | 4.0.0 |
| type | String | The type of the disk. | 4.0.0 |
| createDate | Timestamp | The time when the disk was created. | 4.0.0 |
| lastOpDate | Timestamp | The time when the disk was last modified. | 4.0.0 |
#chassisOffering
| Name | Type | Description | Starting Version |
|---|---|---|---|
| uuid | String | The chassis offering UUID. | 4.0.0 |
| name | String | The name of the chassis offering. | 4.0.0 |
| description | String | The detailed description of the chassis offering. | 4.0.0 |
| architecture | String | The CPU architecture. | 4.0.0 |
| cpuModelName | String | The CPU model name. | 4.0.0 |
| cpuNum | Integer | The number of CPU cores. | 4.0.0 |
| memorySize | Long | The memory size. | 4.0.0 |
| bootMode | String | The boot mode. | 4.0.0 |
| state | String | The state of the chassis offering. | 4.0.0 |
| createDate | Timestamp | The time when the chassis offering was created. | 4.0.0 |
| lastOpDate | Timestamp | The time when the chassis offering was last modified. | 4.0.0 |
SDK Sample
Java
SDK
UpdateBareMetal2ChassisAction action = new UpdateBareMetal2ChassisAction();
action.uuid = "4e99972d89a63a9fa061971a3267374f";
action.name = "NEW_BM_CHASSIS";
action.description = "This is a new bare metal chassis.";
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
UpdateBareMetal2ChassisAction.Result res = action.call();Python
SDK
UpdateBareMetal2ChassisAction action = UpdateBareMetal2ChassisAction()
action.uuid = "4e99972d89a63a9fa061971a3267374f"
action.name = "NEW_BM_CHASSIS"
action.description = "This is a new bare metal chassis."
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
UpdateBareMetal2ChassisAction.Result res = action.call()