# 启用/停用自定义接入点
#### 功能介绍
该API用于根据传入的project_id和custom_endpoint_id，启用或停用接入点。
#### 接口约束
该功能仅支持"西南-贵阳一"区域。
#### URI
PUT /v1/{project_id}/maas/services/custom-endpoint/control/{custom_endpoint_id}
表1路径参数 
| 参数                  | 是否必选 | 参数类型 | 描述                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id         | 是      | String | **参数解释：** 项目ID。关于如何获取项目ID，请参见[获取项目ID和名称](https://support.huaweicloud.com/api-maas/api-maas-0028.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。 |
| custom_endpoint_id | 是    | String | **参数解释：** 自定义接入点ID，创建接入点时接口会返回，或者使用查询接口获取。具体操作，请参见[创建自定义接入点](https://support.huaweicloud.com/api-maas/api-maas-0013.html)或[查询自定义接入点](https://support.huaweicloud.com/api-maas/api-maas-0015.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。                            |
   
#### 请求参数
表2请求Header参数 
| 参数          | 是否必选 | 参数类型  | 描述                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。通过调用IAM服务的获取用户Token接口获取（响应消息头中X-Subject-Token的值）。具体操作，请参见[认证鉴权](https://support.huaweicloud.com/api-maas/api-maas-0005.html)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。 |
   
表3请求Body参数 
| 参数    | 是否必选 | 参数类型  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| action | 是     | String | **参数解释：**控制接入点启用或停用。 **约束限制：**不涉及。 **取值范围：** - activate：启用接入点。  - deactivate：停用接入点。   **默认取值：**不涉及。 |
   
#### 响应参数
- 成功响应： 状态码：204，启停成功不返回消息。
  
 
- 错误响应参数如下：
  
  | 参数        | 参数类型    | 描述                                                   |
  |:---|:---|:---|
  | error_msg  | String  | **参数解释：**错误描述信息。 **取值范围：**不涉及。       |
  | error_code | String | **参数解释：**错误码，标识错误类型。 **取值范围：**不涉及。 |
     
  
#### 请求示例
此处以启用ID为"c4513589-df2e-4d58-ab0c-d5a6f2\*\*\*\*\*\*"的接入点为例。
```
PUT
https://{endpoint}/v1/{project_id}/maas/services/custom-endpoint/control/c4513589-df2e-4d58-ab0c-d5a6f2******
{
    "action": "activate"
}
```
#### 响应示例
- 成功响应： 状态码：204，操作成功不返回内容。
  
- 错误响应： 状态码：当接入点ID不存在时，返回404接入点不存在，当参数不符合规范时，返回400报错。
  ```
  {
      "error_msg": "Invalid token.",
      "error_code": "ModelArts.0104"
  }
  ```
  
 
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-maas/api-maas-0027.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-maas/ErrorCode.html)。