# 关闭裸金属服务器（废弃）
#### 功能介绍
关闭单台裸金属服务器。如需操作多台裸金属服务器，可以使用[关闭裸金属服务器 - BatchStopBaremetalServers](https://support.huaweicloud.com/api-bms/bms_api_0615.html)API。
当前API已废弃，请使用"[关闭裸金属服务器 - BatchStopBaremetalServers](https://support.huaweicloud.com/api-bms/bms_api_0615.html)"。
#### 约束
- 裸金属服务器状态（OS-EXT-STS:vm_state属性）必须是active或error。
- 当前仅支持强制关闭。
 
#### URI
POST /v2.1/{project_id}/servers/{server_id}/action
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                      |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                       |
| server_id  | 是    | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器列表（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0709.html)获取。 |
   
#### 请求参数
| 参数      | 是否必选 | 参数类型   | 描述                                                          |
|:---|:---|:---|:---|
| os-stop | 是    | Object | 标识关闭裸金属服务器操作。详情请参见[表2]。 |
   
 表2os-stop字段数据结构说明 
| 参数   | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| type | 否    | String | 关机类型： - SOFT：普通关机。  - HARD：强制关机。 说明： 当前该参数无效，即均为强制关机。    |
   
#### 请求示例
关闭ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器。
```
POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action
```
```
{
    "os-stop": {}
}
```
#### 响应消息
不涉及。
#### 返回值
正常返回值：
| 返回值 | 说明                    |
|:---|:---|
| 204 | 服务器成功处理了请求，但没有返回任何内容。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。