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

接口

\n

本接口用于修改站点所属的源站池。

\n

请求接口

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
MethodPath说明
POST/v2/geo/origin-pool?action=update修改源站池
\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
字段名称类型是否必须说明
siteString是站点名称
originPoolIdString是源站池Id
originPoolObject<OriginPool>是源站池配置
\n
\n

OriginPool 类型说明

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
字段名称类型是否必须说明
nameString是源站池名称，支持大小写字母、数字及特殊字符，限制长度为0-120
originConfigArray<OriginConfig>是源站配置
\n
\n

OriginConfig 类型说明

\n
\n

(1) IP 或 域名源站类型

\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
字段名称类型是否必须说明
addrString是源站地址。支持 IPv4、IPv6 形式的 IP 地址，或者域名，不能重复
typeString是源站类型。可选值为 “IP”、“DOMAIN”
hostString否回源时使用的 host 值
weightInt是源站权重，值为 1-100 之间的整数。默认值为 50
\n
\n

(2)对象存储类型

\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
字段名称类型是否必须说明
addrString是BOS 的 bucket 名称或 S3 对象存储的源站地址
typeString是源站类型。可选值为 “BUCKET”、“DOMAIN”，BOS 使用 “BUCKET”，S3 使用 “DOMAIN”
hostString否回源时使用的 host 值
weightInt是源站权重，值为 1-100 之间的整数。默认值为 50
thirdBucketAuthObject<ThirdBucketAuth>是对象存储的鉴权配置
\n
\n

ThirdBucketAuth 类型说明

\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\n\n\n\n
字段名称类型是否必须说明
authTypeString是鉴权类型，当前支持 AWS S3 以及 BOS。其合法值为：“aws_v2”、“aws_v4”、“bos”
enabledBool是私有访问鉴权的开关，其合法值为 “true”、“false”
akString否只针对 S3 鉴权类型生效，开启私有访问鉴权时必须输入该值，对象存储的访问密钥 Access Key
skString否只针对 S3 鉴权类型生效，开启私有访问鉴权时必须输入该值，对象存储的私有访问密钥 Secret Access Key
bucketString否只针对 S3 鉴权类型生效，对象存储的 bucket。
• aws_v2：必须设置
• aws_v4：无需设置
regionString否只针对 S3 鉴权类型生效，对象存储的区域。
• aws_v2：无需设置
• aws_v4：选填，默认区域为 “us-east-1”
serviceString否只针对 S3 鉴权类型生效，对象存储的服务。
• aws_v2：无需设置
• aws_v4：选填，默认服务为 “s3”
\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
HTTP Status Code 说明
200修改成功
400源站池修改请求参数无效
500服务端错误
\n
\n

响应体

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型说明
successBool修改源站池成功
\n
\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1POST /v2/geo/origin-pool?action=update HTTP/1.1\n2Host: geo.baidubce.com\n3Authorization: xxx\n4Content-Type: application/json;charset=utf-8\n5Accept-Encoding: gzip\n6{\n7    "site": "test-eo.com",\n8    "originPoolId": "geo_LGKm6ryALtnO",\n9    "originPool": {\n10        "name": "test",\n11        "originConfig": [\n12            {\n13                "addr": "your.bos.bucket1.name",\n14                "type": "BUCKET",\n15                "host": "test.host.com",\n16                "weight": 50,\n17                "thirdBucketAuth": {\n18                    "authType": "bos",\n19                    "enabled": false\n20                }\n21            },\n22            {\n23                "addr": "your.bos.bucket2.name",\n24                "type": "BUCKET",\n25                "host": "test.host.com",\n26                "weight": 50,\n27                "thirdBucketAuth": {\n28                    "authType": "bos",\n29                    "enabled": true\n30                }\n31            },\n32            {\n33                "addr": "test.s3.com",\n34                "type": "DOMAIN",\n35                "host": "test.host.com",\n36                "thirdBucketAuth": {\n37                    "authType": "aws_v4",\n38                    "enabled": true,\n39                    "ak": "your ak",\n40                    "sk": "your sk",\n41                    "bucket": "your bucket"\n42                },\n43                "weight":50\n44            },\n45            {\n46                "addr": "test.origin.com",\n47                "type": "DOMAIN",\n48                "weight": 50,\n49                "host": "test.host.com"\n50            },\n51            {\n52                "addr": "1.2.3.4",\n53                "type": "IP",\n54                "weight": 50,\n55                "host": "test.host.com"\n56            }\n57        ]\n58    }\n59}
\n
\n
\n
\n \n

响应示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2Server: nginx/1.16.1\n3Content-Type: application/json; charset=utf-8\n4Transfer-Encoding: chunked\n5Connection: keep-alive\n6{\n7    "success": true\n8}
\n
\n
\n
\n ","fields":{"slug":"Emv7jopf1","title":"修改源站池接口","date":"2026-10-14","extractedHeadings":[]},"headings":[{"value":"接口","depth":2},{"value":"请求接口","depth":3},{"value":"请求体","depth":2},{"value":"响应码","depth":2},{"value":"响应体","depth":2},{"value":"请求示例","depth":2},{"value":"响应示例","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Emv7jopf1","prev":{"id":"gmv7k3lsw","name":"删除源站池接口","path":"gmv7k3lsw","filePath":"API参考/源站池配置/删除源站池接口.md","seo":null,"parentIds":["Bmhk21cux","nmv6jzcjf"],"parents":[{"id":"Bmhk21cux","documentId":"edee1557-6226-438b-89d4-02d457b6b7b1","name":"API参考","repoName":"GEO","filePath":"API参考","disabled":false,"path":"Bmhk21cux","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmv6jzcjf","documentId":"bdaba496-9848-4743-9626-1f34312b4f0b","name":"源站池配置","repoName":"GEO","filePath":"API参考/源站池配置","disabled":false,"path":"nmv6jzcjf","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"qmv6mzi3i","name":"查询源站池接口","path":"qmv6mzi3i","filePath":"API参考/源站池配置/查询源站池接口.md","seo":null,"parentIds":["Bmhk21cux","nmv6jzcjf"],"parents":[{"id":"Bmhk21cux","documentId":"edee1557-6226-438b-89d4-02d457b6b7b1","name":"API参考","repoName":"GEO","filePath":"API参考","disabled":false,"path":"Bmhk21cux","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmv6jzcjf","documentId":"bdaba496-9848-4743-9626-1f34312b4f0b","name":"源站池配置","repoName":"GEO","filePath":"API参考/源站池配置","disabled":false,"path":"nmv6jzcjf","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Bmhk21cux","documentId":"edee1557-6226-438b-89d4-02d457b6b7b1","name":"API参考","repoName":"GEO","filePath":"API参考","disabled":false,"path":"Bmhk21cux","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"nmv6jzcjf","documentId":"bdaba496-9848-4743-9626-1f34312b4f0b","name":"源站池配置","repoName":"GEO","filePath":"API参考/源站池配置","disabled":false,"path":"nmv6jzcjf","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}