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

接口描述

\n

对指定实例发起大版本升级操作。

\n

mysql引擎不支持跨版本升级，每次只能升级一个大版本，版本顺序直接参考 MySQL版本

\n

mysql升级前需进行前置检查和迁移评估，通过后可发起；pg引擎发起大版本升级前无需此操作

\n

SQL Server引擎不支持

\n

请求结构

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1PUT /v{version}/rds/instance/{instanceId}?upgradeMajorVersion HTTP/1.1\n2Host: rds.bj.baidubce.com\n3Authorization: authorization string
\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
参数名称类型是否必选参数位置描述
versionInteger是URL参数API版本号。此接口值为1
instanceIdString是URL参数实例ID
\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
参数名称类型是否必选描述
targetMajorVersionString是目标大版本
effectiveTimeString是任务类型， immediate - 立即升级 timewindow - 时间窗口
\n

返回头域

\n

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

\n

返回参数

\n

无返回内容。

\n

请求示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1PUT http://rds.bj.baidubce.com/v1/rds/instance/rds-RX7mPB1o?upgradeMajorVersion\n2Host: rds.bj.baidubce.com\n3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de\n4Content-Type: application/json\n5\n6{\n7  "targetMajorVersion": "8.0",\n8  "effectiveTime": "immediate"\n9}
\n
\n
\n
\n \n

返回示例

\n\n
\n
\n
\n Plain Text\n \n
\n
\n 
1HTTP/1.1 200 OK\n2Content-Type: application/json;charset=UTF-8\n3x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
\n
\n
\n
\n ","fields":{"slug":"smsh8tqde","title":"发起大版本升级API","date":"2026-08-06","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},{"value":"返回示例","depth":2}]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"smsh8tqde","prev":{"id":"Wmsh8pg7h","name":"大版本升级前置检查API","path":"Wmsh8pg7h","filePath":"API参考/版本管理/大版本升级前置检查API.md","seo":null,"parentIds":["Wjwvz0tzm","ulg1zisno"],"parents":[{"id":"Wjwvz0tzm","documentId":null,"name":"API参考","repoName":"RDS","filePath":"API参考","disabled":false,"path":"Wjwvz0tzm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"ulg1zisno","documentId":"4506ca6d-dcfb-43c7-9bbb-bba95728df35","name":"版本管理","repoName":"RDS","filePath":"API参考/版本管理","disabled":false,"path":"ulg1zisno","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}]},"next":{"id":"3kyvagf3r","name":"Performance","path":"3kyvagf3r","filePath":"API参考/Performance/Kill会话.md","seo":null,"parentIds":["Wjwvz0tzm","Rkyvagf2p"],"parents":[{"id":"Wjwvz0tzm","documentId":null,"name":"API参考","repoName":"RDS","filePath":"API参考","disabled":false,"path":"Wjwvz0tzm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"Rkyvagf2p","documentId":null,"name":"Performance","repoName":"RDS","filePath":"API参考/Performance","disabled":false,"path":"Rkyvagf2p","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}]},"parents":[{"id":"Wjwvz0tzm","documentId":null,"name":"API参考","repoName":"RDS","filePath":"API参考","disabled":false,"path":"Wjwvz0tzm","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null},{"id":"ulg1zisno","documentId":"4506ca6d-dcfb-43c7-9bbb-bba95728df35","name":"版本管理","repoName":"RDS","filePath":"API参考/版本管理","disabled":false,"path":"ulg1zisno","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":null}],"specificSeo":null}}}