Alibaba Cloud v3.53.0, Apr 17 24

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

alicloud.mongodb.ShardingInstance

Explore with Pulumi AI

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

Provides a MongoDB Sharding Instance resource supports replica set instances only. the MongoDB provides stable, reliable, and automatic scalable database services. It offers a full range of database solutions, such as disaster recovery, backup, recovery, monitoring, and alarms. You can see detail product introduction here

NOTE: Available since v1.40.0.

NOTE: The following regions don’t support create Classic network MongoDB Sharding Instance. [cn-zhangjiakou,cn-huhehaote,ap-southeast-3,ap-southeast-5,me-east-1,ap-northeast-1,eu-west-1]

NOTE: Create MongoDB Sharding instance or change instance type and storage would cost 10~20 minutes. Please make full preparation.

Example Usage

Create a Mongodb Sharding instance

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";

const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const defaultZones = alicloud.mongodb.getZones({});
const index = defaultZones.then(defaultZones => defaultZones.zones).length.then(length => length - 1);
const zoneId = defaultZones.then(defaultZones => defaultZones.zones[index].id);
const defaultNetwork = new alicloud.vpc.Network("defaultNetwork", {
    vpcName: name,
    cidrBlock: "172.17.3.0/24",
});
const defaultSwitch = new alicloud.vpc.Switch("defaultSwitch", {
    vswitchName: name,
    cidrBlock: "172.17.3.0/24",
    vpcId: defaultNetwork.id,
    zoneId: zoneId,
});
const defaultShardingInstance = new alicloud.mongodb.ShardingInstance("defaultShardingInstance", {
    engineVersion: "4.2",
    vswitchId: defaultSwitch.id,
    zoneId: zoneId,
    mongoLists: [
        {
            nodeClass: "dds.mongos.mid",
        },
        {
            nodeClass: "dds.mongos.mid",
        },
    ],
    shardLists: [
        {
            nodeClass: "dds.shard.mid",
            nodeStorage: 10,
        },
        {
            nodeClass: "dds.shard.standard",
            nodeStorage: 20,
            readonlyReplicas: 1,
        },
    ],
});

import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
default_zones = alicloud.mongodb.get_zones()
index = len(default_zones.zones) - 1
zone_id = default_zones.zones[index].id
default_network = alicloud.vpc.Network("defaultNetwork",
    vpc_name=name,
    cidr_block="172.17.3.0/24")
default_switch = alicloud.vpc.Switch("defaultSwitch",
    vswitch_name=name,
    cidr_block="172.17.3.0/24",
    vpc_id=default_network.id,
    zone_id=zone_id)
default_sharding_instance = alicloud.mongodb.ShardingInstance("defaultShardingInstance",
    engine_version="4.2",
    vswitch_id=default_switch.id,
    zone_id=zone_id,
    mongo_lists=[
        alicloud.mongodb.ShardingInstanceMongoListArgs(
            node_class="dds.mongos.mid",
        ),
        alicloud.mongodb.ShardingInstanceMongoListArgs(
            node_class="dds.mongos.mid",
        ),
    ],
    shard_lists=[
        alicloud.mongodb.ShardingInstanceShardListArgs(
            node_class="dds.shard.mid",
            node_storage=10,
        ),
        alicloud.mongodb.ShardingInstanceShardListArgs(
            node_class="dds.shard.standard",
            node_storage=20,
            readonly_replicas=1,
        ),
    ])

