Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::ADBLake::DBCluster

Última actualización: Sep 04, 2026

Crea un clúster de AnalyticDB for MySQL Data Lakehouse Edition.

Sintaxis

{
  "Type": "ALIYUN::ADBLake::DBCluster",
  "Properties": {
    "ComputeResource": String,
    "DBClusterVersion": String,
    "DiskEncryption": Boolean,
    "KmsId": String,
    "ProductForm": String,
    "ReservedNodeCount": Integer,
    "ReservedNodeSize": Integer,
    "CloneSourceRegionId": String,
    "DBClusterNetworkType": String
    "PayType": String,
    "StorageResource": String,
    "VPCId": String,
    "VSwitchId": String,
    "ZoneId": String,
    "BackupSetId": String,
    "DBClusterDescription": String,
    "EnableDefaultResourcePool": Boolean,
    "PeriodType": String,
    "Period": String,
    "RestoreToTime": String,
    "ResourceGroupId": String,
    "RestoreType": String,
    "SourceDbClusterId": String,
    "ProductVersion": String,
    "SecondaryVSwitchId": String,
    "SecondaryZoneId": String,
    "Tags": List
  }
}

Propiedades

Nombre de la propiedad

Tipo

Obligatorio

Editable

Descripción

Restricción

DBClusterVersion

String

Sí

No

La versión de AnalyticDB for MySQL Data Lakehouse Edition.

Establezca el valor en: 5.0.

PayType

String

Sí

No

El método de facturación.

Valores válidos:

  • Prepaid: suscripción anual o mensual.

  • Postpaid: pay-as-you-go.

VPCId

String

Sí

No

El ID de la VPC.

Ninguna.

VSwitchId

String

Sí

No

El ID del vSwitch.

Ninguna.

ZoneId

String

Sí

No

El ID de la zona.

Nota

Puede llamar a la API DescribeRegion para consultar el ID de zona de un clúster específico de AnalyticDB for MySQL Data Lakehouse Edition.

BackupSetId

String

No

No

El ID del conjunto de copia de seguridad.

Ninguna.

CloneSourceRegionId

String

No

No

El ID de la región del clúster de origen.

Nota

Este campo es obligatorio para la clonación entre regiones.

ComputeResource

String

No

No

Los recursos de computación reservados.

Valores válidos: de 0 a 4096. El valor debe ser múltiplo de 16. Unidad: unidades de computación de AnalyticDB (ACU). Una ACU equivale a 1 núcleo y 4 GB de memoria.

Nota

Debe especificar un valor con la unidad correspondiente para este campo.

DBClusterDescription

String

No

No

La descripción del clúster.

  • No puede comenzar con http:// ni con https://.

  • La longitud debe ser de 2 a 256 caracteres.

DBClusterNetworkType

String

No

No

El tipo de red del clúster.

Solo se admite el tipo VPC (Virtual Private Cloud).

DiskEncryption

Boolean

No

No

Especifica si se habilita el cifrado de discos en la nube.

Ninguna.

EnableDefaultResourcePool

Boolean

No

No

Especifica si se asignan todos los recursos de computación reservados al resource group predeterminado.

Valores válidos:

  • true (predeterminado)

  • false

KmsId

String

No

No

El ID de la clave KMS para cifrar los datos del disco en la nube.

Nota

Este campo es obligatorio solo cuando se habilita el cifrado de discos en la nube para el clúster de AnalyticDB for MySQL.

Period

String

No

No

La duración de la suscripción del clúster.

Valores válidos:

  • Cuando PeriodType se establece en Year: el rango de valores es de 1 a 3. El valor debe ser un número entero.

  • Cuando PeriodType se establece en Month: el rango de valores es de 1 a 9. El valor debe ser un número entero.

PeriodType

String

No

No

El tipo de suscripción.

Valores válidos:

  • Year: suscripción anual.

  • Month: suscripción mensual.

ProductForm

String

No

No

La forma del producto.

Valores válidos:

  • IntegrationForm: edición integrada.

  • LegacyForm: Lakehouse Edition.

ProductVersion

String

No

No

La versión del producto.

Valores válidos:

  • BasicVersion: Basic Edition.

  • EnterpriseVersion: Enterprise Edition.

