Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::POLARDB::DBCluster

Última actualización: Oct 13, 2026

El tipo de recurso ALIYUN::POLARDB::DBCluster crea un clúster de PolarDB.

Sintaxis

{
  "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,
    "DeletionProtection": Boolean,
    "SSLEnabled": String
  }
}

Propiedades

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

DBType

String

Sí

No

El tipo de motor de base de datos.

Valores válidos:

  • MySQL

  • PostgreSQL

  • Oracle

DBNodeClass

String

Sí

No

Las especificaciones del nodo.

Para obtener más información sobre las especificaciones de los nodos, consulte los siguientes temas:

Nota

Para crear un clúster serverless en PolarDB for MySQL Cluster Edition, establezca este parámetro en polar.mysql.sl.small.

Para crear un clúster serverless en PolarDB for MySQL Standard Edition, establezca este parámetro en polar.mysql.sl.small.c.

Para crear un clúster serverless en PolarDB for PostgreSQL (compatible con Oracle) o PolarDB for PostgreSQL, establezca este parámetro en polar.pg.sl.small.c.

DBVersion

String

Sí

No

La versión de la base de datos.

Valores válidos:

  • El rango válido para los números de versión de MySQL es el siguiente:

    • 5.6

    • 5.7

    • 8.0

  • El rango de números de versión de PostgreSQL es el siguiente:

    • 11

    • 14

    • 15

      Nota

      Si crea un clúster serverless en PolarDB for PostgreSQL, solo se admite la versión 14.

  • Los números de versión de Oracle deben estar dentro del siguiente rango:

    • 11

    • 14

PayType

String

Sí

Sí

El método de facturación.

Valores válidos:

  • Postpaid: pay-as-you-go.

  • Prepaid: suscripción.

AutoRenewPeriod

Integer

No

Sí

El periodo de renovación automática de la instancia.

Valores válidos:

  • 1 (predeterminado)

  • 2

  • 3

  • 6

  • 12

  • 24

  • 36

Unidad: meses.

DBClusterDescription

String

No

Sí

La descripción del clúster.

La descripción debe tener entre 2 y 256 caracteres. Debe comenzar con una letra o un carácter chino y no puede empezar con http:// ni con https://. Puede contener letras, caracteres chinos, dígitos, comas (,) y guiones (-).

ClusterNetworkType

String

No

No

El tipo de red del clúster.

Solo se admite VPC. Valor válido: VPC.

RenewalStatus

String

No

Sí

El estado de la renovación automática.

Valores válidos:

  • AutoRenewal: la renovación automática está habilitada.

  • Normal (predeterminado): renovación manual.

  • NotRenewal: la renovación automática está deshabilitada.

    Nota

    Si establece este parámetro en NotRenewal, el sistema deja de enviar recordatorios de vencimiento y envía únicamente uno tres días antes de que venza el servicio.

Period

Integer

No

Sí

La duración de la suscripción. Este parámetro surte efecto solo cuando PayType se establece en Prepaid.

Valores válidos:

  • 1

  • 2

  • 3

  • 4

  • 5

  • 6

  • 7

  • 8

  • 9

  • 12

  • 24

  • 36

Unidad: meses.

ZoneId

String

No

No

El identificador de la zona.

Puede llamar a la operación DescribeRegions para consultar las zonas disponibles.

SourceResourceId

String

No

No

El identificador de la instancia RDS de origen o del clúster PolarDB de origen.

El identificador de la instancia RDS de origen o del clúster PolarDB de origen. Este parámetro es obligatorio solo cuando CreationOption se establece en MigrationFromRDS, CloneFromRDS, CloneFromPolarDB o RecoverFromRecyclebin.

  • Si CreationOption se establece en MigrationFromRDS o CloneFromRDS, especifique el identificador de la instancia RDS de origen. Dicha instancia debe ejecutar RDS for MySQL 5.6, 5.7 u 8.0 High-availability Edition.

  • Si CreationOption se establece en CloneFromPolarDB, especifique el identificador del clúster PolarDB de origen. El valor de DBType del clúster clonado coincide de forma predeterminada con el del clúster de origen. Por ejemplo, si el clúster de origen ejecuta MySQL 8.0, establezca DBType en MySQL y DBVersion en 8.0 para el clúster clonado.

  • Si CreationOption se establece en RecoverFromRecyclebin, especifique el identificador del clúster PolarDB de origen liberado. El valor de DBType del clúster restaurado debe coincidir con el del clúster de origen. Por ejemplo, si el clúster de origen ejecuta MySQL 8.0, establezca DBType en MySQL y DBVersion en 8.0 para el clúster restaurado.

SecurityGroupIds

List

No

Sí

La lista de identificadores de security group.

Se pueden especificar hasta tres security groups.

Tags

List

No

Sí

Las etiquetas.

Se pueden agregar hasta 20 etiquetas.

Para obtener más información, consulte Tags properties.

MaintainTime

String

No

Sí

La ventana de mantenimiento del clúster.

Formato: HH:mmZ-HH:mmZ. Ejemplo: 16:00Z-17:00Z, lo que indica una ventana de mantenimiento de 00:00 a 01:00 (UTC+8).

