停用接入点
更新时间：2026-01-19
POST
https://qianfan.baidubce.com/v2/service?Action=DeactivateEndpoint
本接口停用指定的接入点。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。
- 运维操作千帆大模型平台预测服务的权限：
QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，参见鉴权认证。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值：DeactivateEndpoint。
必选
Body 参数
请求结构
POST /v2/service?Action=DeactivateEndpoint HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"endpointId": "ep_****hnt7p_chat-service-v1"
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=DeactivateEndpoint" \
-H "Content-Type: application/json" \
-H "x-bce-date: 2026-01-15T07:48:39Z" \
-H "Authorization: bce-auth-v1/ALTA***Key/2026-01-15T07:48:39Z/1800/host;x-bce-date/SignatureString****" \
--data '{
"endpointId":"ep_1****be5r_chat-service-v1"
}'
返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，用于追踪和定位问题。
必选
result
boolean
停用结果，表示停用接入点是否成功。true：停用成功false：停用失败
必选
成功响应
{
"requestId": "37a0d950-****-4a84-a412-e694a22d476a",
"result": true
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
错误示例
json
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，可查看错误码说明。