ResourceGroupId

String

No

No

El ID del resource group.

Ninguna.

RestoreToTime

String

No

No

El punto en el tiempo al que desea restaurar los datos desde el conjunto de copia de seguridad.

Ninguna.

RestoreType

String

No

No

El método utilizado para restaurar los datos.

Valores válidos:

  • backup: restaura los datos desde un conjunto de copia de seguridad. Debe especificar BackupSetId y SourceDBClusterId.

  • timepoint: restaura los datos desde una marca de tiempo. Debe especificar RestoreToTime y SourceDBClusterId.

ReservedNodeCount

Integer

No

No

El número de nodos reservados.

  • El valor predeterminado para Enterprise Edition es de 3 nodos, y el valor debe ser múltiplo de 3.

  • El valor predeterminado para Basic Edition es de 1 nodo.

Nota

Especifique este campo solo cuando ProductForm esté establecido en IntegrationForm.

ReservedNodeSize

Integer

No

No

Las especificaciones de los nodos reservados.

Unidad: ACU.

SecondaryVSwitchId

String

No

No

El ID del vSwitch secundario.

Ninguna.

SecondaryZoneId

String

No

No

El ID de la zona secundaria.

Ninguna.

SourceDbClusterId

String

No

No

El ID del clúster de origen de AnalyticDB for MySQL Data Lakehouse Edition.

Ninguna.

StorageResource

String

No

No

Los recursos de almacenamiento reservados.

Valores válidos: de 0 a 2064. El valor debe ser múltiplo de 24. Unidad: unidades de computación de AnalyticDB (ACU). Una ACU equivale a 1 núcleo y 4 GB de memoria.

Nota

Debe especificar un valor con la unidad correspondiente para este campo.

Tags

List

No

Sí

Las etiquetas del clúster.

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

Sintaxis de Tags

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

Propiedades de Tags

Propiedad

Tipo

Obligatorio

Permite actualizaciones

Descripción

Restricción

Key

String

Sí

No

La clave de la etiqueta.

Puede especificar de 1 a 20 claves de etiqueta.

Value

String

No

No

El valor de la etiqueta.

Puede especificar de 1 a 20 valores de etiqueta.

Valores de retorno

Fn::GetAtt

  • DBClusterId: el ID del clúster de AnalyticDB for MySQL Data Lakehouse Edition.

  • OrderId: el ID del pedido.

  • ConnectionString: el endpoint público para conectarse al clúster.

Ejemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  StorageResource:
    Type: String
    Description:
      en: |-
        The amount of reserved storage resources. Unit: AnalyticDB compute units (ACUs). Valid values: 0ACU to 2064ACU. The value must be in increments of 24 ACUs. Each ACU is equivalent to 1 core and 4 GB memory.
        Note This parameter must be specified with a unit.
    Required: true
  ZoneId:
    AssociationProperty: ZoneId
    Type: String
    Description:
      en: |-
        The zone ID.
        Note You can call the  DescribeRegions  operation to query the most recent zone list.
    Required: true
  VPCId:
    Type: String
    Description:
      en: The virtual private cloud (VPC) ID of the cluster.
    Required: true
  VSwitchId:
    AssociationPropertyMetadata:
      VpcId: ${VpcId}
      ZoneId: ${ZoneId}
    AssociationProperty: ALIYUN::VPC::VSwitch::VSwitchId
    Type: String
    Description:
      en: The vSwitch ID of the cluster.
    Required: true
  ComputeResource:
    Type: String
    Description:
      en: |-
        The amount of reserved computing resources. Unit: ACUs. Valid values: 0ACU to 4096ACU. The value must be in increments of 16 ACUs. Each ACU is equivalent to 1 core and 4 GB memory.
        Note This parameter must be specified with a unit.
    Required: true
  PayType:
    Type: String
    Description:
      en: |-
        The billing method of the cluster. Valid values:
        Postpaid: pay-as-you-go.
        Prepaid: subscription.
    AllowedValues:
      - PayAsYouGo
      - Subscription
    Required: true
    Default: PayAsYouGo
  DBClusterVersion:
    Type: String
    Description:
      en: The version of the cluster. Set the value to 5.0.
    Required: true
