Batch Modifying the Power Statuses of Physical Servers
Function
This API is used to modify the power status of a physical server. It is an asynchronous API. The power status modification result can be obtained from the information about the physical server.
Calling Method
For details, see Calling APIs.
URI
PUT /v1/{project_id}/physicalservers/power-state
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Definition The project ID. Constraints N/A Range The project ID of the account Default Value N/A |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
Definition Requests for calling an API can be authenticated using a token. If token-based authentication is used, this parameter is mandatory and must be set to a user token. Constraints N/A Range N/A Default Value N/A |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
action |
Yes |
String |
Definition Power operation type. Constraints N/A Range Default Value N/A |
server_id_set |
No |
Array of strings |
Definition Server ID list. Constraints A server ID list cannot contain more than 50 IDs. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
physical_servers |
Array of physical_servers objects |
Definition Returned information about the physical server. Constraints N/A |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Definition Error code. Constraints N/A Range N/A Default Value N/A |
error_msg |
String |
Definition Error message. Constraints N/A Range N/A Default Value N/A |
Status code: 401
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Definition Error code. Constraints N/A Range N/A Default Value N/A |
error_msg |
String |
Definition Error message. Constraints N/A Range N/A Default Value N/A |
Status code: 429
Parameter |
Type |
Description |
---|---|---|
- |
String |
- |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Definition Error code. Constraints N/A Range N/A Default Value N/A |
error_msg |
String |
Definition Error message. Constraints N/A Range N/A Default Value N/A |
Example Requests
Request for modifying the power status of physical servers in batches
PUT https://{endpoint}/v1/{project_id}/physicalservers/power-state { "action" : "power on", "server_id_set" : [ "01939592-e8fe-7d9b-9332-4589486377a4" ] }
Example Responses
Status code: 200
The power status is modified.
{ "physical_servers" : { "id" : { "$ref" : "#/definitions/UUID" } } }
Status Codes
Status Code |
Description |
---|---|
200 |
Power status modified. |
400 |
Invalid request parameter. |
401 |
The request is not authenticated. |
429 |
The request is overloaded. |
500 |
Internal server error. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot