调用ALIYUN::POLARDB::DBCluster创建PolarDB集群 - 资源编排

ALIYUN::POLARDB::DBCluster类型用于创建PolarDB集群。

语法

{
  "Type": "ALIYUN::POLARDB::DBCluster",
  "Properties": {
    "VpcId": String,
    "DBClusterDescription": String,
    "DBType": String,
    "ClusterNetworkType": String,
    "RenewalStatus": String,
    "AutoRenewPeriod": Integer,
    "Period": Integer,
    "ZoneId": String,
    "SecurityGroupIds": List,
    "Tags": List,
    "SourceResourceId": String,
    "MaintainTime": String,
    "DBVersion": String,
    "CreationOption": String,
    "DBNodeClass": String,
    "VSwitchId": String,
    "SecurityIPList": String,
    "CloneDataPoint": String,
    "PayType": String,
    "CreationCategory": String,
    "BackupRetentionPolicyOnClusterDeletion": String,
    "ResourceGroupId": String,
    "DefaultTimeZone": String,
    "GDNId": String,
    "LowerCaseTableNames": Integer,
    "DBClusterParameters": Map,
    "TDEStatus": Boolean,
    "PeriodUnit": String,
    "ScaleRoNumMin": Integer,
    "ScaleMax": Integer,
    "AllowShutDown": Boolean,
    "ServerlessType": String,
    "ScaleRoNumMax": Integer,
    "ScaleMin": Integer,
    "StorageType": String,
    "LooseXEngine": String,
    "LoosePolarLogBin": String,
    "StorageSpace": Integer,
    "ProxyType": String,
    "StandbyAZ": String,
    "LooseXEngineUseMemoryPct": Integer,
    "StorageUpperBound": Integer,
    "StrictConsistency": String,
    "StoragePayType": String,
    "DBNodeNum": Integer,
    "ProxyClass": String,
    "HotStandbyCluster": String,
    "StorageAutoScale": String,
    "Architecture": String,
    "DBMinorVersion": String,
    "ParameterGroupId": String,
    "RestartMasterNode": Boolean,
    "ColdStorageOption": Map,
    "ProvisionedIops": Integer
  }
}

属性