CreationOption

String

No

No

El método de creación.

Valores válidos:

Valor predeterminado: Normal.

Nota

Si DBType se establece en MySQL y DBVersion en 8.0, este parámetro se puede configurar en CreateGdnStandby.

VSwitchId

String

No

No

El identificador del vSwitch.

Ninguna

SecurityIPList

String

No

No

La lista blanca de direcciones IP del clúster PolarDB.

Nota

Se pueden especificar varias direcciones IP en la lista blanca. Sepárelas con comas (,).

CloneDataPoint

String

No

No

El punto en el tiempo para clonar los datos.

Valores válidos:

  • LATEST (predeterminado): el punto en el tiempo más reciente.

    Nota

    Si CreationOption se establece en CloneFromRDS, este parámetro debe configurarse en LATEST.

  • BackupID: el identificador de un conjunto de copias de seguridad histórico.

  • Timestamp: un punto en el tiempo histórico. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).

Nota

Si CreationOption se establece en CloneFromRDS, este parámetro debe configurarse en LATEST.

CreationCategory

String

No

No

La edición del clúster.

Valores válidos:

  • Normal: Cluster Edition (predeterminado)

  • Basic: nodo único

  • ArchiveNormal: X-Engine con alta compresión

  • NormalMultimaster: Multi-master Cluster Edition

  • SENormal: Standard Edition

Nota

Basic es compatible con MySQL 5.6, 5.7, 8.0, PostgreSQL 14 y sintaxis compatible con Oracle 2.0.

ArchiveNormal y NormalMultimaster son compatibles con MySQL 8.0.

SENormal es compatible con MySQL 5.6, 5.7, 8.0 y PostgreSQL 14.

BackupRetentionPolicyOnClusterDeletion

String

No

No

La política de retención de copias de seguridad al eliminar el clúster.

Valores válidos:

  • ALL: conserva permanentemente todas las copias de seguridad.

  • LATEST: conserva permanentemente la última copia de seguridad (la copia automática previa a la eliminación).

  • NONE (predeterminado): no conserva las copias de seguridad al eliminar el clúster.

De forma predeterminada, este parámetro se establece en NONE, lo que significa que no se conservan copias de seguridad al eliminar el clúster.

Nota
  • Este parámetro surte efecto solo cuando DBType se establece en MySQL.

  • Este parámetro no es compatible con los clústeres serverless.

ResourceGroupId

String

No

Sí

El identificador del resource group.

Ninguna

DefaultTimeZone

String

No

No

La zona horaria del clúster (UTC).

Valor predeterminado: SYSTEM. La zona horaria predeterminada coincide con la de la región.

Los valores válidos van de -12:00 a +13:00, por ejemplo, 00:00.

Nota

Este parámetro surte efecto solo cuando DBType se establece en MySQL.

GDNId

String

No

No

El identificador de Global Database Network.

Este parámetro es obligatorio cuando CreationOption se establece en CreateGdnStandby.

LowerCaseTableNames

Integer

No

No

Indica si los nombres de las tablas distinguen entre mayúsculas y minúsculas.

Valores válidos:

  • 1 (predeterminado): no distingue entre mayúsculas y minúsculas.

  • 0: la operación distingue entre mayúsculas y minúsculas.

Nota

Este parámetro surte efecto solo cuando DBType se establece en MySQL.

DBClusterParameters

Map

No

Sí

Los parámetros del clúster PolarDB.

Para obtener más información, consulte DBClusterParameters properties.

DeletionProtection

Boolean

No

Sí

Indica si la protección contra eliminación está habilitada.

Valores válidos:

  • true: la protección contra eliminación está habilitada.

  • false (predeterminado): la protección contra eliminación está deshabilitada.

TDEStatus

Boolean

No

Sí

Indica si el cifrado transparente de datos (TDE) está habilitado.

Valores válidos:

  • true: habilita la función.

    Nota

    Una vez habilitado TDE, no se puede deshabilitar.

  • false (predeterminado): desactivado.

Nota

Este parámetro surte efecto solo cuando DBType se establece en PostgreSQL u Oracle.

PeriodUnit

String

No

Sí

La unidad de tiempo.

Valores válidos:

  • Year

  • Month

ScaleRoNumMin

Integer

No

No

El número mínimo de nodos de solo lectura para escalar horizontalmente.

Valores válidos: de 0 a 15.

Nota

Este parámetro solo es compatible con los clústeres serverless.

ScaleMax

Integer

No

No

La capacidad máxima para escalar un solo nodo.

Valores válidos: de 1 PCU a 32 PCU.

Nota

Este parámetro solo es compatible con los clústeres serverless.

AllowShutDown

Boolean

No

No

Indica si la suspensión por inactividad está habilitada.

Valores válidos:

  • true: la suspensión por inactividad está habilitada.

  • false: la suspensión por inactividad está deshabilitada.

Nota

Este parámetro solo es compatible con los clústeres serverless.

ServerlessType

String

No

No

El tipo de servicio serverless.

Valor válido: AgileServerless.

Nota

Este parámetro solo es compatible con los clústeres serverless.

