# 关闭设备隧道 - UpdateDeviceTunnel
#### 功能介绍
应用服务器可通过该接口关闭某个设备隧道。关闭后可以再次连接。
- 该API接口在基础版不支持。
  
- 具体应用可见"设备远程登录"功能，请参见[设备远程登录](https://support.huaweicloud.com/usermanual-iothub/iot_01_00301.html)。
  
 
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0004.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-iothub/iot_06_v5_0201.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                | 访问级别  | 资源类型（\*为必须） | 条件键                   | 别名                  | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | iotda:tunnel:close | Write | -           | g:EnterpriseProjectId | iotda:tunnel:update | -      |
     
  
 
#### URI
PUT /v5/iot/{project_id}/tunnels/{tunnel_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数说明** ：项目ID。获取方法请参见 [获取项目ID](https://support.huaweicloud.com/api-iothub/iot_06_v5_1001.html)。 |
| tunnel_id  | 是    | String | 隧道ID                                                                                             |
   
#### 请求参数
表2请求Header参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                          |
|:---|:---|:---|:---|
| Instance-Id | 否    | String | **参数说明** ：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏"总览"页签查看当前实例的ID，具体获取方式请参考[查看实例详情](https://support.huaweicloud.com/usermanual-iothub/iot_01_0079.html#section1)。 |
   
#### 响应参数
**状态码：204**
no content
无
#### 请求示例
关闭设备隧道。
```
PUT https://{endpoint}/v5/iot/{project_id}/tunnels/{tunnel_id}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 204 | no content            |
| 400 | 输入参数不正确               |
| 401 | Unauthorized          |
| 403 | 鉴权认证失败                |
| 404 | 隧道不存在                 |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iothub/ErrorCode.html)。