属性名称	类型	必须	允许更新	描述	约束
VpcId	String	否	否	专有网络ID。	无
DBClusterDescription	String	否	是	集群描述。	长度为2~256个字符。以英文字母或汉字开头，不能以`http://`或`https://`开头。可包含英文字母、汉字、数字、半角逗号（,）和短划线（-）。
DBType	String	是	否	数据库引擎类型。	取值： MySQL PostgreSQL Oracle
ClusterNetworkType	String	否	否	集群网络类型。	当前仅支持专有网络，取值：VPC。
RenewalStatus	String	否	是	自动续费状态。	取值： AutoRenewal：自动续费。 Normal（默认值）：手动续费。 NotRenewal：不再续费。说明设置为NotRenewal后，系统不再发送到期提醒，只在到期前第三天发送不续费提醒。
AutoRenewPeriod	Integer	否	是	实例自动续费时长。	取值： 1（默认值） 2 3 6 12 24 36 单位：月。
Period	Integer	否	否	预付费类型（即PayType为Prepaid时）实例的时长。	取值： 1 2 3 4 5 6 7 8 9 12 24 36 单位：月。
ZoneId	String	否	否	可用区ID。	您可以通过DescribeRegions接口查询可选的可用区。
SourceResourceId	String	否	否	源RDS实例ID或源PolarDB集群ID。	当DBType取值为MySQL且DBVersion取值为5.6时，该参数有效。如果CreationOption值不等于Normal，该参数必填。
SecurityGroupIds	List	否	是	安全组ID列表。	最多支持3个安全组。
Tags	List	否	是	标签。	最多支持添加20个标签。更多信息，请参见Tags属性。
MaintainTime	String	否	是	集群的可维护时间。	格式：HH:mmZ-HH:mmZ。例如：16:00Z-17:00Z，表示0点到1点（UTC+08:00）可进行例行维护。
DBVersion	String	是	否	数据库版本号。	取值：当DBType取值为MySQL时：5.6、8.0。当DBType取值为PostgreSQL时：11。当DBType取值为Oracle时：11。
CreationOption	String	否	否	创建方式。	取值： Normal（默认值）：创建一个全新的PolarDB集群。 CloneFromPolarDB：从现有PolarDB集群克隆数据到新的PolarDB集群。 CloneFromRDS：从现有RDS实例克隆数据到新的PolarDB集群。 MigrationFromRDS：从现有RDS实例迁移数据到新的PolarDB集群。当DBType取值为MySQL且DBVersion取值为5.6时，该参数取值为CloneFromRDS或MigrationFromRDS。
DBNodeClass	String	是	否	节点规格。	更多信息，请参见计费项概览。
VSwitchId	String	否	否	交换机ID。	无
SecurityIPList	String	否	否	PolarDB集群白名单。	无
CloneDataPoint	String	否	否	克隆数据的时间节点。	取值： LATEST（默认值）：最新时间点的数据。说明当CreationOption取值为CloneFromRDS时，该参数取值为LATEST。 BackupID：历史备份集ID。 Timestamp：历史时间点，格式：`yyyy-MM-ddTHH:mm:ssZ`（UTC时间）。当DBType取值为MySQL且DBVersion取值为5.6，并且CreationOption取值为CloneFromRDS或CloneFromPolarDB时，该参数有效。
PayType	String	是	否	付费类型。	取值： Postpaid：按量付费。 Prepaid：预付费（包年包月）。
CreationCategory	String	否	否	集群系列。	取值：Normal（标准版）。
BackupRetentionPolicyOnClusterDeletion	String	否	否	删除集群时备份集保留策略。	取值： ALL：永久保留全部备份。 LATEST：永久保留最后一个备份（删除前自动备份）。 NONE（默认值）：集群删除时不保留备份集。说明仅当DBType取值为MySQL时，该参数生效。
ResourceGroupId	String	否	是	资源组ID。	无
DefaultTimeZone	String	否	否	集群时区（UTC）。	默认取值为SYSTEM，默认时区与Region所在时区一致。可选取值范围为-12:00~+13:00内的所有整数时间点，如 00:00。说明仅当DBType取值为MySQL时，该参数生效。
GDNId	String	否	否	全球数据库网络ID。	当CreationOption取值为CreateGdnStandby时，该参数必填。
LowerCaseTableNames	Integer	否	否	表名是否区分大小写。	取值： 1（默认值）：不区分大小写。 0：区分大小写。说明仅当DBType为MySQL时，该参数生效。
DBClusterParameters	Map	否	是	PolarDB集群的参数。	更多信息，请参见DBClusterParameters属性。
TDEStatus	Boolean	否	是	是否开启透明数据加密（TDE）。	取值： true：开启。说明 TDE功能开启后不可关闭。 false（默认值）：关闭。说明当DBType取值为PostgreSQL或DBType取值为Oracle时，该参数生效。
PeriodUnit	String	否	否	时长单位。	取值： Year：年。 Month：月。
ScaleRoNumMin	Integer	否	否	只读节点数的最小扩容和缩容限制。	无
ScaleMax	Integer	否	否	单节点扩容和缩容的最大限制。	无
AllowShutDown	Boolean	否	否	是否开启无活动暂停。	取值： true：开启无活动暂停。 false：关闭无活动暂停。
ServerlessType	String	否	否	Serverless服务类型。	取值：AgileServerless。
ScaleRoNumMax	Integer	否	否	只读节点数的最大扩容和缩容限制。	无
ScaleMin	Integer	否	否	单节点扩容和缩容的最小限制。	无
StorageType	String	否	否	存储类型。	企业版存储类型取值如下： PSL5 PSL4 标准版存储类型取值如下： ESSDPL1 ESSDPL2 ESSDPL3 说明 Serverless集群不支持该参数。
LooseXEngine	String	否	否	开启X-Engine存储引擎功能。	取值： ON：集群开启X-Engine引擎 OFF：集群关闭X-Engine引擎说明当参数CreationOption不等于CreateGdnStandby，DBType为MySQL且DBVersion为8.0时，该参数才生效。开启X-Engine引擎的节点内存规格必须大于等于16 GB。
LoosePolarLogBin	String	否	否	开启Binlog功能。	取值： ON：集群开启Binlog功能 OFF：集群关闭Binlog功能说明当参数DBType为MySQL时，该参数才生效。
StorageSpace	Integer	否	否	按空间计费（包年包月）的存储空间。	单位：GB。说明 PolarDB MySQL标准版存储空间的取值范围：20~32000。
ProxyType	String	否	否	数据库代理类型。	取值： OFF（默认）：关闭数据库代理。 EXCLUSIVE：企业独享版 GENERAL：企业通用版
StandbyAZ	String	否	否	存储热备集群的可用区。	适用于标准版3AZ场景。说明开启了多可用区数据强一致，该参数才生效。
LooseXEngineUseMemoryPct	Integer	否	否	设置开启X-Engine存储引擎比例。	取值范围10~90的整数。说明当参数LooseXEngine为ON时，该参数才生效。
StorageUpperBound	Integer	否	否	设置标准版集群存储自动扩容上限。	单位：GB。说明取值最大为32000。
StrictConsistency	String	否	否	集群是否开启了多可用区数据强一致。	取值： ON：表示开启了多可用区数据强一致，适用于标准版3AZ场景。 OFF：表示未开启多可用区数据强一致。
StoragePayType	String	否	否	存储计费类型。	取值： Postpaid：按容量计费（按量付费）。 Prepaid：按空间计费（包年包月）。
DBNodeNum	Integer	否	否	标准版节点个数。	取值： 1（默认）：表示只有1个读写节点。 2：表示有1个只读节点和1个读写节点。说明企业版默认有2个节点，标准版默认有1个节点。仅PolarDB MySQL版支持该参数。
ProxyClass	String	否	否	标准版数据库代理规格。	取值： polar.maxscale.g2.medium.c：2核。 polar.maxscale.g2.large.c：4核。 polar.maxscale.g2.xlarge.c：8核。 polar.maxscale.g2.2xlarge.c：16核。 polar.maxscale.g2.3xlarge.c：24核。 polar.maxscale.g2.4xlarge.c：32核。 polar.maxscale.g2.8xlarge.c：64核。
HotStandbyCluster	String	否	否	是否开启热备集群。	取值： ON（默认）：开启热备集群。 OFF：关闭热备集群。 STANDBY：标准版开启热备集群。说明标准版集群的默认值为STANDBY。
StorageAutoScale	String	否	否	标准版集群是否开启存储自动扩容。	取值： Enable：开启存储自动扩容。 Disable：关闭存储自动扩容。
Architecture	String	否	否	CPU 架构。	取值： X86 ARM
DBMinorVersion	String	否	否	数据库引擎小版本号。	取值： 8.0.2 8.0.1
ParameterGroupId	String	否	否	参数模板ID。	您可以通过DescribeParameterGroups接口查看目标地域的参数模板列表，包括参数模板ID。
RestartMasterNode	Boolean	否	否	是否重启主节点。	取值： true：重启主节点。 false：不重启主节点。
ColdStorageOption	Map	否	否	冷数据归档选项。	更多信息，请参见ColdStorageOption属性。
ProvisionedIops	Integer	否	否	ESSD AutoPL 云盘预配置的读写 IOPS。	可能值：0~min{50,000, 1000容量-基准性能}。基准性能=min{1,800+50容量, 50000}。说明当 StorageType 为 ESSDAUTOPL 时才支持该参数。