ScaleRoNumMax

Integer

No

No

El número máximo de nodos de solo lectura para escalar horizontalmente.

Valores válidos: de 0 a 15.

Nota

Este parámetro solo es compatible con los clústeres serverless.

ScaleMin

Integer

No

No

La capacidad mínima para escalar un solo nodo.

Valores válidos: de 1 PCU a 31 PCU.

Nota

Este parámetro solo es compatible con los clústeres serverless.

SSLEnabled

String

No

Sí

Modifica el estado de SSL.

Valores válidos:

  • Disable: deshabilita el cifrado SSL.

  • Enable: habilita el cifrado SSL.

  • Update: actualiza el certificado SSL.

StorageType

String

No

No

La clase de almacenamiento.

Valores válidos para Enterprise Edition:

  • PSL5

  • PSL4

Valores válidos para Standard Edition:

  • ESSDPL0

  • ESSDPL1

  • ESSDPL2

  • ESSDPL3

  • ESSDAUTOPL

LooseXEngine

String

No

No

Habilita el motor de almacenamiento X-Engine.

Valores válidos:

  • ON: habilita el motor de almacenamiento X-Engine.

  • OFF: deshabilita el motor de almacenamiento X-Engine.

Nota

Este parámetro surte efecto solo cuando CreationOption no se establece en CreateGdnStandby, DBType se configura en MySQL y DBVersion en 8.0. La memoria de los nodos con X-Engine habilitado debe ser como mínimo de 16 GB.

LoosePolarLogBin

String

No

No

Habilita el registro binario.

Valores válidos:

  • ON: habilita el registro binario.

  • OFF: deshabilita el registro binario.

Nota

Este parámetro surte efecto solo cuando DBType se establece en MySQL.

StorageSpace

Integer

No

No

El espacio de almacenamiento para la facturación por suscripción.

Unidad: GB.

Nota
  • Para PolarDB for MySQL Standard Edition, los valores válidos van de 20 a 32000.

  • Si StorageType se establece en ESSDAUTOPL, los valores válidos van de 40 a 64000 con un incremento mínimo de 10 (por ejemplo, 40, 50, 60, ...).

ProxyType

String

No

No

El tipo de proxy de la base de datos.

Valores válidos:

  • EXCLUSIVE: Dedicated Enterprise Edition

  • GENERAL: Standard Enterprise Edition

Nota

El tipo de proxy debe coincidir con las especificaciones del nodo:

Si las especificaciones del nodo son de uso general, establezca ProxyType en Standard Enterprise Edition.

Si las especificaciones del nodo son dedicadas, establezca ProxyType en Dedicated Enterprise Edition.

StandbyAZ

String

No

No

La zona del clúster de almacenamiento en espera activa.

Este parámetro aplica a los clústeres Standard Edition en un escenario de tres zonas.

Nota

Este parámetro surte efecto solo cuando la consistencia fuerte entre varias zonas está habilitada.

LooseXEngineUseMemoryPct

Integer

No

No

Establezca el porcentaje de memoria a partir del cual se habilita el motor de almacenamiento X-Engine.

Valores válidos: números enteros del 10 al 90.

Nota

Este parámetro surte efecto solo cuando LooseXEngine se establece en ON.

StorageUpperBound

Integer

No

No

El límite superior para el escalado automático de almacenamiento en clústeres Standard Edition.

Unidad: GB.

Nota

El valor máximo es 32000.

StrictConsistency

String

No

No

Indica si la consistencia fuerte entre varias zonas está habilitada.

Valores válidos:

  • ON: la consistencia fuerte entre varias zonas está habilitada. Esta configuración aplica a los clústeres Standard Edition en un escenario de tres zonas.

  • OFF: la consistencia fuerte entre varias zonas está deshabilitada.

StoragePayType

String

No

No

El método de facturación del almacenamiento.

Valores válidos:

  • Postpaid: modelo pay-as-you-go basado en la capacidad.

  • Prepaid: suscripción basada en el espacio de almacenamiento.

DBNodeNum

Integer

No

No

El número de nodos para los clústeres Standard Edition y Enterprise Edition.

Valores válidos:

  • Standard Edition: de 1 a 8 (1 nodo de lectura/escritura y hasta 7 nodos de solo lectura).

  • Enterprise Edition: de 1 a 16 (1 nodo de lectura/escritura y hasta 15 nodos de solo lectura).

Nota
  • Los clústeres Enterprise Edition tienen 2 nodos de forma predeterminada. Los clústeres Standard Edition tienen 1 nodo de forma predeterminada.

  • Este parámetro solo es compatible con PolarDB for MySQL.

  • No se admite modificar el número de nodos en los clústeres multi-master.

ProxyClass

String

No

No

Las especificaciones del proxy de base de datos para los clústeres Standard Edition.

Valores válidos:

  • polar.maxscale.g2.medium.c: 2 núcleos

  • polar.maxscale.g2.large.c: 4 núcleos

  • polar.maxscale.g2.xlarge.c: 8 núcleos

  • polar.maxscale.g2.2xlarge.c: 16 núcleos

  • polar.maxscale.g2.3xlarge.c: 24 núcleos

  • polar.maxscale.g2.4xlarge.c: 32 núcleos

  • polar.maxscale.g2.8xlarge.c: 64 núcleos

