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​
同时修改副本集实例的 cursorTimeoutMillis 和 journalCommitInterval 参数值。​
​
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 的 wiredTigerConcurrentWriteTransactions 和 net.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
这个页面对您有帮助吗?
有用
有用
无用
无用