You need to enable JavaScript to run this app.
Document Database for MongoDB

Document Database for MongoDB

Copy page
Download PDF
Instance management
ModifyDBInstanceName
Copy page
Download PDF
ModifyDBInstanceName
Call the ModifyDBInstanceName API to modify instance name of target MongoDB instance.​
Request type​
Asynchronous request.​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
InstanceId String required Sample value: mongo-replica-e405f8e2****​
Instance ID.​
tip​
You can call the DescribeDBInstances API to query basic information of all MongoDB instances in the target region, including the instance ID.​
​
InstanceNewName String required Sample value: test-mongo​
New instance name. You can customize the instance name as needed; uniqueness is not required for instance names. The name must meet the following requirements:​
  • It cannot start with a number or hyphen (-).​
  • It can only contain Chinese characters, letters, digits, underscores (_), and hyphens (-).​
  • The length should be 2 to 64 characters.​
​
​
Response parameters​
The current API has no specified response parameters. For more information, see Response structure.​
Example​
Request example​
​
POST https://mongodb.cn-beijing.volcengineapi.com/?Action=ModifyDBInstanceName&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-e405f8e2****",​
"InstanceNewName":"mongo-test"​
}​
​
Response example​
​
{​
"ResponseMetadata": {​
"RequestId": "2022022316053801021214504818071807",​
"Action": "ModifyDBInstanceName",​
"Version": "2022-01-01",​
"Service": "mongodb",​
"Region": "cn-beijing"​
},​
"Result": null​
}​
​
Error code​
For more details, see Error code.​
Last updated: 2026.07.23 14:28:26