HotStandbyCluster

String

No

No

Indica si el clúster en espera activa está habilitado.

Valores válidos:

  • ON (predeterminado): habilita el clúster en espera activa.

  • OFF: deshabilita el clúster en espera activa.

  • STANDBY: habilita el clúster en espera activa para Standard Edition.

Nota

El valor predeterminado para los clústeres Standard Edition es STANDBY.

StorageAutoScale

String

No

No

Indica si el escalado automático de almacenamiento está habilitado para los clústeres Standard Edition.

Valores válidos:

  • Enable: habilita el escalado automático de almacenamiento.

  • Disable: deshabilita el escalado automático de almacenamiento.

Architecture

String

No

No

La arquitectura de CPU.

Valores válidos:

  • X86

  • ARM

DBMinorVersion

String

No

No

La versión secundaria del motor de base de datos.

Valores válidos:

  • 8.0.2

  • 8.0.1

Nota

Este parámetro surte efecto solo cuando DBType se establece en MySQL y DBVersion en 8.0.

VpcId

String

No

No

El identificador de la VPC.

Ninguna

ParameterGroupId

String

No

No

El identificador de la plantilla de parámetros.

Puede llamar a la operación DescribeParameterGroups para consultar la lista y los identificadores de plantillas de parámetros en la región de destino.

RestartMasterNode

Boolean

No

No

Indica si se debe reiniciar el nodo principal.

Valores válidos:

  • true: reinicia el nodo principal.

  • false: no reinicia el nodo principal.

ColdStorageOption

Map

No

No

Las opciones de archivado de datos fríos.

Para obtener más información, consulte ColdStorageOption properties.

ProvisionedIops

Integer

No

No

Las IOPS aprovisionadas para discos ESSD AutoPL.

Valores válidos: de 0 a min{50,000, 1000 × capacidad − rendimiento base}.

Rendimiento base = min{1,800 + 50 × capacidad, 50,000}.

Nota

Este parámetro solo es compatible cuando StorageType se establece en ESSDAUTOPL.

Sintaxis de Tags

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

Propiedades de Tags

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

Key

String

Sí

No

La clave de la etiqueta.

La clave debe tener entre 1 y 128 caracteres. No puede comenzar con aliyun ni con acs:, y no puede contener http:// ni https://.

Value

String

No

No

El valor de la etiqueta.

El valor debe tener entre 0 y 128 caracteres. No puede comenzar con aliyun ni con acs:, y no puede contener http:// ni https://.

Sintaxis de DBClusterParameters

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

Propiedades de DBClusterParameters

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

Parameters

String

No

Sí

Cadena JSON con los parámetros y sus valores.

Todos los valores de los parámetros son cadenas.

EffectiveTime

String

No

Sí

Hora en que los parámetros entran en vigor.

Valores válidos:

  • Auto: determina automáticamente cuándo entran en vigor los parámetros.

  • Immediately: el efecto es inmediato.

  • MaintainTime: esta configuración entra en vigor durante el periodo de mantenimiento del clúster.

Sintaxis de ColdStorageOption

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

Propiedades de ColdStorageOption

Nombre de la propiedad

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

Description

String

No

No

La descripción.

Si se especifica una descripción, se habilita el archivado de datos fríos. La descripción puede tener hasta 256 caracteres.

Enable

Boolean

No

No

Habilite el archivado de datos fríos.

Valores válidos:

  • true

  • false

Valores de retorno

Fn::GetAtt

  • DBClusterId: el ID del clúster.

  • OrderId: el ID del pedido.

  • DBNodeIds: los ID de los nodos del clúster.

  • PrimaryEndpointId: el ID del endpoint principal.

  • CustomEndpointIds: los ID de los endpoints personalizados del clúster.

  • CustomConnectionStrings: las cadenas de conexión personalizadas.

  • PrimaryConnectionString: la cadena de conexión principal.

  • ClusterConnectionString: la cadena de conexión del clúster.

  • ClusterEndpointId: el ID del endpoint del clúster.

  • PrimaryEndpointIds: la lista de ID de endpoints principales.

  • PrimaryConnectionStrings: la lista de cadenas de conexión de los endpoints principales.

  • ColdStorageInstanceId: el ID de la instancia de base de datos fría.

  • DBClusterDescription: la descripción del clúster.

  • Arn: el Alibaba Cloud Resource Name.

Ejemplos

Escenario 1: cree un clúster de PolarDB de tipo MySQL.

