doc-exports/docs/ecs/api-ref/en-us_topic_0020212652.html
Huijuan, Wang 7d71165909 ecs api 20240912
Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: Huijuan, Wang <wanghuijuan738@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Huijuan, Wang <wanghuijuan738@noreply.gitea.eco.tsi-dev.otc-service.com>
2024-10-24 12:45:08 +00:00

8.2 KiB

Disabling an ECS

Function

This API is used to stop a single ECS.

URI

POST /v2.1/{project_id}/servers/{server_id}/action

POST /v2/{project_id}/servers/{server_id}/action

Table 1 describes the parameters in the URI.
Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID.

server_id

Yes

Specifies the ECS ID.

Request

Table 2 describes the request parameters.
Table 2 Request parameters

Parameter

Mandatory

Type

Description

os-stop

Yes

Object

Specifies the operation to stop the ECS. For details, see Table 3.

Table 3 os-stop field description

Parameter

Mandatory

Type

Description

type

No

String

Specifies an ECS stop type. The default value is SOFT.

  • SOFT: normal ECS stop
  • HARD: forcible ECS stop

Response

None

Example Request

Stop a specified ECS.

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/action

{
    "os-stop": {}
}

Example Response

None