编辑自定义接入点
功能介绍
该API用于编辑指定接入点的流控、内容安全护栏开关、接入点名称、接入点描述。
接口约束
- 该功能仅支持“西南-贵阳一”区域。
- 自定义接入点创建后，不支持修改模型服务。
URI
PUT /v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id}
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释：用户Token。通过调用IAM服务的获取用户Token接口获取（响应消息头中X-Subject-Token的值）。具体操作，请参见认证鉴权。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
Content-Type |
是 |
String |
参数解释：消息体的类型，固定为application/json。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
endpoint_name |
否 |
String |
参数解释：接入点名称。 约束限制：单用户的名称具有唯一性。 取值范围：输入长度1至64位，以中文，大小写字母开始，只包含中文、大小写字母、数字、中划线、下划线和小数点。 默认取值：不涉及。 |
|
remark |
否 |
String |
参数解释：接入点的描述。 约束限制：不涉及。 取值范围：输入长度最大256个字符。 默认取值：不涉及。 |
|
rpm |
否 |
Integer |
参数解释：接入点RPM流控值。 约束限制：不涉及。 取值范围：每个模型的取值范围不同，您可以在ModelArts Studio（MaaS）控制台页签的“模型限流”列查看模型对应的取值范围。 默认取值：不涉及。 |
|
tpm |
否 |
Integer |
参数解释：接入点TPM流控值。 约束限制：不涉及。 取值范围：每个模型的取值范围不同，您可以在ModelArts Studio（MaaS）控制台页签的“模型限流”列查看模型对应的取值范围。 默认取值：不涉及。 |
|
moderation |
否 |
Boolean |
参数解释：是否开启内容安全护栏。仅客户等级为V2及以上，支持开启或关闭内容安全护栏。更多信息，请参见客户等级体系和如何查看客户等级。 约束限制：非必填，默认值为true。 取值范围：
默认取值：true。 |
|
agreement_id |
否 |
String |
参数解释：开关内容安全护栏需要签订协议，这里传入的是协议id。获取方式请参见获取最新内容安全护栏免责声明中的agreement_id。 约束限制：moderation为false时为必填。 取值范围：不涉及。 默认取值：不涉及。 |
响应参数
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
1 |
String |
参数解释：操作结果标识，固定返回1。 取值范围：不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_msg |
String |
参数解释：错误描述信息。 取值范围：不涉及。 |
|
error_code |
String |
参数解释：错误码，标识错误类型。 取值范围：不涉及。 |
请求示例
此处以修改自定义接入点的名称、描述、内容安全护栏开关、RPM和TPM参数为例。
/v1/{project_id}/maas/services/custom-endpoint/endpoint/{custom_endpoint_id}
{
"endpoint_name": "DeepSeek-Test",
"remark": "DeepSeek自定义接入点测试",
"moderation": false,
"agreement_id": "af247c14-2bee-4d78-a5e8-a419ea62b6c6",
"rpm":0,
"tpm":0
}
响应示例
- 成功响应，状态码：200
1
- 失败响应，状态码：400
{ "error_msg": "Invalid token.", "error_code": "ModelArts.0104" }
状态码
请参见状态码。
错误码
请参见错误码。
