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

接口

\n

本接口用于设置站点的用户 ip 获取配置。

\n

请求接口

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
MethodPath说明
PUT/v2/geo/site/{site}/config设置用户 ip 获取配置接口
\n

site：表示要设置的站点。

\n

请求体

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型可选说明
realIpList<RealIp>必选用户 ip 获取配置。
\n

响应码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP Status Code 说明
200设置用户 ip 获取配置成功
其他错误码配置参数错误
\n

响应体

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
参数类型说明
statusString表示修改该配置的状态。设置配置成功，其值为“RUNNING”。否则返回报错信息。
\n

请求示例1:设置 True-Client-Ip

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1PUT /v2/geo/site/test.com/config HTTP/1.1\n2Host: geo.baidubce.com\n3Content-Length: 46\n4Authorization: xxx\n5Content-Type: application/json;charset=utf-8\n6Accept-Encoding: gzip\n7\n8{\n9    "realIp": {\n10        "enabled": true,\n11        "name": "True-Client-Ip"\n12    }\n13}
\n
\n
\n
\n \n

请求示例2:设置 X-Real-IP

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1PUT /v2/geo/site/test.com/config HTTP/1.1\n2Host: geo.baidubce.com\n3Content-Length: 46\n4Authorization: xxx\n5Content-Type: application/json;charset=utf-8\n6Accept-Encoding: gzip\n7\n8{\n9    "realIp": {\n10        "enabled": true,\n11        "name": "X-Real-IP"\n12    }\n13}
\n
\n
\n
\n \n

请求示例3:关闭用户 ip 获取

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1PUT /v2/geo/site/test.com/config HTTP/1.1\n2Host: geo.baidubce.com\n3Content-Length: 46\n4Authorization: xxx\n5Content-Type: application/json;charset=utf-8\n6Accept-Encoding: gzip\n7\n8{\n9    "realIp": {\n10        "enabled": false\n11    }\n12}
\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{\n8    "status": "RUNNING"\n9}
\n
\n
\n
\n ","fields":{"slug":"Mmtjgz1s7","title":"设置用户ip获取配置","date":"2026-09-02","extractedHeadings":[]},"headings":[{"value":"接口","depth":2},{"value":"请求接口","depth":3},{"value":"请求体","depth":2},{"value":"响应码","depth":2},{"value":"响应体","depth":2},{"value":"请求示例1:设置 True-Client-Ip","depth":2},{"value":"请求示例2:设置 X-Real-IP","depth":2},{"value":"请求示例3:关闭用户 ip 获取","depth":2},{"value":"响应示例","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"Mmtjgz1s7","prev":{"id":"Vmtilqtwl","name":"查询OCSP配置","path":"Vmtilqtwl","filePath":"API参考/站点配置/查询OCSP配置.md","seo":null,"parentIds":["Bmhk21cux","dmhk27c3z"],"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":"dmhk27c3z","documentId":"0045c316-e19c-4308-bb84-69927fc769dd","name":"站点配置","repoName":"GEO","filePath":"API参考/站点配置","disabled":false,"path":"dmhk27c3z","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Imtjh6z6x","name":"查询用户ip获取配置","path":"Imtjh6z6x","filePath":"API参考/站点配置/查询用户ip获取配置.md","seo":null,"parentIds":["Bmhk21cux","dmhk27c3z"],"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":"dmhk27c3z","documentId":"0045c316-e19c-4308-bb84-69927fc769dd","name":"站点配置","repoName":"GEO","filePath":"API参考/站点配置","disabled":false,"path":"dmhk27c3z","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":"dmhk27c3z","documentId":"0045c316-e19c-4308-bb84-69927fc769dd","name":"站点配置","repoName":"GEO","filePath":"API参考/站点配置","disabled":false,"path":"dmhk27c3z","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}