Primeros pasos

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: Existing VPC instance ID
    Label:
      en: VPC ID
      zh-cn: VPC instance ID
  VSwitchZoneId:
    AssociationProperty: ALIYUN::ECS::Instance:ZoneId
    Type: String
    Description:
      zh-cn: vSwitch zone
      en: VSwitch Availability Zone
    Label:
      zh-cn: vSwitch zone
      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: Existing business network vSwitch instance ID
    Label:
      en: VSwitch ID
      zh-cn: vSwitch instance 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
{
  "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": "Existing VPC instance ID"
      },
      "Label": {
        "en": "VPC ID",
        "zh-cn": "VPC instance ID"
      }
    },
    "VSwitchZoneId": {
      "AssociationProperty": "ALIYUN::ECS::Instance:ZoneId",
      "Type": "String",
      "Description": {
        "zh-cn": "vSwitch zone",
        "en": "VSwitch Availability Zone"
      },
      "Label": {
        "zh-cn": "vSwitch zone",
        "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": "Existing business network vSwitch instance ID"
      },
      "Label": {
        "en": "VSwitch ID",
        "zh-cn": "vSwitch instance 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"
        ]
      }
    }
  }
}

Escenario 2: cree un clúster de PolarDB de tipo PostgreSQL.

Primeros pasos

ROSTemplateFormatVersion: '2015-09-01'
Resources:
  VPC:
    Type: ALIYUN::ECS::VPC
    Properties:
      VpcName: polardb-test
      CidrBlock: 192.168.0.0/16
  VSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      VSwitchName: polardb-test
      VpcId:
        Ref: VPC
      CidrBlock: 192.168.1.0/24
      ZoneId: cn-beijing-k
  PolardbCluster:
    Type: ALIYUN::POLARDB::DBCluster
    Properties:
      VpcId:
        Ref: VPC
      CreationCategory: Normal
      StorageType: PSL5
      DBType: PostgreSQL
      ClusterNetworkType: VPC
      DBVersion: '16'
      PayType: Postpaid
      ZoneId: cn-beijing-k
      VSwitchId:
        Ref: VSwitch
      DBNodeClass: polar.pg.sl.small
      SecurityIPList: 0.0.0.0/0
      ServerlessType: AgileServerless
      ScaleMin: 1
      ScaleMax: 3
      ScaleRoNumMin: 1
      ScaleRoNumMax: 2
      HotStandbyCluster: 'OFF'
  
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Resources": {
    "VPC": {
      "Type": "ALIYUN::ECS::VPC",
      "Properties": {
        "VpcName": "polardb-test",
        "CidrBlock": "192.168.0.0/16"
      }
    },
    "VSwitch": {
      "Type": "ALIYUN::ECS::VSwitch",
      "Properties": {
        "VSwitchName": "polardb-test",
        "VpcId": {
          "Ref": "VPC"
        },
        "CidrBlock": "192.168.1.0/24",
        "ZoneId": "cn-beijing-k"
      }
    },
    "PolardbCluster": {
      "Type": "ALIYUN::POLARDB::DBCluster",
      "Properties": {
        "VpcId": {
          "Ref": "VPC"
        },
        "CreationCategory": "Normal",
        "StorageType": "PSL5",
        "DBType": "PostgreSQL",
        "ClusterNetworkType": "VPC",
        "DBVersion": "16",
        "PayType": "Postpaid",
        "ZoneId": "cn-beijing-k",
        "VSwitchId": {
          "Ref": "VSwitch"
        },
        "DBNodeClass": "polar.pg.sl.small",
        "SecurityIPList": "0.0.0.0/0",
        "ServerlessType": "AgileServerless",
        "ScaleMin": 1,
        "ScaleMax": 3,
        "ScaleRoNumMin": 1,
        "ScaleRoNumMax": 2,
        "HotStandbyCluster": "OFF"
      }
    }
  }
}

Escenario 3: use SQL nativo para implementar la recuperación inteligente multimodal.

Primeros pasos

ROSTemplateFormatVersion: '2015-09-01'
Description:
  zh-cn: Native SQL easily realizes multimodal intelligent retrieval.
  en: Native SQL easily realizes multimodal intelligent retrieval.