Resources:
  DBCluster:
    Type: ALIYUN::ADBLake::DBCluster
    Properties:
      StorageResource:
        Ref: StorageResource
      ZoneId:
        Ref: ZoneId
      VPCId:
        Ref: VPCId
      VSwitchId:
        Ref: VSwitchId
      ComputeResource:
        Ref: ComputeResource
      PayType:
        Ref: PayType
      DBClusterVersion:
        Ref: DBClusterVersion
Outputs:
  DBClusterId:
    Description: The ID of the AnalyticDB for MySQL Data Lakehouse Edition (V3.0) cluster.
    Value:
      Fn::GetAtt:
        - DBCluster
        - DBClusterId
  OrderId:
    Description: The order ID.
    Value:
      Fn::GetAtt:
        - DBCluster
        - OrderId
  ConnectionString:
    Description: The public endpoint that is used to connect to the cluster.
    Value:
      Fn::GetAtt:
        - DBCluster
        - ConnectionString
        
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "StorageResource": {
      "Type": "String",
      "Description": {
        "en": "The amount of reserved storage resources. Unit: AnalyticDB compute units (ACUs). Valid values: 0ACU to 2064ACU. The value must be in increments of 24 ACUs. Each ACU is equivalent to 1 core and 4 GB memory.\nNote This parameter must be specified with a unit."
      },
      "Required": true
    },
    "ZoneId": {
      "AssociationProperty": "ZoneId",
      "Type": "String",
      "Description": {
        "en": "The zone ID.\nNote You can call the  DescribeRegions  operation to query the most recent zone list."
      },
      "Required": true
    },
    "VPCId": {
      "Type": "String",
      "Description": {
        "en": "The virtual private cloud (VPC) ID of the cluster."
      },
      "Required": true
    },
    "VSwitchId": {
      "AssociationPropertyMetadata": {
        "VpcId": "${VpcId}",
        "ZoneId": "${ZoneId}"
      },
      "AssociationProperty": "ALIYUN::VPC::VSwitch::VSwitchId",
      "Type": "String",
      "Description": {
        "en": "The vSwitch ID of the cluster."
      },
      "Required": true
    },
    "ComputeResource": {
      "Type": "String",
      "Description": {
        "en": "The amount of reserved computing resources. Unit: ACUs. Valid values: 0ACU to 4096ACU. The value must be in increments of 16 ACUs. Each ACU is equivalent to 1 core and 4 GB memory.\nNote This parameter must be specified with a unit."
      },
      "Required": true
    },
    "PayType": {
      "Type": "String",
      "Description": {
        "en": "The billing method of the cluster. Valid values:\nPostpaid: pay-as-you-go.\nPrepaid: subscription."
      },
      "AllowedValues": [
        "PayAsYouGo",
        "Subscription"
      ],
      "Required": true,
      "Default": "PayAsYouGo"
    },
    "DBClusterVersion": {
      "Type": "String",
      "Description": {
        "en": "The version of the cluster. Set the value to 5.0."
      },
      "Required": true
    }
  },
  "Resources": {
    "DBCluster": {
      "Type": "ALIYUN::ADBLake::DBCluster",
      "Properties": {
        "StorageResource": {
          "Ref": "StorageResource"
        },
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "VPCId": {
          "Ref": "VPCId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "ComputeResource": {
          "Ref": "ComputeResource"
        },
        "PayType": {
          "Ref": "PayType"
        },
        "DBClusterVersion": {
          "Ref": "DBClusterVersion"
        }
      }
    }
  },
  "Outputs": {
    "DBClusterId": {
      "Description": "The ID of the AnalyticDB for MySQL Data Lakehouse Edition (V3.0) cluster.",
      "Value": {
        "Fn::GetAtt": [
          "DBCluster",
          "DBClusterId"
        ]
      }
    },
    "OrderId": {
      "Description": "The order ID.",
      "Value": {
        "Fn::GetAtt": [
          "DBCluster",
          "OrderId"
        ]
      }
    },
    "ConnectionString": {
      "Description": "The public endpoint that is used to connect to the cluster.",
      "Value": {
        "Fn::GetAtt": [
          "DBCluster",
          "ConnectionString"
        ]
      }
    }
  }
}