查询接入点列表
更新时间：2026-05-15
POST
https://qianfan.baidubce.com/v2/service?Action=ListEndpoints
此接口用于查询用户创建的接入点列表，返回接入点详情信息。
权限说明
调用本文API，需符合以下权限要求，权限介绍及分配，请查看角色与权限控制列表、账号创建与权限分配。
- 运维操作千帆大模型平台预测服务的权限：
QianfanServiceOperateAccessPolicy
鉴权说明
调用本文API，使用“基于安全认证AK/SK”进行签名计算鉴权，即使用安全认证中的Access Key ID和Secret Access Key进行鉴权，参见鉴权认证。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
Action
string
方法名称，固定值：ListEndpoints
必选
Body 参数
pageNumber
integer
分页查询时的起始页码，从 1 开始，默认为 1
可选
pageSize
integer
每页最大返回数量，默认 10，最大 100
可选
sortBy
string
排序字段
createTime：创建时间updateTime：更新时间
可选
sortOrder
string
排序顺序，默认为 desc。
asc：升序desc：降序
可选
filter
object {4}
筛选条件对象
可选
显示子属性
隐藏子属性
serviceId
string
服务ID，筛选指定服务下的接入点
可选
statuses
array
接入点状态列表
Active：正常Stopped：停用
可选
显示子属性
隐藏子属性
items
string
name
string
接入点名称，支持模糊查询
可选
tag
object {2}
标签筛选条件，仅支持传入1个 tag，根据传值不同匹配规则如下：
- 传入具体值（如 "production"）：精确匹配该标签值
- 传入 "所有值"三个字：匹配该标签键下的所有资源（含标签值为空的资源）
- 传入空字符串""或不传：仅匹配标签值为空的资源
可选
显示子属性
隐藏子属性
tagKey
string
标签键
可选
tagValue
string
标签值筛选
可选
请求结构
POST /v2/service?Action=ListEndpoints HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"pageNumber": 1,
"pageSize": 10,
"sortBy": "createTime",
"sortOrder": "desc",
"filter": {
"serviceId": "svcp-****252832",
"statuses": ["Active"],
"name": "chat",
"tag": {
"tagKey": "env",
"tagValue": "production"
}
}
}示例代码
curl
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=ListEndpoints" \
-H "Content-Type: application/json" \
-H "x-bce-date: 2026-05-15T07:48:39Z" \
-H "Authorization: bce-auth-v1/ALTA***Key/2026-05-15T07:48:39Z/1800/host;x-bce-date/SignatureString****" \
--data '{
"pageNumber": 1,
"pageSize": 10
}'Curl
curl -X POST "https://qianfan.baidubce.com/v2/service?Action=ListEndpoints" \
-H "Content-Type: application/json" \
-H "x-bce-date: 2026-05-15T07:48:39Z" \
-H "Authorization: bce-auth-v1/ALTA***Key/2026-05-15T07:48:39Z/1800/host;x-bce-date/SignatureString****" \
--data '{
"filter": {
"serviceId": "svcp-****252832",
"statuses": ["Active", "Stopped"],
"name": "chat",
"ids": [
"ep_1fu****5r_chat-service-v1",
"ep_2gh****6s_chat-service-v2"
],
"tag": {
"tagKey": "env",
"tagValue": "production"
}
},
"sortBy": "updateTime",
"sortOrder": "desc",
"pageNumber": 1,
"pageSize": 20
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID，用于追踪和定位问题
可选
result
object {4}
响应结果对象
可选
显示子属性
隐藏子属性
items
array
接入点列表
可选
显示子属性
隐藏子属性
items
object {9}
显示子属性
隐藏子属性
endpointId
string
接入点ID
可选
serverId
string
服务ID
可选
name
string
接入点名称
可选
description
string
接入点描述
可选
status
string
接入点状态
可选
rateLimit
object {4}
限流配置
可选
显示子属性
隐藏子属性
tpm
integer
TPM限制
可选
rpm
integer
RPM限制
可选
tpmInput
integer
输入TPM限制
可选
tpmOutput
integer
输出TPM限制
可选
tags
array
标签列表
可选
显示子属性
隐藏子属性
items
object {2}
显示子属性
隐藏子属性
tagKey
string
标签键
可选
tagValue
string
标签值
可选
createTime
string
创建时间，ISO 8601 格式
可选
updateTime
string
更新时间，ISO 8601 格式
可选
totalCount
integer
符合条件的接入点总数
可选
pageNumber
integer
当前页码
可选
pageSize
integer
每页数量
可选
成功示例
{
"requestId": "8a9b12c3-****-4def-b5e6-7890abcdef12",
"result": {
"items": [
{
"endpointId": "ep_1fu****5r_chat-service-v1",
"serverId": "svcp-****252832",
"name": "Qianfan_Chat_Service_01",
"description": "测试接入点",
"status": "Active",
"rateLimit": {
"tpm": 150000,
"rpm": 10
},
"tag": [
{
"tagKey": "env",
"tagValue": "production"
}
],
"createTime": "2026-05-01T10:00:00Z",
"updateTime": "2026-05-01T10:00:00Z"
},
{
"endpointId": "ep_2gh****6s_image-service-v2",
"serverId": "svcp-****252833",
"name": "Image_Service_02",
"description": "",
"status": "Active",
"rateLimit": {
"tpm": 200000,
"rpm": 20
},
"tag": [
{
"tagKey": "env",
"tagValue": "staging"
},
{
"tagKey": "team",
"tagValue": "ai"
}
],
"createTime": "2026-05-02T14:30:00Z",
"updateTime": "2026-05-03T09:15:00Z"
}
],
"totalCount": 100,
"pageNumber": 1,
"pageSize": 10
}
}错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
| 名称 | 描述 |
|---|---|
| requestId | 请求ID |
| code | 错误码 |
| message | 错误描述信息，帮助理解和解决发生的错误 |
错误示例
json
{
"requestId":"6ba7b810-xxxc04fd430c8",
"code":"AccessDenied",
"message":"Access denied."
}更多其他错误码，可查看错误码说明。
评价此篇文章