You can call this operation to enable or disable authentication for a MongoDB instance to allow access from the same VPC as the instance.

Ensure that the instance meets the following conditions when you call this operation:

  • The instance type is replica set or sharded cluster.
  • The database version of the instance is 4.0, and the database minor version is mongodb_20190408_3.0.11 and later. You can call DescribeDBInstanceAttribute to query the version information. If the database version is earlier than the supported ones, you can call UpgradeDBInstanceEngineVersion to upgrade the database to a supported version.
  • The network type of the instance is VPC. If the network type is Classic Network, you can call ModifyDBInstanceNetworkType to switch the network type to VPC.

Debugging

OpenAPI Explorer simplifies API usage. You can use OpenAPI Explorer to perform debugging operations, such as retrieve APIs, call APIs, and dynamically generate SDK example code.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyInstanceVpcAuthMode

The operation that you want to perform. Set the value to ModifyInstanceVpcAuthMode.

DBInstanceId String Yes dds-bpxxxxxxxx

The ID of the instance.

VpcAuthMode String Yes Open

Indicates whether to enable authentication to allow access within a VPC. Valid values:

  • Open: Authentication is enabled.
  • Close: Authentication is disabled.
NodeId String No s-bpxxxxxxxx

The ID of the mongos in the specified sharded cluster instance.

Note This parameter can be used only when the instance type is sharded cluster.
AccessKeyId String No LTAIgbTGpxxxxxx

The AccessKey ID provided to you by Alibaba Cloud.

Response parameters

Parameter Type Example Description
RequestId String BA51E9D9-B14A-4542-B6E6-7DE00BECCB8C

The ID of the request.

Examples

Sample requests


http(s)://mongodb.aliyuncs.com/? Action=ModifyInstanceVpcAuthMode
&DBInstanceId=dds-bpxxxxxxxx
&VpcAuthMode=Open
&<Common request parameters>

Successful response examples

XML format

<ModifyInstanceVpcAuthModeResponse>
  <RequestId>BA51E9D9-B14A-4542-B6E6-7DE00BECCB8C</RequestId>
</ModifyInstanceVpcAuthModeResponse>

JSON format

{
	"RequestId":"BA51E9D9-B14A-4542-B6E6-7DE00BECCB8C"
}

Error codes

View error codes