ALIYUN::MONGODB::Instance类型用于创建MongoDB副本集实例，同时也可用于克隆MongoDB副本集实例。

语法

{
  "Type": "ALIYUN::MONGODB::Instance",
  "Properties": {
    "DatabaseNames": String,
    "VpcPasswordFree": Boolean,
    "ReadonlyReplicas": Integer,
    "BusinessInfo": String,
    "AccountPassword": String,
    "VpcId": String,
    "AutoRenew": Boolean,
    "ResourceGroupId": String,
    "VSwitchId": String,
    "StorageEngine": String,
    "SrcDBInstanceId": String,
    "ReplicationFactor": Integer,
    "ZoneId": String,
    "EngineVersion": String,
    "RestoreTime": String,
    "DBInstanceStorage": Integer,
    "DBInstanceDescription": String,
    "CouponNo": String,
    "Period": Integer,
    "SecurityIPArray": String,
    "ChargeType": String,
    "BackupId": String,
    "DBInstanceClass": String,
    "NetworkType": String
  }
}

属性

属性名称 类型 必须 允许更新 描述 约束
VpcPasswordFree Boolean 否 否 是否为VPC网络中访问该实例启用免密码。 取值范围：
  • true
  • false
DBInstanceStorage Integer 是 否 数据库实例的大小。

取值范围：5~1000，必须是5的倍数。

单位：GB。
DBInstanceClass String 是 否 实例规格。 详情请参见实例规格表。
SrcDBInstanceId String 否 否 源实例ID。 只有当调用本接口进行克隆实例时，才能传入此参数，且必须和BackupId或RestoreTime参数一同传入。
DBInstanceDescription String 否 否 实例名称。
  • 长度为2~256个字符。
  • 以中文、英文字母开头，可以包含数字、中文、英文、下划线（_）、短横线（-）。
SecurityIPArray String 否 否 所有可以访问该实例的IP名单。

IP地址以英文逗号隔开，不可重复，最多1000个。

支持格式：0.0.0.0/0、10.23.XX.XX（IP）或者10.23.XX.XX/24（CIDR模式，无类域间路由。/24表示地址中前缀的长度，其取值范围：1~32）。

默认值：0.0.0.0/0，表示不指定IP白名单，即所有IP均可访问。
ZoneId String 否 否 可用区ID。 详情请参见DescribeRegions。在专有网络下，此参数取值需与VSwitchId的可用区保持一致。
VpcId String 否 否 专有网络ID。 只有当NetworkType取值为VPC时，此参数为有效参数。
VSwitchId String 否 否 VPC下的虚拟交换机ID 。 只有当NetworkType取值为VPC时，此参数为有效参数。
BackupId String 否 否 备份集ID。 只有调用本接口用于克隆实例时才能传入该参数，且必须和SrcDBInstanceId参数一同传入。
NetworkType String 否 否 网络类型。 取值范围：
  • CLASSIC
  • VPC

默认值： CLASSIC。
AccountPassword String 否 否 Root用户的密码。
  • 长度为8~32个字符。
  • 由字母、数字和特殊字符（!#$%^&*()_+-=）组成。
EngineVersion String 否 否 数据库版本号。 取值范围：3.2、3.4、4.0。

默认值：3.4。
StorageEngine String 否 否 存储引擎。 关于存储引擎与版本选择的约束详情，请参见版本及存储引擎。
取值范围：
  • WiredTiger
  • RocksDB
  • TerarkDB

默认值：WiredTiger。
ReplicationFactor Integer 否 否 副本集节点数。 取值范围：3、5、7。

默认值：3。
DatabaseNames String 否 否 数据库名。 无。
ReadonlyReplicas Integer 否 否 只读节点的数量。 取值范围：1、2、3、4、5。
BusinessInfo String 否 否 业务信息。 此参数为附加参数。
ResourceGroupId String 否 否 资源组的ID。 无。
AutoRenew Boolean 否 否 是否为实例启用自动续费。 取值范围：
  • true（自动续费）
  • false（手动续费）

默认值：false。
RestoreTime String 否 否 克隆实例时所恢复数据的时间点。 格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

只有调用本接口进行克隆实例时，才能传入此参数，且必须和SrcDBInstanceId、BackupId参数一同传入。支持选择7天内的任一时间点进行克隆。
CouponNo String 否 否 优惠券代码。 默认值：youhuiquan_promotion_option_id_for_blank。
Period Integer 否 否 实例的购买时长。 单位：月。

取值范围：1、2、3、4、5、6、7、8、9、12、24、36。

默认值：1。

只有当ChargeType取值为PrePaid时，此参数为有效参数。
ChargeType String 否 否 实例的付费类型。 取值范围：
  • PostPaid（按量付费）
  • PrePaid（预付费）

返回值

Fn::GetAtt

  • OrderId：创建MongoDB实例的订单ID。
  • DBInstanceId：MongoDB实例ID，全局唯一。
  • DBInstanceStatus：MongoDB实例的状态信息。
  • ConnectionURI：连接URI。
  • ReplicaSetName：副本集名称。

示例

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Resources": {
    "MongoDB": {
      "Type": "ALIYUN::MONGODB::Instance",
      "Properties": {
        "DBInstanceClass":"dds.mongo.mid",
        "DBInstanceStorage":"10",
        "VpcId": "vpc-25o8sqkwb",
        "VSwitchId": "vsw-25w8qld3m"
      }
    }
  },
  "Outputs": {
    "DBInstanceStatus": {
      "Description": "Status of mongodb instance.",
      "Value": {
        "Fn::GetAtt": [
          "MongoDB",
          "DBInstanceStatus"
        ]
      }
    },
    "InstanceId": {
      "Description": "The instance id of created mongodb instance.",
      "Value": {
        "Fn::GetAtt": [
          "MongoDB",
          "DBInstanceId"
        ]
      }
    }
  }
}