Tags语法

"Tags": [
  {
    "Key": String,
    "Value": String
  }
]

Tags属性

属性名称	类型	必须	允许更新	描述	约束
Key	String	是	否	标签键。	长度为1~128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://` 。
Value	String	否	否	标签值。	长度为0~128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://` 。

DBClusterParameters语法

"DBClusterParameters": {
  "Parameters": String,
  "EffectiveTime": String
}

DBClusterParameters属性

属性名称

类型

必须

允许更新

描述

约束

Parameters

String

否

是

参数及其值的JSON字符串。

参数的值都是字符串类型。

EffectiveTime

String

否

是

参数的生效时间。

取值：

Auto：自动确定何时生效。
Immediately：立即生效。
MaintainTime：集群维护期间生效。

ColdStorageOption语法

"ColdStorageOption": {
  "Description": String,
  "Enable": Boolean
}

ColdStorageOption属性

属性名称

类型

必须

允许更新

描述

约束

Description

String

否

描述信息。

如果设置了描述信息，则表示开启了冷数据归档功能。长度不超过256个字符。

Enable

Boolean

否

开启冷数据归档功能。

取值：

true
false

返回值

Fn::GetAtt

DBClusterId：集群ID。
OrderId：订单ID。
DBNodeIds：集群节点ID。
PrimaryEndpointId：主地址ID。
CustomEndpointIds：自定义集群地址ID。
CustomConnectionStrings：自定义连接串。
PrimaryConnectionString：主连接串。
ClusterConnectionString：自定义连接串。
ClusterEndpointId：集群地址ID。
PrimaryEndpointIds：集群主地址ID列表。
PrimaryConnectionStrings：集群主地址连接串列表。
ColdStorageInstanceId：冷数据库实例ID。
DBClusterDescription：集群描述。

