{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/Kmvhxj8z6","result":{"data":{"markdownRemark":{"html":"

接口描述

\n

分页拉取当前账号、当前地域下的多角色服务（服务组）列表。

\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=DescribeGroupServices \n2HTTP/1.1\n3Host:aihc.bj.baidubce.com\n4Authorization: authorization string\n5version: v2\n6{\n7  "pageNumber": 1,\n8  "pageSize": 10,\n9  "keyword": "string",\n10  "orderBy": "createdAt",\n11  "order": "desc"\n12}
\n
\n
\n
\n \n

这个接口是 POST，参数放在请求体里。 请求体里没填的参数，也可以放在 URL 的查询串里，两处都有时以请求体为准。

\n

请求头域

\n

除公共头域外，无其它特殊头域。

\n

请求参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称参数类型是否必须参数位置参数说明
pageNumberInt否body页码，默认 1，必须大于等于 1
pageSizeInt否body每页条数，默认 10，必须大于等于 1。实测传 100000 也被接受
keywordString否body按服务组名称模糊过滤
orderByString否body排序字段，目前只支持 createdAt
orderString否body排序方式，asc 或 desc。必须和 orderBy 同时填写或同时不填
\n

返回头域

\n

除公共头域，无其它特殊头域。

\n

返回参数

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数名称类型说明
requestIdString唯一标识请求，用于日志排查
totalCountInt符合条件的服务组总数
pageNumberInt本次请求的页码
pageSizeInt本次请求的每页条数
serviceGroupsArray of ServiceGroupBrief服务组列表
\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /?action=DescribeGroupServices \n2HTTP/1.1\n3Host:aihc.bj.baidubce.com\n4version: v2\n5Authorization:authorization string\n6{\n7  "pageNumber": 1,\n8  "pageSize": 10,\n9  "keyword": "qwen3",\n10  "orderBy": "createdAt",\n11  "order": "desc"\n12}
\n
\n
\n
\n \n

返回示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2\n3{\n4  "requestId": "174e6078-00d4-4b6f-b90f-63451cbcbe67",\n5  "totalCount": 1,\n6  "pageNumber": 1,\n7  "pageSize": 10,\n8  "serviceGroups": [\n9    {\n10      "id": "g-xxxxxxxxxxxx",\n11      "groupName": "qwen3-32b-pd",\n12      "resourcePoolId": "aihc-xxxxxxxxxxxx",\n13      "resourcePoolType": "serverless",\n14      "creator": "liushuai37",\n15      "createdAt": 1792410249,\n16      "updatedAt": 1792410249\n17    }\n18  ]\n19}
\n
\n
\n
\n ","fields":{"slug":"Kmvhxj8z6","title":"拉取多角色服务列表","date":"2026-10-21","extractedHeadings":[]},"headings":[{"value":"接口描述","depth":2},{"value":"请求结构","depth":2},{"value":"请求头域","depth":2},{"value":"请求参数","depth":2},{"value":"返回头域","depth":2},{"value":"返回参数","depth":2},{"value":"请求示例","depth":2},{"value":"返回示例","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Kmvhxj8z6","prev":{"id":"smvhx45f7","name":"创建多角色服务","path":"smvhx45f7","filePath":"API参考/在线服务部署相关接口/创建多角色服务.md","seo":null,"parentIds":["mmayu31ru","qmb4u4atp"],"parents":[{"id":"mmayu31ru","documentId":"48258baa-37d7-4b6c-a778-5f862d3dc325","name":"API参考","repoName":"AIHC","filePath":"API参考","disabled":false,"path":"mmayu31ru","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"qmb4u4atp","documentId":"faa84f92-dba6-4880-be0c-9b2776d1037e","name":"在线服务部署相关接口","repoName":"AIHC","filePath":"API参考/在线服务部署相关接口","disabled":false,"path":"qmb4u4atp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"next":{"id":"umvhxpopr","name":"查询多角色服务详情","path":"umvhxpopr","filePath":"API参考/在线服务部署相关接口/查询多角色服务详情.md","seo":null,"parentIds":["mmayu31ru","qmb4u4atp"],"parents":[{"id":"mmayu31ru","documentId":"48258baa-37d7-4b6c-a778-5f862d3dc325","name":"API参考","repoName":"AIHC","filePath":"API参考","disabled":false,"path":"mmayu31ru","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"qmb4u4atp","documentId":"faa84f92-dba6-4880-be0c-9b2776d1037e","name":"在线服务部署相关接口","repoName":"AIHC","filePath":"API参考/在线服务部署相关接口","disabled":false,"path":"qmb4u4atp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}]},"parents":[{"id":"mmayu31ru","documentId":"48258baa-37d7-4b6c-a778-5f862d3dc325","name":"API参考","repoName":"AIHC","filePath":"API参考","disabled":false,"path":"mmayu31ru","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null},{"id":"qmb4u4atp","documentId":"faa84f92-dba6-4880-be0c-9b2776d1037e","name":"在线服务部署相关接口","repoName":"AIHC","filePath":"API参考/在线服务部署相关接口","disabled":false,"path":"qmb4u4atp","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null,"solutionTag":null,"solutionColor":null}],"specificSeo":null}}}