package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/mongodb"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "terraform-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		defaultZones, err := mongodb.GetZones(ctx, nil, nil)
		if err != nil {
			return err
		}
		index := len(defaultZones.Zones) - 1
		zoneId := defaultZones.Zones[index].Id
		defaultNetwork, err := vpc.NewNetwork(ctx, "defaultNetwork", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("172.17.3.0/24"),
		})
		if err != nil {
			return err
		}
		defaultSwitch, err := vpc.NewSwitch(ctx, "defaultSwitch", &vpc.SwitchArgs{
			VswitchName: pulumi.String(name),
			CidrBlock:   pulumi.String("172.17.3.0/24"),
			VpcId:       defaultNetwork.ID(),
			ZoneId:      pulumi.String(zoneId),
		})
		if err != nil {
			return err
		}
		_, err = mongodb.NewShardingInstance(ctx, "defaultShardingInstance", &mongodb.ShardingInstanceArgs{
			EngineVersion: pulumi.String("4.2"),
			VswitchId:     defaultSwitch.ID(),
			ZoneId:        pulumi.String(zoneId),
			MongoLists: mongodb.ShardingInstanceMongoListArray{
				&mongodb.ShardingInstanceMongoListArgs{
					NodeClass: pulumi.String("dds.mongos.mid"),
				},
				&mongodb.ShardingInstanceMongoListArgs{
					NodeClass: pulumi.String("dds.mongos.mid"),
				},
			},
			ShardLists: mongodb.ShardingInstanceShardListArray{
				&mongodb.ShardingInstanceShardListArgs{
					NodeClass:   pulumi.String("dds.shard.mid"),
					NodeStorage: pulumi.Int(10),
				},
				&mongodb.ShardingInstanceShardListArgs{
					NodeClass:        pulumi.String("dds.shard.standard"),
					NodeStorage:      pulumi.Int(20),
					ReadonlyReplicas: pulumi.Int(1),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    var defaultZones = AliCloud.MongoDB.GetZones.Invoke();

    var index = defaultZones.Apply(getZonesResult => getZonesResult.Zones).Length.Apply(length => length - 1);

    var zoneId = defaultZones.Apply(getZonesResult => getZonesResult.Zones)[index].Id;

    var defaultNetwork = new AliCloud.Vpc.Network("defaultNetwork", new()
    {
        VpcName = name,
        CidrBlock = "172.17.3.0/24",
    });

    var defaultSwitch = new AliCloud.Vpc.Switch("defaultSwitch", new()
    {
        VswitchName = name,
        CidrBlock = "172.17.3.0/24",
        VpcId = defaultNetwork.Id,
        ZoneId = zoneId,
    });

    var defaultShardingInstance = new AliCloud.MongoDB.ShardingInstance("defaultShardingInstance", new()
    {
        EngineVersion = "4.2",
        VswitchId = defaultSwitch.Id,
        ZoneId = zoneId,
        MongoLists = new[]
        {
            new AliCloud.MongoDB.Inputs.ShardingInstanceMongoListArgs
            {
                NodeClass = "dds.mongos.mid",
            },
            new AliCloud.MongoDB.Inputs.ShardingInstanceMongoListArgs
            {
                NodeClass = "dds.mongos.mid",
            },
        },
        ShardLists = new[]
        {
            new AliCloud.MongoDB.Inputs.ShardingInstanceShardListArgs
            {
                NodeClass = "dds.shard.mid",
                NodeStorage = 10,
            },
            new AliCloud.MongoDB.Inputs.ShardingInstanceShardListArgs
            {
                NodeClass = "dds.shard.standard",
                NodeStorage = 20,
                ReadonlyReplicas = 1,
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.mongodb.MongodbFunctions;
import com.pulumi.alicloud.mongodb.inputs.GetZonesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.mongodb.ShardingInstance;
import com.pulumi.alicloud.mongodb.ShardingInstanceArgs;
import com.pulumi.alicloud.mongodb.inputs.ShardingInstanceMongoListArgs;
import com.pulumi.alicloud.mongodb.inputs.ShardingInstanceShardListArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("terraform-example");
        final var defaultZones = MongodbFunctions.getZones();

        final var index = defaultZones.applyValue(getZonesResult -> getZonesResult.zones()).length() - 1;

        final var zoneId = defaultZones.applyValue(getZonesResult -> getZonesResult.zones())[index].id();

        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()        
            .vpcName(name)
            .cidrBlock("172.17.3.0/24")
            .build());

        var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()        
            .vswitchName(name)
            .cidrBlock("172.17.3.0/24")
            .vpcId(defaultNetwork.id())
            .zoneId(zoneId)
            .build());

        var defaultShardingInstance = new ShardingInstance("defaultShardingInstance", ShardingInstanceArgs.builder()        
            .engineVersion("4.2")
            .vswitchId(defaultSwitch.id())
            .zoneId(zoneId)
            .mongoLists(            
                ShardingInstanceMongoListArgs.builder()
                    .nodeClass("dds.mongos.mid")
                    .build(),
                ShardingInstanceMongoListArgs.builder()
                    .nodeClass("dds.mongos.mid")
                    .build())
            .shardLists(            
                ShardingInstanceShardListArgs.builder()
                    .nodeClass("dds.shard.mid")
                    .nodeStorage("10")
                    .build(),
                ShardingInstanceShardListArgs.builder()
                    .nodeClass("dds.shard.standard")
                    .nodeStorage("20")
                    .readonlyReplicas("1")
                    .build())
            .build());

    }
}

Coming soon!

Module Support

You can use to the existing mongodb-sharding module to create a MongoDB Sharding Instance resource one-click.

Create ShardingInstance Resource

Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

Constructor syntax

new ShardingInstance(name: string, args: ShardingInstanceArgs, opts?: CustomResourceOptions);

@overload
def ShardingInstance(resource_name: str,
                     args: ShardingInstanceArgs,
                     opts: Optional[ResourceOptions] = None)

@overload
def ShardingInstance(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     engine_version: Optional[str] = None,
                     shard_lists: Optional[Sequence[ShardingInstanceShardListArgs]] = None,
                     mongo_lists: Optional[Sequence[ShardingInstanceMongoListArgs]] = None,
                     period: Optional[int] = None,
                     resource_group_id: Optional[str] = None,
                     instance_charge_type: Optional[str] = None,
                     kms_encrypted_password: Optional[str] = None,
                     kms_encryption_context: Optional[Mapping[str, Any]] = None,
                     backup_periods: Optional[Sequence[str]] = None,
                     name: Optional[str] = None,
                     network_type: Optional[str] = None,
                     order_type: Optional[str] = None,
                     account_password: Optional[str] = None,
                     protocol_type: Optional[str] = None,
                     backup_time: Optional[str] = None,
                     security_group_id: Optional[str] = None,
                     security_ip_lists: Optional[Sequence[str]] = None,
                     auto_renew: Optional[bool] = None,
                     storage_engine: Optional[str] = None,
                     tags: Optional[Mapping[str, Any]] = None,
                     tde_status: Optional[str] = None,
                     vpc_id: Optional[str] = None,
                     vswitch_id: Optional[str] = None,
                     zone_id: Optional[str] = None)

func NewShardingInstance(ctx *Context, name string, args ShardingInstanceArgs, opts ...ResourceOption) (*ShardingInstance, error)

public ShardingInstance(string name, ShardingInstanceArgs args, CustomResourceOptions? opts = null)

public ShardingInstance(String name, ShardingInstanceArgs args)
public ShardingInstance(String name, ShardingInstanceArgs args, CustomResourceOptions options)

type: alicloud:mongodb:ShardingInstance
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name string: The unique name of the resource.
args ShardingInstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

resource_name str: The unique name of the resource.
args ShardingInstanceArgs: The arguments to resource properties.
opts ResourceOptions: Bag of options to control resource's behavior.

ctx Context: Context object for the current deployment.
name string: The unique name of the resource.
args ShardingInstanceArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args ShardingInstanceArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args ShardingInstanceArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

Example

The following reference example uses placeholder values for all input properties.

var shardingInstanceResource = new AliCloud.MongoDB.ShardingInstance("shardingInstanceResource", new()
{
    EngineVersion = "string",
    ShardLists = new[]
    {
        new AliCloud.MongoDB.Inputs.ShardingInstanceShardListArgs
        {
            NodeClass = "string",
            NodeStorage = 0,
            NodeId = "string",
            ReadonlyReplicas = 0,
        },
    },
    MongoLists = new[]
    {
        new AliCloud.MongoDB.Inputs.ShardingInstanceMongoListArgs
        {
            NodeClass = "string",
            ConnectString = "string",
            NodeId = "string",
            Port = 0,
        },
    },
    Period = 0,
    ResourceGroupId = "string",
    InstanceChargeType = "string",
    KmsEncryptedPassword = "string",
    KmsEncryptionContext = 
    {
        { "string", "any" },
    },
    BackupPeriods = new[]
    {
        "string",
    },
    Name = "string",
    NetworkType = "string",
    OrderType = "string",
    AccountPassword = "string",
    ProtocolType = "string",
    BackupTime = "string",
    SecurityGroupId = "string",
    SecurityIpLists = new[]
    {
        "string",
    },
    AutoRenew = false,
    StorageEngine = "string",
    Tags = 
    {
        { "string", "any" },
    },
    TdeStatus = "string",
    VpcId = "string",
    VswitchId = "string",
    ZoneId = "string",
});

example, err := mongodb.NewShardingInstance(ctx, "shardingInstanceResource", &mongodb.ShardingInstanceArgs{
	EngineVersion: pulumi.String("string"),
	ShardLists: mongodb.ShardingInstanceShardListArray{
		&mongodb.ShardingInstanceShardListArgs{
			NodeClass:        pulumi.String("string"),
			NodeStorage:      pulumi.Int(0),
			NodeId:           pulumi.String("string"),
			ReadonlyReplicas: pulumi.Int(0),
		},
	},
	MongoLists: mongodb.ShardingInstanceMongoListArray{
		&mongodb.ShardingInstanceMongoListArgs{
			NodeClass:     pulumi.String("string"),
			ConnectString: pulumi.String("string"),
			NodeId:        pulumi.String("string"),
			Port:          pulumi.Int(0),
		},
	},
	Period:               pulumi.Int(0),
	ResourceGroupId:      pulumi.String("string"),
	InstanceChargeType:   pulumi.String("string"),
	KmsEncryptedPassword: pulumi.String("string"),
	KmsEncryptionContext: pulumi.Map{
		"string": pulumi.Any("any"),
	},
	BackupPeriods: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name:            pulumi.String("string"),
	NetworkType:     pulumi.String("string"),
	OrderType:       pulumi.String("string"),
	AccountPassword: pulumi.String("string"),
	ProtocolType:    pulumi.String("string"),
	BackupTime:      pulumi.String("string"),
	SecurityGroupId: pulumi.String("string"),
	SecurityIpLists: pulumi.StringArray{
		pulumi.String("string"),
	},
	AutoRenew:     pulumi.Bool(false),
	StorageEngine: pulumi.String("string"),
	Tags: pulumi.Map{
		"string": pulumi.Any("any"),
	},
	TdeStatus: pulumi.String("string"),
	VpcId:     pulumi.String("string"),
	VswitchId: pulumi.String("string"),
	ZoneId:    pulumi.String("string"),
})

var shardingInstanceResource = new ShardingInstance("shardingInstanceResource", ShardingInstanceArgs.builder()        
    .engineVersion("string")
    .shardLists(ShardingInstanceShardListArgs.builder()
        .nodeClass("string")
        .nodeStorage(0)
        .nodeId("string")
        .readonlyReplicas(0)
        .build())
    .mongoLists(ShardingInstanceMongoListArgs.builder()
        .nodeClass("string")
        .connectString("string")
        .nodeId("string")
        .port(0)
        .build())
    .period(0)
    .resourceGroupId("string")
    .instanceChargeType("string")
    .kmsEncryptedPassword("string")
    .kmsEncryptionContext(Map.of("string", "any"))
    .backupPeriods("string")
    .name("string")
    .networkType("string")
    .orderType("string")
    .accountPassword("string")
    .protocolType("string")
    .backupTime("string")
    .securityGroupId("string")
    .securityIpLists("string")
    .autoRenew(false)
    .storageEngine("string")
    .tags(Map.of("string", "any"))
    .tdeStatus("string")
    .vpcId("string")
    .vswitchId("string")
    .zoneId("string")
    .build());

sharding_instance_resource = alicloud.mongodb.ShardingInstance("shardingInstanceResource",
    engine_version="string",
    shard_lists=[alicloud.mongodb.ShardingInstanceShardListArgs(
        node_class="string",
        node_storage=0,
        node_id="string",
        readonly_replicas=0,
    )],
    mongo_lists=[alicloud.mongodb.ShardingInstanceMongoListArgs(
        node_class="string",
        connect_string="string",
        node_id="string",
        port=0,
    )],
    period=0,
    resource_group_id="string",
    instance_charge_type="string",
    kms_encrypted_password="string",
    kms_encryption_context={
        "string": "any",
    },
    backup_periods=["string"],
    name="string",
    network_type="string",
    order_type="string",
    account_password="string",
    protocol_type="string",
    backup_time="string",
    security_group_id="string",
    security_ip_lists=["string"],
    auto_renew=False,
    storage_engine="string",
    tags={
        "string": "any",
    },
    tde_status="string",
    vpc_id="string",
    vswitch_id="string",
    zone_id="string")

const shardingInstanceResource = new alicloud.mongodb.ShardingInstance("shardingInstanceResource", {
    engineVersion: "string",
    shardLists: [{
        nodeClass: "string",
        nodeStorage: 0,
        nodeId: "string",
        readonlyReplicas: 0,
    }],
    mongoLists: [{
        nodeClass: "string",
        connectString: "string",
        nodeId: "string",
        port: 0,
    }],
    period: 0,
    resourceGroupId: "string",
    instanceChargeType: "string",
    kmsEncryptedPassword: "string",
    kmsEncryptionContext: {
        string: "any",
    },
    backupPeriods: ["string"],
    name: "string",
    networkType: "string",
    orderType: "string",
    accountPassword: "string",
    protocolType: "string",
    backupTime: "string",
    securityGroupId: "string",
    securityIpLists: ["string"],
    autoRenew: false,
    storageEngine: "string",
    tags: {
        string: "any",
    },
    tdeStatus: "string",
    vpcId: "string",
    vswitchId: "string",
    zoneId: "string",
});

type: alicloud:mongodb:ShardingInstance
properties:
    accountPassword: string
    autoRenew: false
    backupPeriods:
        - string
    backupTime: string
    engineVersion: string
    instanceChargeType: string
    kmsEncryptedPassword: string
    kmsEncryptionContext:
        string: any
    mongoLists:
        - connectString: string
          nodeClass: string
          nodeId: string
          port: 0
    name: string
    networkType: string
    orderType: string
    period: 0
    protocolType: string
    resourceGroupId: string
    securityGroupId: string
    securityIpLists:
        - string
    shardLists:
        - nodeClass: string
          nodeId: string
          nodeStorage: 0
          readonlyReplicas: 0
    storageEngine: string
    tags:
        string: any
    tdeStatus: string
    vpcId: string
    vswitchId: string
    zoneId: string

ShardingInstance Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The ShardingInstance resource accepts the following input properties:

EngineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
MongoLists List<Pulumi.AliCloud.MongoDB.Inputs.ShardingInstanceMongoList>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
ShardLists List<Pulumi.AliCloud.MongoDB.Inputs.ShardingInstanceShardList>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
AccountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
AutoRenew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
BackupPeriods List<string>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
BackupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
InstanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
KmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
KmsEncryptionContext Dictionary<string, object>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
Name string: The name of DB instance. It must be 2 to 256 characters in length.
NetworkType string: The network type of the instance. Valid values:Classic or VPC.
OrderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
Period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
ProtocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
ResourceGroupId string: The ID of the Resource Group.
SecurityGroupId string: The Security Group ID of ECS.
SecurityIpLists List<string>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
StorageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
Tags Dictionary<string, object>: A mapping of tags to assign to the resource.
TdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
VpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
VswitchId string: The virtual switch ID to launch DB instances in one VPC.
ZoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

EngineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
MongoLists []ShardingInstanceMongoListArgs: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
ShardLists []ShardingInstanceShardListArgs: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
AccountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
AutoRenew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
BackupPeriods []string: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
BackupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
InstanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
KmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
KmsEncryptionContext map[string]interface{}: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
Name string: The name of DB instance. It must be 2 to 256 characters in length.
NetworkType string: The network type of the instance. Valid values:Classic or VPC.
OrderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
Period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
ProtocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
ResourceGroupId string: The ID of the Resource Group.
SecurityGroupId string: The Security Group ID of ECS.
SecurityIpLists []string: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
StorageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
Tags map[string]interface{}: A mapping of tags to assign to the resource.
TdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
VpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
VswitchId string: The virtual switch ID to launch DB instances in one VPC.
ZoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

engineVersion String: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
mongoLists List<ShardingInstanceMongoList>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
shardLists List<ShardingInstanceShardList>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
accountPassword String: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew Boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods List<String>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime String: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
instanceChargeType String: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword String: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext Map<String,Object>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
name String: The name of DB instance. It must be 2 to 256 characters in length.
networkType String: The network type of the instance. Valid values:Classic or VPC.
orderType String: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period Integer: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType String: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId String: The ID of the Resource Group.
securityGroupId String: The Security Group ID of ECS.
securityIpLists List<String>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
storageEngine String: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Map<String,Object>: A mapping of tags to assign to the resource.
tdeStatus String: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId String: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId String: The virtual switch ID to launch DB instances in one VPC.
zoneId String: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

engineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
mongoLists ShardingInstanceMongoList[]: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
shardLists ShardingInstanceShardList[]: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
accountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods string[]: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
instanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext {[key: string]: any}: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
name string: The name of DB instance. It must be 2 to 256 characters in length.
networkType string: The network type of the instance. Valid values:Classic or VPC.
orderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period number: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId string: The ID of the Resource Group.
securityGroupId string: The Security Group ID of ECS.
securityIpLists string[]: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
storageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags {[key: string]: any}: A mapping of tags to assign to the resource.
tdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId string: The virtual switch ID to launch DB instances in one VPC.
zoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

engine_version str: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
mongo_lists Sequence[ShardingInstanceMongoListArgs]: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
shard_lists Sequence[ShardingInstanceShardListArgs]: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
account_password str: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
auto_renew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
backup_periods Sequence[str]: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backup_time str: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
instance_charge_type str: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kms_encrypted_password str: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kms_encryption_context Mapping[str, Any]: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
name str: The name of DB instance. It must be 2 to 256 characters in length.
network_type str: The network type of the instance. Valid values:Classic or VPC.
order_type str: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocol_type str: The type of the access protocol. Valid values: mongodb or dynamodb.
resource_group_id str: The ID of the Resource Group.
security_group_id str: The Security Group ID of ECS.
security_ip_lists Sequence[str]: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
storage_engine str: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Mapping[str, Any]: A mapping of tags to assign to the resource.
tde_status str: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpc_id str: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitch_id str: The virtual switch ID to launch DB instances in one VPC.
zone_id str: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

engineVersion String: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
mongoLists List<Property Map>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
shardLists List<Property Map>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
accountPassword String: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew Boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods List<String>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime String: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
instanceChargeType String: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword String: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext Map<Any>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
name String: The name of DB instance. It must be 2 to 256 characters in length.
networkType String: The network type of the instance. Valid values:Classic or VPC.
orderType String: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period Number: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType String: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId String: The ID of the Resource Group.
securityGroupId String: The Security Group ID of ECS.
securityIpLists List<String>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
storageEngine String: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Map<Any>: A mapping of tags to assign to the resource.
tdeStatus String: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId String: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId String: The virtual switch ID to launch DB instances in one VPC.
zoneId String: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

Outputs

All input properties are implicitly available as output properties. Additionally, the ShardingInstance resource produces the following output properties:

ConfigServerLists List<Pulumi.AliCloud.MongoDB.Outputs.ShardingInstanceConfigServerList>: The information of the ConfigServer nodes.
Id string: The provider-assigned unique ID for this managed resource.
RetentionPeriod int: (Available since v1.42.0) Instance data backup retention days.

ConfigServerLists []ShardingInstanceConfigServerList: The information of the ConfigServer nodes.
Id string: The provider-assigned unique ID for this managed resource.
RetentionPeriod int: (Available since v1.42.0) Instance data backup retention days.

configServerLists List<ShardingInstanceConfigServerList>: The information of the ConfigServer nodes.
id String: The provider-assigned unique ID for this managed resource.
retentionPeriod Integer: (Available since v1.42.0) Instance data backup retention days.

configServerLists ShardingInstanceConfigServerList[]: The information of the ConfigServer nodes.
id string: The provider-assigned unique ID for this managed resource.
retentionPeriod number: (Available since v1.42.0) Instance data backup retention days.

config_server_lists Sequence[ShardingInstanceConfigServerList]: The information of the ConfigServer nodes.
id str: The provider-assigned unique ID for this managed resource.
retention_period int: (Available since v1.42.0) Instance data backup retention days.

configServerLists List<Property Map>: The information of the ConfigServer nodes.
id String: The provider-assigned unique ID for this managed resource.
retentionPeriod Number: (Available since v1.42.0) Instance data backup retention days.

Look up Existing ShardingInstance Resource

Get an existing ShardingInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: ShardingInstanceState, opts?: CustomResourceOptions): ShardingInstance

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_password: Optional[str] = None,
        auto_renew: Optional[bool] = None,
        backup_periods: Optional[Sequence[str]] = None,
        backup_time: Optional[str] = None,
        config_server_lists: Optional[Sequence[ShardingInstanceConfigServerListArgs]] = None,
        engine_version: Optional[str] = None,
        instance_charge_type: Optional[str] = None,
        kms_encrypted_password: Optional[str] = None,
        kms_encryption_context: Optional[Mapping[str, Any]] = None,
        mongo_lists: Optional[Sequence[ShardingInstanceMongoListArgs]] = None,
        name: Optional[str] = None,
        network_type: Optional[str] = None,
        order_type: Optional[str] = None,
        period: Optional[int] = None,
        protocol_type: Optional[str] = None,
        resource_group_id: Optional[str] = None,
        retention_period: Optional[int] = None,
        security_group_id: Optional[str] = None,
        security_ip_lists: Optional[Sequence[str]] = None,
        shard_lists: Optional[Sequence[ShardingInstanceShardListArgs]] = None,
        storage_engine: Optional[str] = None,
        tags: Optional[Mapping[str, Any]] = None,
        tde_status: Optional[str] = None,
        vpc_id: Optional[str] = None,
        vswitch_id: Optional[str] = None,
        zone_id: Optional[str] = None) -> ShardingInstance

func GetShardingInstance(ctx *Context, name string, id IDInput, state *ShardingInstanceState, opts ...ResourceOption) (*ShardingInstance, error)

public static ShardingInstance Get(string name, Input<string> id, ShardingInstanceState? state, CustomResourceOptions? opts = null)

public static ShardingInstance get(String name, Output<String> id, ShardingInstanceState state, CustomResourceOptions options)

Resource lookup is not supported in YAML

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

resource_name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

name: The unique name of the resulting resource.
id: The unique provider ID of the resource to lookup.
state: Any extra arguments used during the lookup.
opts: A bag of options that control this resource's behavior.

The following state arguments are supported:

AccountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
AutoRenew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
BackupPeriods List<string>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
BackupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
ConfigServerLists List<Pulumi.AliCloud.MongoDB.Inputs.ShardingInstanceConfigServerList>: The information of the ConfigServer nodes.
EngineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
InstanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
KmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
KmsEncryptionContext Dictionary<string, object>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
MongoLists List<Pulumi.AliCloud.MongoDB.Inputs.ShardingInstanceMongoList>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
Name string: The name of DB instance. It must be 2 to 256 characters in length.
NetworkType string: The network type of the instance. Valid values:Classic or VPC.
OrderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
Period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
ProtocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
ResourceGroupId string: The ID of the Resource Group.
RetentionPeriod int: (Available since v1.42.0) Instance data backup retention days.
SecurityGroupId string: The Security Group ID of ECS.
SecurityIpLists List<string>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
ShardLists List<Pulumi.AliCloud.MongoDB.Inputs.ShardingInstanceShardList>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
StorageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
Tags Dictionary<string, object>: A mapping of tags to assign to the resource.
TdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
VpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
VswitchId string: The virtual switch ID to launch DB instances in one VPC.
ZoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

AccountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
AutoRenew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
BackupPeriods []string: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
BackupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
ConfigServerLists []ShardingInstanceConfigServerListArgs: The information of the ConfigServer nodes.
EngineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
InstanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
KmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
KmsEncryptionContext map[string]interface{}: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
MongoLists []ShardingInstanceMongoListArgs: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
Name string: The name of DB instance. It must be 2 to 256 characters in length.
NetworkType string: The network type of the instance. Valid values:Classic or VPC.
OrderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
Period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
ProtocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
ResourceGroupId string: The ID of the Resource Group.
RetentionPeriod int: (Available since v1.42.0) Instance data backup retention days.
SecurityGroupId string: The Security Group ID of ECS.
SecurityIpLists []string: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
ShardLists []ShardingInstanceShardListArgs: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
StorageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
Tags map[string]interface{}: A mapping of tags to assign to the resource.
TdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
VpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
VswitchId string: The virtual switch ID to launch DB instances in one VPC.
ZoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

accountPassword String: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew Boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods List<String>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime String: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
configServerLists List<ShardingInstanceConfigServerList>: The information of the ConfigServer nodes.
engineVersion String: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
instanceChargeType String: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword String: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext Map<String,Object>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
mongoLists List<ShardingInstanceMongoList>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
name String: The name of DB instance. It must be 2 to 256 characters in length.
networkType String: The network type of the instance. Valid values:Classic or VPC.
orderType String: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period Integer: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType String: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId String: The ID of the Resource Group.
retentionPeriod Integer: (Available since v1.42.0) Instance data backup retention days.
securityGroupId String: The Security Group ID of ECS.
securityIpLists List<String>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
shardLists List<ShardingInstanceShardList>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
storageEngine String: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Map<String,Object>: A mapping of tags to assign to the resource.
tdeStatus String: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId String: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId String: The virtual switch ID to launch DB instances in one VPC.
zoneId String: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

accountPassword string: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods string[]: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime string: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
configServerLists ShardingInstanceConfigServerList[]: The information of the ConfigServer nodes.
engineVersion string: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
instanceChargeType string: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword string: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext {[key: string]: any}: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
mongoLists ShardingInstanceMongoList[]: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
name string: The name of DB instance. It must be 2 to 256 characters in length.
networkType string: The network type of the instance. Valid values:Classic or VPC.
orderType string: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period number: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType string: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId string: The ID of the Resource Group.
retentionPeriod number: (Available since v1.42.0) Instance data backup retention days.
securityGroupId string: The Security Group ID of ECS.
securityIpLists string[]: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
shardLists ShardingInstanceShardList[]: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
storageEngine string: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags {[key: string]: any}: A mapping of tags to assign to the resource.
tdeStatus string: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId string: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId string: The virtual switch ID to launch DB instances in one VPC.
zoneId string: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

account_password str: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
auto_renew bool: Auto renew for prepaid. Default value: false. Valid values: true, false.
backup_periods Sequence[str]: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backup_time str: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
config_server_lists Sequence[ShardingInstanceConfigServerListArgs]: The information of the ConfigServer nodes.
engine_version str: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
instance_charge_type str: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kms_encrypted_password str: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kms_encryption_context Mapping[str, Any]: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
mongo_lists Sequence[ShardingInstanceMongoListArgs]: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
name str: The name of DB instance. It must be 2 to 256 characters in length.
network_type str: The network type of the instance. Valid values:Classic or VPC.
order_type str: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period int: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocol_type str: The type of the access protocol. Valid values: mongodb or dynamodb.
resource_group_id str: The ID of the Resource Group.
retention_period int: (Available since v1.42.0) Instance data backup retention days.
security_group_id str: The Security Group ID of ECS.
security_ip_lists Sequence[str]: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
shard_lists Sequence[ShardingInstanceShardListArgs]: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
storage_engine str: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Mapping[str, Any]: A mapping of tags to assign to the resource.
tde_status str: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpc_id str: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitch_id str: The virtual switch ID to launch DB instances in one VPC.
zone_id str: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

accountPassword String: Password of the root account. It is a string of 6 to 32 characters and is composed of letters, numbers, and underlines.
autoRenew Boolean: Auto renew for prepaid. Default value: false. Valid values: true, false.
backupPeriods List<String>: MongoDB Instance backup period. It is required when backup_time was existed. Valid values: [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]. Default to [Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday]
backupTime String: Sharding Instance backup time. It is required when backup_period was existed. In the format of HH:mmZ- HH:mmZ. Time setting interval is one hour. If not set, the system will return a default, like "23:00Z-24:00Z".
configServerLists List<Property Map>: The information of the ConfigServer nodes.
engineVersion String: Database version. Value options can refer to the latest docs CreateDBInstance EngineVersion.
instanceChargeType String: The billing method of the instance. Default value: PostPaid. Valid values: PrePaid, PostPaid. NOTE: It can be modified from PostPaid to PrePaid after version v1.141.0.
kmsEncryptedPassword String: An KMS encrypts password used to a instance. If the account_password is filled in, this field will be ignored.
kmsEncryptionContext Map<Any>: An KMS encryption context used to decrypt kms_encrypted_password before creating or updating instance with kms_encrypted_password. See Encryption Context. It is valid when kms_encrypted_password is set.
mongoLists List<Property Map>: The mongo-node count can be purchased is in range of [2, 32]. See mongo_list below.
name String: The name of DB instance. It must be 2 to 256 characters in length.
networkType String: The network type of the instance. Valid values:Classic or VPC.
orderType String: The type of configuration changes performed. Default value: DOWNGRADE. Valid values:
period Number: The duration that you will buy DB instance (in month). It is valid when instance_charge_type is PrePaid. Default value: 1. Valid values: [1~9], 12, 24, 36.
protocolType String: The type of the access protocol. Valid values: mongodb or dynamodb.
resourceGroupId String: The ID of the Resource Group.
retentionPeriod Number: (Available since v1.42.0) Instance data backup retention days.
securityGroupId String: The Security Group ID of ECS.
securityIpLists List<String>: List of IP addresses allowed to access all databases of an instance. The list contains up to 1,000 IP addresses, separated by commas. Supported formats include 0.0.0.0/0, 10.23.12.24 (IP), and 10.23.12.24/24 (Classless Inter-Domain Routing (CIDR) mode. /24 represents the length of the prefix in an IP address. The range of the prefix length is [1,32]). System default to ["127.0.0.1"].
shardLists List<Property Map>: the shard-node count can be purchased is in range of [2, 32]. See shard_list below.
storageEngine String: The storage engine of the instance. Default value: WiredTiger. Valid values: WiredTiger, RocksDB.
tags Map<Any>: A mapping of tags to assign to the resource.
tdeStatus String: The TDE(Transparent Data Encryption) status. It can be updated from version 1.160.0.
vpcId String: The ID of the VPC. > NOTE: vpc_id is valid only when network_type is set to VPC.
vswitchId String: The virtual switch ID to launch DB instances in one VPC.
zoneId String: The Zone to launch the DB instance. MongoDB Sharding Instance does not support multiple-zone. If it is a multi-zone and vswitch_id is specified, the vswitch must in one of them.

Supporting Types

ShardingInstanceConfigServerList, ShardingInstanceConfigServerListArgs

ConnectString string

The connection address of the Config Server node.

MaxConnections int

The max connections of the Config Server node.

MaxIops int

The maximum IOPS of the Config Server node.

NodeClass string

The instance type of the mongo node. see Instance specifications.

NodeDescription string

The description of the Config Server node.

NodeId string

The ID of the Config Server node.

NodeStorage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

Port int

The connection port of the Config Server node.

ConnectString string

The connection address of the Config Server node.

MaxConnections int

The max connections of the Config Server node.

MaxIops int

The maximum IOPS of the Config Server node.

NodeClass string

The instance type of the mongo node. see Instance specifications.

NodeDescription string

The description of the Config Server node.

NodeId string

The ID of the Config Server node.

NodeStorage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

Port int

The connection port of the Config Server node.

connectString String

The connection address of the Config Server node.

maxConnections Integer

The max connections of the Config Server node.

maxIops Integer

The maximum IOPS of the Config Server node.

nodeClass String

The instance type of the mongo node. see Instance specifications.

nodeDescription String

The description of the Config Server node.

nodeId String

The ID of the Config Server node.

nodeStorage Integer

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

port Integer

The connection port of the Config Server node.

connectString string

The connection address of the Config Server node.

maxConnections number

The max connections of the Config Server node.

maxIops number

The maximum IOPS of the Config Server node.

nodeClass string

The instance type of the mongo node. see Instance specifications.

nodeDescription string

The description of the Config Server node.

nodeId string

The ID of the Config Server node.

nodeStorage number

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

port number

The connection port of the Config Server node.

connect_string str

The connection address of the Config Server node.

max_connections int

The max connections of the Config Server node.

max_iops int

The maximum IOPS of the Config Server node.

node_class str

The instance type of the mongo node. see Instance specifications.

node_description str

The description of the Config Server node.

node_id str

The ID of the Config Server node.

node_storage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

port int

The connection port of the Config Server node.

connectString String

The connection address of the Config Server node.

maxConnections Number

The max connections of the Config Server node.

maxIops Number

The maximum IOPS of the Config Server node.

nodeClass String

The instance type of the mongo node. see Instance specifications.

nodeDescription String

The description of the Config Server node.

nodeId String

The ID of the Config Server node.

nodeStorage Number

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

port Number

The connection port of the Config Server node.

ShardingInstanceMongoList, ShardingInstanceMongoListArgs

NodeClass string: The instance type of the mongo node. see Instance specifications.
ConnectString string: The connection address of the Config Server node.
NodeId string: The ID of the Config Server node.
Port int: The connection port of the Config Server node.

NodeClass string: The instance type of the mongo node. see Instance specifications.
ConnectString string: The connection address of the Config Server node.
NodeId string: The ID of the Config Server node.
Port int: The connection port of the Config Server node.

nodeClass String: The instance type of the mongo node. see Instance specifications.
connectString String: The connection address of the Config Server node.
nodeId String: The ID of the Config Server node.
port Integer: The connection port of the Config Server node.

nodeClass string: The instance type of the mongo node. see Instance specifications.
connectString string: The connection address of the Config Server node.
nodeId string: The ID of the Config Server node.
port number: The connection port of the Config Server node.

node_class str: The instance type of the mongo node. see Instance specifications.
connect_string str: The connection address of the Config Server node.
node_id str: The ID of the Config Server node.
port int: The connection port of the Config Server node.

nodeClass String: The instance type of the mongo node. see Instance specifications.
connectString String: The connection address of the Config Server node.
nodeId String: The ID of the Config Server node.
port Number: The connection port of the Config Server node.

ShardingInstanceShardList, ShardingInstanceShardListArgs

NodeClass string

The instance type of the shard node. see Instance specifications.

NodeStorage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

NodeId string

The ID of the Config Server node.

ReadonlyReplicas int

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

NodeClass string

The instance type of the shard node. see Instance specifications.

NodeStorage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

NodeId string

The ID of the Config Server node.

ReadonlyReplicas int

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

nodeClass String

The instance type of the shard node. see Instance specifications.

nodeStorage Integer

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

nodeId String

The ID of the Config Server node.

readonlyReplicas Integer

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

nodeClass string

The instance type of the shard node. see Instance specifications.

nodeStorage number

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

nodeId string

The ID of the Config Server node.

readonlyReplicas number

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

node_class str

The instance type of the shard node. see Instance specifications.

node_storage int

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

node_id str

The ID of the Config Server node.

readonly_replicas int

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

nodeClass String

The instance type of the shard node. see Instance specifications.

nodeStorage Number

The storage space of the shard node.

Custom storage space; value range: [10, 1,000]
10-GB increments. Unit: GB.

nodeId String

The ID of the Config Server node.

readonlyReplicas Number

The number of read-only nodes in shard node Default value: 0. Valid values: 0 to 5.

Import

MongoDB Sharding Instance can be imported using the id, e.g.

$ pulumi import alicloud:mongodb/shardingInstance:ShardingInstance example dds-bp1291daeda44195

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository: Alibaba Cloud pulumi/pulumi-alicloud
License: Apache-2.0
Notes: This Pulumi package is based on the alicloud Terraform Provider.

Alibaba Cloud v3.53.0 published on Wednesday, Apr 17, 2024 by Pulumi

pulumi/pulumi-alicloud

alicloud.mongodb.ShardingInstance

On this page

On this page

Example Usage

Create a Mongodb Sharding instance

Module Support

Create ShardingInstance Resource

Constructor syntax

Parameters

Example

ShardingInstance Resource Properties

Inputs

Outputs

Look up Existing ShardingInstance Resource

Supporting Types

ShardingInstanceConfigServerList, ShardingInstanceConfigServerListArgs

ShardingInstanceMongoList, ShardingInstanceMongoListArgs

ShardingInstanceShardList, ShardingInstanceShardListArgs

Import

Package Details

On this page

On this page