Parameters:
  CommonName:
    Type: String
    Default: SmartSearch
  BucketName:
    AssociationProperty: AutoCompleteInput
    AssociationPropertyMetadata:
      Length: 6
      Prefix: test-bucket-
      CharacterClasses:
        - Class: lowercase
          min: 1
    Type: String
    Label:
      zh-cn: Bucket name
      en: Bucket Name
  ZoneId:
    Type: String
    Label:
      zh-cn: Zone ID
      en: Available Zone ID
    AssociationProperty: ALIYUN::ECS::Instance::ZoneId
  AccountName:
    Type: String
    Label:
      zh-cn: Database username
      en: Account Name
    Description:
      zh-cn: The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).
      en: The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).
    ConstraintDescription:
      zh-cn: The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).
      en: The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).
    AllowedPattern: '^[a-z][a-z0-9_]{0,30}[a-z0-9]$'
    Default: polar_ai
    MaxLength: 16
    MinLength: 2
  AccountPassword:
    Type: String
    Description:
      en: Server login password, Length 8-32, must contain three(Capital letters, lowercase letters, numbers, !@#$%^&*()_+-= Special symbol in)
      zh-cn: Database access password, length 8-32, must contain three (uppercase letters, lowercase letters, digits, and special characters from !@#$%^&*()_+-=)
    Label:
      en: Account Password
      zh-cn: Database password
    ConstraintDescription:
      en: Length 8-32, must contain three(Capital letters, lowercase letters, numbers, !@#$%^&*()_+-=Special symbol in)
      zh-cn: Length 8-32, must contain three (uppercase letters, lowercase letters, digits, and special characters from !@#$%^&*()_+-=)
    AllowedPattern: '^[0-9A-Za-z_!@#$%^&*()_+\-=\+]+$'
    MinLength: 8
    MaxLength: 32
    NoEcho: true
  DBName:
    Type: String
    Label:
      en: Database Name
      zh-cn: Database name
    AllowedPattern: ^[a-z][a-z0-9_-]{0,62}[a-z0-9]$
    Description:
      en: It is composed of lowercase letters, numbers, an underscore (-), and an underscore (_), ending with a lowercase letter or number, beginning with a letter, and ending with a letter or number, with a maximum of 64 characters.
      zh-cn: Composed of lowercase letters, digits, hyphens (-), and underscores (_). It must start with a letter and end with a lowercase letter or digit. Maximum length: 64 characters.
    ConstraintDescription:
      en: It is composed of lowercase letters, numbers, an underscore (-), and an underscore (_), ending with a lowercase letter or number, beginning with a letter, and ending with a letter or number, with a maximum of 64 characters.
      zh-cn: Composed of lowercase letters, digits, hyphens (-), and underscores (_). It must start with a letter and end with a lowercase letter or digit. Maximum length: 64 characters.
    Default: db-test
  PolarDBNodeClass:
    Type: String
    Label:
      en: PolarDB Node Specifications
      zh-cn: Specifications and proxy
    AssociationProperty: ALIYUN::POLARDB::DBCluster::DBNodeClass
    AssociationPropertyMetadata:
      ZoneId: ${ZoneId}
      DBVersion: "14"
      DBType: PostgreSQL
      PayType: Postpaid
      CommodityCode: polardb_payg
    Default: polar.pg.g2.2xlarge.c
Resources:
  VPC:
    Type: ALIYUN::ECS::VPC
    Properties:
      VpcName:
        Fn::Sub: VPC_${CommonName}
      CidrBlock: 192.168.0.0/16
  VSwitch:
    Type: ALIYUN::ECS::VSwitch
    Properties:
      VpcId:
        Ref: VPC
      CidrBlock: 192.168.1.0/24
      ZoneId:
        Ref: ZoneId
      VSwitchName:
        Fn::Sub: vsw_001_${CommonName}
  PolardbCluster:
    Type: ALIYUN::POLARDB::DBCluster
    Properties:
      VpcId:
        Ref: VPC
      SecurityIPList: 0.0.0.0/0
      DBType: PostgreSQL
      ClusterNetworkType: VPC
      ZoneId:
        Ref: ZoneId
      VSwitchId:
        Ref: VSwitch
      DBVersion: "14"
      CreationCategory: SENormal
      StorageSpace: 20
      HotStandbyCluster: 'OFF'
      DBNodeClass:
        Ref: PolarDBNodeClass
      PayType: Postpaid
      DBNodeNum: 2
      StorageType: ESSDPL1
  Account:
    Type: ALIYUN::POLARDB::Account
    Properties:
      DBClusterId:
        Ref: PolardbCluster
      AccountName:
        Ref: AccountName
      AccountPassword:
        Ref: AccountPassword
      AccountType: Super
  Database:
    DependsOn: Account
    Type: ALIYUN::POLARDB::Database
    Properties:
      CharacterSetName: utf8
      AccountPrivilege: ReadWrite
      AccountName:
        Ref: AccountName
      DBClusterId:
        Ref: PolardbCluster
      DBName:
        Ref: DBName
      Collate: C
      Ctype: C
  DBClusterEndpointAddress:
    Type: ALIYUN::POLARDB::DBClusterEndpointAddress
    DependsOn: Account
    Properties:
      DBClusterId:
        Ref: PolardbCluster
      DBEndpointId:
        Fn::GetAtt:
          - PolardbCluster
          - ClusterEndpointId
  OSSBucket:
    Type: ALIYUN::OSS::Bucket
    Properties:
      BucketName:
        Ref: BucketName
      DeletionForce: true
      RedundancyType: ZRS
Outputs:
  BucketName:
    Description:
      en: OSS Bucket Name.
      zh-cn: OSS bucket name.
    Value:
      Ref: BucketName
  AccountName:
    Description:
      en: PolarDB account name.
      zh-cn: PolarDB database username.
    Value:
      Ref: AccountName
  AccountPassword:
    NoEcho: true
    Description:
      en: PolarDB account password.
      zh-cn: PolarDB database password.
    Value:
      Ref: AccountPassword
  DBName:
    Description:
      en: PolarDB database name.
      zh-cn: PolarDB database name.
    Value:
      Ref: DBName
  ConnectionString:
    Description:
      en: PolarDB database connection string.
      zh-cn: Public endpoint of the PolarDB database.
    Value:
      Fn::Sub: ${DBClusterEndpointAddress.ConnectionString}:5432
Metadata:
  ALIYUN::ROS::Interface:
    Outputs:
      - BucketName
      - AccountName
      - AccountPassword
      - DBName
      - ConnectionString
    ParameterGroups:
      - Parameters:
          - ZoneId
        Label:
          default:
            en: Network Configuration
            zh-cn: Basic network configuration
      - Parameters:
          - BucketName
        Label:
          default:
            en: OSS Configuration
            zh-cn: OSS basic configuration
      - Parameters:
          - PolarDBNodeClass
          - DBName
          - AccountName
          - AccountPassword
        Label:
          default:
            en: PolarDB PostgreSQL Configuration
            zh-cn: ApsaraDB PolarDB for PostgreSQL configuration
    TemplateTags:
      - acs:technical-solution:internet-application-development:Native SQL easily realizes multimodal intelligent retrieval-tech_solu_262
    Hidden:
      - CommonName
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Description": {
    "zh-cn": "Native SQL easily realizes multimodal intelligent retrieval.",
    "en": "Native SQL easily realizes multimodal intelligent retrieval."
  },
  "Parameters": {
    "CommonName": {
      "Type": "String",
      "Default": "SmartSearch"
    },
    "BucketName": {
      "AssociationProperty": "AutoCompleteInput",
      "AssociationPropertyMetadata": {
        "Length": 6,
        "Prefix": "test-bucket-",
        "CharacterClasses": [
          {
            "Class": "lowercase",
            "min": 1
          }
        ]
      },
      "Type": "String",
      "Label": {
        "zh-cn": "Bucket name",
        "en": "Bucket Name"
      }
    },
    "ZoneId": {
      "Type": "String",
      "Label": {
        "zh-cn": "Zone ID",
        "en": "Available Zone ID"
      },
      "AssociationProperty": "ALIYUN::ECS::Instance::ZoneId"
    },
    "AccountName": {
      "Type": "String",
      "Label": {
        "zh-cn": "Database username",
        "en": "Account Name"
      },
      "Description": {
        "zh-cn": "The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).",
        "en": "The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_)."
      },
      "ConstraintDescription": {
        "zh-cn": "The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_).",
        "en": "The length should not exceed 16 characters. It begins with a lowercase English letter and can contain lowercase English letters, numbers and underscores (_)."
      },
      "AllowedPattern": "^[a-z][a-z0-9_]{0,30}[a-z0-9]$",
      "Default": "polar_ai",
      "MaxLength": 16,
      "MinLength": 2
    },
    "AccountPassword": {
      "Type": "String",
      "Description": {
        "en": "Server login password, Length 8-32, must contain three(Capital letters, lowercase letters, numbers, !@#$%^&*()_+-= Special symbol in)",
        "zh-cn": "Database access password, length 8-32, must contain three (uppercase letters, lowercase letters, digits, and special characters from !@#$%^&*()_+-=)"
      },
      "Label": {
        "en": "Account Password",
        "zh-cn": "Database password"
      },
      "ConstraintDescription": {
        "en": "Length 8-32, must contain three(Capital letters, lowercase letters, numbers, !@#$%^&*()_+-=Special symbol in)",
        "zh-cn": "Length 8-32, must contain three (uppercase letters, lowercase letters, digits, and special characters from !@#$%^&*()_+-=)"
      },
      "AllowedPattern": "^[0-9A-Za-z_!@#$%^&*()_+\\-=\\+]+$",
      "MinLength": 8,
      "MaxLength": 32,
      "NoEcho": true
    },
    "DBName": {
      "Type": "String",
      "Label": {
        "en": "Database Name",
        "zh-cn": "Database name"
      },
      "AllowedPattern": "^[a-z][a-z0-9_-]{0,62}[a-z0-9]$",
      "Description": {
        "en": "It is composed of lowercase letters, numbers, an underscore (-), and an underscore (_), ending with a lowercase letter or number, beginning with a letter, and ending with a letter or number, with a maximum of 64 characters.",
        "zh-cn": "Composed of lowercase letters, digits, hyphens (-), and underscores (_). It must start with a letter and end with a lowercase letter or digit. Maximum length: 64 characters."
      },
      "ConstraintDescription": {
        "en": "It is composed of lowercase letters, numbers, an underscore (-), and an underscore (_), ending with a lowercase letter or number, beginning with a letter, and ending with a letter or number, with a maximum of 64 characters.",
        "zh-cn": "Composed of lowercase letters, digits, hyphens (-), and underscores (_). It must start with a letter and end with a lowercase letter or digit. Maximum length: 64 characters."
      },
      "Default": "db-test"
    },
    "PolarDBNodeClass": {
      "Type": "String",
      "Label": {
        "en": "PolarDB Node Specifications",
        "zh-cn": "Specifications and proxy"
      },
      "AssociationProperty": "ALIYUN::POLARDB::DBCluster::DBNodeClass",
      "AssociationPropertyMetadata": {
        "ZoneId": "${ZoneId}",
        "DBVersion": "14",
        "DBType": "PostgreSQL",
        "PayType": "Postpaid",
        "CommodityCode": "polardb_payg"
      },
      "Default": "polar.pg.g2.2xlarge.c"
    }
  },
  "Resources": {
    "VPC": {
      "Type": "ALIYUN::ECS::VPC",
      "Properties": {
        "VpcName": {
          "Fn::Sub": "VPC_${CommonName}"
        },
        "CidrBlock": "192.168.0.0/16"
      }
    },
    "VSwitch": {
      "Type": "ALIYUN::ECS::VSwitch",
      "Properties": {
        "VpcId": {
          "Ref": "VPC"
        },
        "CidrBlock": "192.168.1.0/24",
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "VSwitchName": {
          "Fn::Sub": "vsw_001_${CommonName}"
        }
      }
    },
    "PolardbCluster": {
      "Type": "ALIYUN::POLARDB::DBCluster",
      "Properties": {
        "VpcId": {
          "Ref": "VPC"
        },
        "SecurityIPList": "0.0.0.0/0",
        "DBType": "PostgreSQL",
        "ClusterNetworkType": "VPC",
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "VSwitchId": {
          "Ref": "VSwitch"
        },
        "DBVersion": "14",
        "CreationCategory": "SENormal",
        "StorageSpace": 20,
        "HotStandbyCluster": "OFF",
        "DBNodeClass": {
          "Ref": "PolarDBNodeClass"
        },
        "PayType": "Postpaid",
        "DBNodeNum": 2,
        "StorageType": "ESSDPL1"
      }
    },
    "Account": {
      "Type": "ALIYUN::POLARDB::Account",
      "Properties": {
        "DBClusterId": {
          "Ref": "PolardbCluster"
        },
        "AccountName": {
          "Ref": "AccountName"
        },
        "AccountPassword": {
          "Ref": "AccountPassword"
        },
        "AccountType": "Super"
      }
    },
    "Database": {
      "DependsOn": "Account",
      "Type": "ALIYUN::POLARDB::Database",
      "Properties": {
        "CharacterSetName": "utf8",
        "AccountPrivilege": "ReadWrite",
        "AccountName": {
          "Ref": "AccountName"
        },
        "DBClusterId": {
          "Ref": "PolardbCluster"
        },
        "DBName": {
          "Ref": "DBName"
        },
        "Collate": "C",
        "Ctype": "C"
      }
    },
    "DBClusterEndpointAddress": {
      "Type": "ALIYUN::POLARDB::DBClusterEndpointAddress",
      "DependsOn": "Account",
      "Properties": {
        "DBClusterId": {
          "Ref": "PolardbCluster"
        },
        "DBEndpointId": {
          "Fn::GetAtt": [
            "PolardbCluster",
            "ClusterEndpointId"
          ]
        }
      }
    },
    "OSSBucket": {
      "Type": "ALIYUN::OSS::Bucket",
      "Properties": {
        "BucketName": {
          "Ref": "BucketName"
        },
        "DeletionForce": true,
        "RedundancyType": "ZRS"
      }
    }
  },
  "Outputs": {
    "BucketName": {
      "Description": {
        "en": "OSS Bucket Name.",
        "zh-cn": "OSS bucket name."
      },
      "Value": {
        "Ref": "BucketName"
      }
    },
    "AccountName": {
      "Description": {
        "en": "PolarDB account name.",
        "zh-cn": "PolarDB database username."
      },
      "Value": {
        "Ref": "AccountName"
      }
    },
    "AccountPassword": {
      "NoEcho": true,
      "Description": {
        "en": "PolarDB account password.",
        "zh-cn": "PolarDB database password."
      },
      "Value": {
        "Ref": "AccountPassword"
      }
    },
    "DBName": {
      "Description": {
        "en": "PolarDB database name.",
        "zh-cn": "PolarDB database name."
      },
      "Value": {
        "Ref": "DBName"
      }
    },
    "ConnectionString": {
      "Description": {
        "en": "PolarDB database connection string.",
        "zh-cn": "Public endpoint of the PolarDB database."
      },
      "Value": {
        "Fn::Sub": "${DBClusterEndpointAddress.ConnectionString}:5432"
      }
    }
  },
  "Metadata": {
    "ALIYUN::ROS::Interface": {
      "Outputs": [
        "BucketName",
        "AccountName",
        "AccountPassword",
        "DBName",
        "ConnectionString"
      ],
      "ParameterGroups": [
        {
          "Parameters": [
            "ZoneId"
          ],
          "Label": {
            "default": {
              "en": "Network Configuration",
              "zh-cn": "Basic network configuration"
            }
          }
        },
        {
          "Parameters": [
            "BucketName"
          ],
          "Label": {
            "default": {
              "en": "OSS Configuration",
              "zh-cn": "OSS basic configuration"
            }
          }
        },
        {
          "Parameters": [
            "PolarDBNodeClass",
            "DBName",
            "AccountName",
            "AccountPassword"
          ],
          "Label": {
            "default": {
              "en": "PolarDB PostgreSQL Configuration",
              "zh-cn": "ApsaraDB PolarDB for PostgreSQL configuration"
            }
          }
        }
      ],
      "TemplateTags": [
        "acs:technical-solution:internet-application-development:Native SQL easily realizes multimodal intelligent retrieval-tech_solu_262"
      ],
      "Hidden": [
        "CommonName"
      ]
    }
  }
}

Para consultar más ejemplos, consulte Plantillas públicas que contienen este recurso.