# 编辑自定义接入点 #### 功能介绍 该API用于编辑指定接入点的流控、内容安全护栏开关、接入点名称、接入点描述。 #### 接口约束 - 该功能仅支持"西南-贵阳一"区域。 - 自定义接入点创建后，不支持修改模型服务。 #### URI PUT /v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目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)。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。 | | Content-Type | 是 | String | **参数解释：**消息体的类型，固定为application/json。 **约束限制：**不涉及。 **取值范围：**不涉及。 **默认取值：**不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | endpoint_name | 否 | String | **参数解释：**接入点名称。 **约束限制：**单用户的名称具有唯一性。 **取值范围：**输入长度1至64个字符，以中文或大小写字母开头，只包含中文、大小写字母、数字、中划线、下划线和小数点。 **默认取值：**不涉及。 | | remark | 否 | String | **参数解释：**接入点的描述。 **约束限制：**不涉及。 **取值范围：**输入长度最大256个字符。 **默认取值：**不涉及。 | | rpm | 否 | Integer | **参数解释：**接入点RPM流控值，单位：次/分钟。 **约束限制：**不涉及。 **取值范围：** 每个模型的取值范围不同，您可以在[ModelArts Studio（MaaS）控制台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)"在线推理 \> 预置服务"页签的"模型限流"列查看模型对应的取值范围。 **默认取值：**不涉及。 | | tpm | 否 | Integer | **参数解释：**接入点TPM流控值。单位：Token/分钟。 **约束限制：**不涉及。 **取值范围：** 每个模型的取值范围不同，您可以在[ModelArts Studio（MaaS）控制台](https://console.huaweicloud.com/modelarts/#/model-studio/homepage)"在线推理 \> 预置服务"页签的"模型限流"列查看模型对应的取值范围。 **默认取值：**不涉及。 | | moderation | 否 | Boolean | **参数解释：** 是否开启内容安全护栏。仅客户等级为V2及以上，支持开启或关闭内容安全护栏。更多信息，请参见[客户等级体系](https://www.huaweicloud.com/about/customer_tier.html)和[如何查看客户等级](https://support.huaweicloud.com/account_faq/faq_id_0069.html)。 **约束限制：**仅客户等级为V2及以上，支持开启或关闭内容安全护栏。 **取值范围：** - true：在模型推理链路中，开启内容安全护栏，提供**额外拦截** 输入输出有害内容的能力，**可能导致时延增加**。 - false：不开启内容安全护栏，使用模型原生安全能力。 **默认取值：**true。 | | agreement_id | 否 | String | **参数解释：** 开关内容安全护栏需要签订协议，这里传入的是协议id。获取方式请参见[获取最新内容安全护栏免责声明](https://support.huaweicloud.com/api-maas/api-maas-0022.html)中的agreement_id。 **约束限制：**当moderation为false时为必填。 **取值范围：**不涉及。 **默认取值：**不涉及。 | #### 响应参数 表4响应参数（成功） | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 1 | Integer | **参数解释：**编辑操作成功标识，固定返回1。 **取值范围：**不涉及。 | 表5响应参数（错误） | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_msg | String | **参数解释：**错误描述信息。 **取值范围：**不涉及。 | | error_code | String | **参数解释：**错误码，标识错误类型。 **取值范围：**不涉及。 | #### 请求示例 - MaaS非多模态模型：此处以修改自定义接入点的名称、描述、内容安全护栏开关、RPM和TPM参数为例。 ``` PUT https://{endpoint}/v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id} { "endpoint_name": "DeepSeek", "remark": "DeepSeek", "moderation": false, "agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62****", "rpm":0, "tpm":0 } ``` #### 响应示例 - 成功响应，状态码：200 ``` 1 ``` - 失败响应，状态码：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)。