You need to enable JavaScript to run this app.
文档中心
文档数据库 MongoDB 版

文档数据库 MongoDB 版

复制全文
下载 pdf
参数管理
ModifyMultiDBInstanceParameters
复制全文
下载 pdf
ModifyMultiDBInstanceParameters
调用 ModifyMultiDBInstanceParameters 接口修改目标 MongoDB 实例中的多个参数。
请求类型
异步请求。
注意事项
部分参数修改后,需要重启实例,新参数值才能生效。实例重启时间取决于实例的负载状态,重启过程中实例可能会出现 1~2 次闪断,请谨慎操作。建议在业务低峰期操作并增加应用重连机制,可以大幅降低数据库连接闪断对业务的影响。更多详情,请参见修改实例参数
调试
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
请求参数
InstanceId String 必选 示例值:mongo-shard-9a5545224522
实例 ID。
说明
您可以调用 DescribeDBInstances接口查询目标地域下所有 MongoDB 实例的基本信息,包括实例 ID。
ParameterObjects Object[] 必选 示例值:
需要修改的参数列表。
说明
如需修改多个参数,必须保证多个参数的 ParameterRole取值均一致。
ParameterName String 必选 示例值:cursorTimeoutMillis
目标参数的名称。
说明
您可以调用 DescribeDBInstanceParameters接口查询目标实例支持的参数详情,包括参数名称。
ParameterRole String 必选 示例值:Node
目标参数所属的节点类型,取值范围如下:
  • Node:副本集实例节点。
  • Shard:分片集群实例中的 Shard 节点。
  • ConfigServer:分片集群实例中的 ConfigServer 节点。
  • Mongos:分片集群实例中的 Mongos 节点。
说明
您可以调用 DescribeDBInstanceParameters接口查询目标实例支持的参数详情,包括参数所属的节点类型。
ParameterValue String 必选 示例值:600001
目标参数的取值。
说明
您可以调用 DescribeDBInstanceParameters 接口查询目标实例支持的参数详情,包括目标参数的取值范围(即 CheckingCode的值)。
返回参数
本接口无特有的返回参数。更多信息请见返回结构
示例
请求示例 1
同时修改副本集实例的 cursorTimeoutMillisjournalCommitInterval 参数值。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=ModifyMultiDBInstanceParameters&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId": "mongo-replica-8d67f589****",
"ParameterObjects": [
{
"ParameterName": "cursorTimeoutMillis",
"ParameterValue": "600001",
"ParameterRole": "Node"
},
{
"ParameterName": "disableJavaScriptJIT",
"ParameterValue": "false",
"ParameterRole": "Node"
}
]
}
返回示例 1
{
"ResponseMetadata": {
"RequestId": "20230604110420100232280022D31",
"Action": "ModifyMultiDBInstanceParameters",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-beijing"
},
"Result": null
}
请求示例 2
同时修改分片集群实例中 Shard 的 wiredTigerConcurrentWriteTransactionsnet.maxIncomingConnections 参数值。
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=ModifyMultiDBInstanceParameters&Version=2022-01-01 HTTP/1.1
Host: mongodb.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
"InstanceId": "mongo-shard-9a5545224522",
"ParameterObjects": [
{
"ParameterName": "net.maxIncomingConnections",
"ParameterValue": "Default",
"ParameterRole": "Shard"
},
{
"ParameterName": "wiredTigerConcurrentWriteTransactions",
"ParameterValue": "120",
"ParameterRole": "Shard"
}
]
}
返回示例 2
{
"ResponseMetadata": {
"RequestId": "20230604110420100232280022D31",
"Action": "ModifyMultiDBInstanceParameters",
"Version": "2022-01-01",
"Service": "mongodb",
"Region": "cn-beijing"
},
"Result": null
}
错误码
更多详情,请参见错误码
最近更新时间:2026.06.17 16:53:23
这个页面对您有帮助吗?
有用
有用
无用
无用