Modifies the boot configuration of a heterogeneous instance (PCFarm bare metal instance).
Operation description
Modifies the boot configuration of a heterogeneous instance (PCFarm bare metal instance, where InstanceTypeFamily is pc_bmi). If the current state of the instance does not support this operation, the API returns IncorrectInstanceStatus.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
ens:ModifyInstanceBootConfiguration |
update |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
The ID of the instance whose boot configuration you want to modify. You can specify only one instance ID. |
i-instance**** |
| BootType |
string |
Yes |
The boot type. Governance testing has confirmed that the value disk passes parameter validation, whereas the original example value pxe returns Parameter.Invalid. Other values have not been confirmed. |
disk |
| BootSet |
string |
No |
The boot method. |
legacy |
| DiskSet |
string |
No |
Specifies whether the boot process depends on a disk. |
on |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Schema of Response |
||
| RequestId |
string |
Id of the request |
6666C5A5-75ED-422E-A022-7121FA18C968 |
Examples
Success response
JSON format
{
"RequestId": "6666C5A5-75ED-422E-A022-7121FA18C968"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InstanceNotFound | Instance not found, please check the InstanceId. | Instance not found, please check the instance ID |
| 400 | Parameter.Invalid | The parameter is invalid. Please check your parameters and try it again. | The parameter is invalid. |
| 400 | IncorrectInstanceStatus | The current status of the instance does not support this operation. | The instance is in a state that does not support the current operation. |
| 400 | InvalidInstanceType.NotSupported | The specified InstanceType is not Supported. | The specified instance type does not support the current operation. |
| 400 | NoPermission | Permission denied. | |
| 400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.