示例

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  VpcId:
    AssociationProperty: ALIYUN::ECS::VPC::VPCId
    Type: String
    Description:
      en: Please search the ID starting with (vpc-xxx) from console-Virtual Private Cloud
      zh-cn: 现有虚拟专有网络的实例ID
    Label:
      en: VPC ID
      zh-cn: 专有网络VPC实例ID
  VSwitchZoneId:
    AssociationProperty: ALIYUN::ECS::Instance:ZoneId
    Type: String
    Description:
      zh-cn: 交换机可用区
      en: VSwitch Availability Zone
    Label:
      zh-cn: 交换机可用区
      en: VSwitch Availability Zone
  VSwitchId:
    AssociationProperty: ALIYUN::ECS::VSwitch::VSwitchId
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
      ZoneId: ${VSwitchZoneId}
    Type: String
    Description:
      en: Instance ID of existing business network switches, console-Virtual Private Cloud-VSwitches under query
      zh-cn: 现有业务网络交换机的实例ID
    Label:
      en: VSwitch ID
      zh-cn: 交换机实例ID
  DBType:
    Type: String
    Description: |-
      Database type, value:
      MySQL
      PostgreSQL
      Oracle
    Default: MySQL
  DBVersion:
    Type: String
    Description: |-
      The version of the database. Valid values:
      MySQL: 5.6 or 8.0
      PostgreSQL: 11
      Oracle: 11
    Default: '5.6'
  DBNodeClass:
    Type: String
    Description: The node specifications of the cluster. For more information, see Specifications and pricing.
    Default: polar.mysql.x4.medium
Resources:
  DBCluster:
    Type: ALIYUN::POLARDB::DBCluster
    Properties:
      VpcId:
        Ref: VpcId
      DBType:
        Ref: DBType
      ClusterNetworkType: VPC
      ZoneId:
        Ref: VSwitchZoneId
      VSwitchId:
        Ref: VSwitchId
      DBVersion:
        Ref: DBVersion
      DBNodeClass:
        Ref: DBNodeClass
      PayType: Postpaid
Outputs:
  DBClusterId:
    Description: The ID of the ApsaraDB for POLARDB cluster.
    Value:
      Fn::GetAtt:
        - DBCluster
        - DBClusterId

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "VpcId": {
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId",
      "Type": "String",
      "Description": {
        "en": "Please search the ID starting with (vpc-xxx) from console-Virtual Private Cloud",
        "zh-cn": "现有虚拟专有网络的实例ID"
      },
      "Label": {
        "en": "VPC ID",
        "zh-cn": "专有网络VPC实例ID"
      }
    },
    "VSwitchZoneId": {
      "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
      "Type": "String",
      "Description": {
        "zh-cn": "交换机可用区",
        "en": "VSwitch Availability Zone"
      },
      "Label": {
        "zh-cn": "交换机可用区",
        "en": "VSwitch Availability Zone"
      }
    },
    "VSwitchId": {
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}",
        "ZoneId": "${VSwitchZoneId}"
      },
      "Type": "String",
      "Description": {
        "en": "Instance ID of existing business network switches, console-Virtual Private Cloud-VSwitches under query",
        "zh-cn": "现有业务网络交换机的实例ID"
      },
      "Label": {
        "en": "VSwitch ID",
        "zh-cn": "交换机实例ID"
      }
    },
    "DBType": {
      "Type": "String",
      "Description": "Database type, value:\nMySQL\nPostgreSQL\nOracle",
      "Default": "MySQL"
    },
    "DBVersion": {
      "Type": "String",
      "Description": "The version of the database. Valid values:\nMySQL: 5.6 or 8.0\nPostgreSQL: 11\nOracle: 11",
      "Default": "5.6"
    },
    "DBNodeClass": {
      "Type": "String",
      "Description": "The node specifications of the cluster. For more information, see Specifications and pricing.",
      "Default": "polar.mysql.x4.medium"
    }
  },
  "Resources": {
    "DBCluster": {
      "Type": "ALIYUN::POLARDB::DBCluster",
      "Properties": {
        "VpcId": {
          "Ref": "VpcId"
        },
        "DBType": {
          "Ref": "DBType"
        },
        "ClusterNetworkType": "VPC",
        "ZoneId": {
          "Ref": "VSwitchZoneId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "DBVersion": {
          "Ref": "DBVersion"
        },
        "DBNodeClass": {
          "Ref": "DBNodeClass"
        },
        "PayType": "Postpaid"
      }
    }
  },
  "Outputs": {
    "DBClusterId": {
      "Description": "The ID of the ApsaraDB for POLARDB cluster.",
      "Value": {
        "Fn::GetAtt": [
          "DBCluster",
          "DBClusterId"
        ]
      }
    }
  }
}

更多示例，请参见创建PolarDB集群、为PolarDB数据库创建账号、在PolarDB集群下创建一个新的数据库、增加PolarDB集群节点、授权普通账号访问PolarDB集群的某个数据库、修改允许访问数据库集群的IP名单和创建PolarDB集群的公网地址的组合示例：YAML示例。