ALIYUN::GPDB::DBInstance - Resource Orchestration Service - Centro de documentación de Alibaba Cloud

Utilice el recurso ALIYUN::GPDB::DBInstance para crear una instancia de AnalyticDB for PostgreSQL en modo de almacenamiento reservado.

Sintaxis

{
  "Type": "ALIYUN::GPDB::DBInstance",
  "Properties": {
    "EngineVersion": String,
    "ZoneId": String,
    "VSwitchId": String,   
    "DBInstanceClass": String,
    "DBInstanceGroupCount": Integer,
    "VPCId": String,
    "SecurityIPList": String,   
    "DBInstanceDescription": String,
    "PayType": String,
    "Period": Integer,
    "PeriodUnit": String,
    "Tags": List,
    "VectorConfigurationStatus": String,
    "StorageSize": Integer,
    "EncryptionType": String,
    "MasterNodeNum": Integer,
    "DBInstanceMode": String,
    "SegDiskPerformanceLevel": String,
    "DBInstanceCategory": String,
    "SegStorageType": String,
    "CacheStorageSize": String,
    "BackupId": String,
    "MasterAISpec": String,
    "EnableSSL": Boolean,
    "SrcDbInstanceName": String,
    "EncryptionKey": String,
    "CreateSampleData": Boolean,
    "ServerlessMode": String,
    "ServerlessResource": Integer,
    "PrivateIpAddress": String,
    "SegNodeNum": Integer,
    "InstanceSpec": String,
    "IdleTime": Integer,
    "ProdType": String,
    "MasterCU": Integer,
    "StandbyZoneId": String,
    "StandbyVSwitchId": String,
    "DeployMode": String,
    "AINodeSpecInfos": List,
    "ResourceGroupId": String
  }
}

Propiedades

Parámetro	Tipo	Obligatorio	Actualización permitida	Descripción	Restricciones
EngineVersion	String	Sí	No	Versión del motor.	Valores válidos: `6.0`: Standard Edition. `6.0x`: Vector-enhanced Edition.
AINodeSpecInfos	List	No	No	Detalles de los nodos de IA.	Para obtener más información, consulte la sección AINodeSpecInfos properties.
VSwitchId	String	Sí	No	ID del vSwitch.	Ejemplo: `vsw-bp183p93qs667muql****`.
BackupId	String	No	No	ID de un conjunto de copia de seguridad histórico.	Ninguna.
CacheStorageSize	String	No	No	Tamaño del disco de caché.	Unidad: GB.
EnableSSL	Boolean	No	No	Indica si se habilita el cifrado SSL.	Valores válidos: true: Habilita el cifrado SSL. false (predeterminado): Deshabilita el cifrado SSL.
MasterAISpec	String	No	No	Especificaciones para actualizar un nodo coordinador a un nodo MasterAI.	Nota No puede especificar este parámetro y el parámetro `MasterCU` al mismo tiempo. Esta actualización solo es compatible con regiones y zonas de disponibilidad específicas. Solo las instancias Basic Edition de AnalyticDB for PostgreSQL 7.0 admiten nodos MasterAI. Los valores válidos para este parámetro se encuentran en la página de actualización de la instancia.
SrcDbInstanceName	String	No	No	ID de la instancia de origen que se va a clonar.	Ninguna.
DBInstanceClass	String	No	No	Tipo de instancia.	Ejemplo: `gpdb.group.segsdx2`.
DBInstanceGroupCount	Integer	No	No	Número de grupos de cómputo.	Ejemplo: `2`.
VPCId	String	No	No	ID de la Virtual Private Cloud (VPC).	Ejemplo: `vpc-bp1m6fww66xbntjyc****`.
SecurityIPList	String	No	Sí	Lista de permitidos de direcciones IP para la instancia.	Valor predeterminado: `127.0.0.1`.
DBInstanceDescription	String	No	Sí	Descripción de la instancia.	Ejemplo: `AnalyticDB for PostgreSQL DB Instance`. La descripción puede tener hasta 256 caracteres.
PayType	String	No	Sí	Método de facturación de la instancia.	Valores válidos: `Postpaid` (predeterminado): Método de facturación pay-as-you-go. `Prepaid`: Método de facturación por suscripción.
Period	Integer	No	Sí	Duración de la suscripción.	Este parámetro es obligatorio solo si establece `PayType` en `Prepaid`. Valores válidos: Si establece `PeriodUnit` en `Month`, los valores válidos son del 1 al 11. Si establece `PeriodUnit` en `Year`, los valores válidos son 1, 2 y 3.
PeriodUnit	String	No	Sí	Unidad de la duración de la suscripción.	Este parámetro es obligatorio solo si establece `PayType` en `Prepaid`. Valores válidos: `Month` (predeterminado) `Year`
Tags	List	No	No	Etiquetas de la instancia.	Para obtener más información, consulte la sección Tags properties.
EncryptionType	String	No	No	Tipo de cifrado.	Valores válidos: NULL (predeterminado): Deshabilita el cifrado de disco en la nube. CloudDisk: Habilita el cifrado de disco en la nube. Si selecciona este valor, debe especificar el parámetro `EncryptionKey`. Nota El cifrado de disco en la nube no se puede deshabilitar una vez habilitado.
MasterNodeNum	Integer	No	No	Número de nodos coordinadores.	Valores válidos: 1 y 2. Nota Si no especifica este parámetro, el valor predeterminado es 1.
DBInstanceMode	String	No	No	Modo de almacenamiento de la instancia.	Valores válidos: StorageElastic: Modo de almacenamiento elástico. Serverless: Modo Serverless. Classic: Modo de almacenamiento reservado.
SegDiskPerformanceLevel	String	No	No	Nivel de rendimiento (PL) del SSD mejorado (ESSD).	Valores válidos: pl0: PL0. pl1: PL1. pl2: PL2. Nota Este parámetro solo aplica cuando el tipo de almacenamiento en disco es ESSD. Si no especifica este parámetro, el valor predeterminado es pl1.
DBInstanceCategory	String	No	No	Edición de la instancia.	Valores válidos: HighAvailability: High-availability Edition. Basic: Basic Edition. Nota Este parámetro es obligatorio para instancias en modo de almacenamiento elástico.
SegStorageType	String	No	No	Tipo de almacenamiento en disco.	Actualmente, solo se admiten discos SSD mejorados (ESSD). Establezca el valor en cloud_essd. Nota Este parámetro es obligatorio para instancias en modo de almacenamiento elástico.
StorageSize	Integer	No	No	Capacidad de almacenamiento.	Unidad: GB. Valores válidos: de 50 a 8000.
EncryptionKey	String	No	No	ID de la clave.	Este parámetro es obligatorio solo cuando EncryptionType se establece en CloudDisk. Debe especificar el ID de una clave que se encuentre en la misma región que la instancia. De lo contrario, deje este parámetro vacío.
CreateSampleData	Boolean	No	No	Indica si se carga un conjunto de datos de muestra después de crear la instancia.	Valores válidos: true: Carga un conjunto de datos de muestra. false (predeterminado): No carga un conjunto de datos de muestra.
ServerlessMode	String	No	No	Modo de la instancia Serverless.	Valores válidos: Manual (predeterminado): Programación manual. Auto: Programación automática. Nota Este parámetro es obligatorio para instancias en modo Serverless.
ServerlessResource	Integer	No	No	Umbral de recursos de cómputo.	El valor debe estar entre 8 y 32, en incrementos de 8 ACU. Valor predeterminado: 32. Nota Este parámetro es obligatorio para instancias en modo Serverless que utilizan programación automática.
PrivateIpAddress	String	No	No	Dirección IP privada.	Ninguna.
SegNodeNum	Integer	No	No	Número de nodos de cómputo.	Valores válidos: Para una instancia High-availability Edition en modo de almacenamiento elástico: de 4 a 512. El valor debe ser múltiplo de 4. Para una instancia Basic Edition en modo de almacenamiento elástico: de 2 a 512. El valor debe ser múltiplo de 2. Para una instancia en modo Serverless: de 2 a 512. El valor debe ser múltiplo de 2. Nota Este parámetro es obligatorio para instancias en modo de almacenamiento elástico o modo Serverless.
InstanceSpec	String	No	No	Especificaciones de los nodos de cómputo.	Valores para High-availability Edition en modo de almacenamiento elástico: 2C16G 4C32G 16C128G Valores para Basic Edition en modo de almacenamiento elástico: 2C8G 4C16G 8C32G 16C64G Valores para el modo Serverless: 4C16G 8C32G Nota Este parámetro es obligatorio para instancias en modo de almacenamiento elástico o modo Serverless.
IdleTime	Integer	No	No	Duración de inactividad en segundos antes de que la instancia se suspenda automáticamente.	La instancia entra en estado de inactividad después de este periodo sin actividad. Valor mínimo: 60. Valor predeterminado: 600. Nota Este parámetro es obligatorio para instancias en modo Serverless que utilizan programación automática.
ProdType	String	No	No	Tipo de producto.	Valores válidos: standard (predeterminado): Standard Edition. cost-effective: Cost-efficient Edition.
MasterCU	Integer	No	No	Recursos del nodo coordinador.	Ninguna.
StandbyZoneId	String	No	No	ID de la zona de disponibilidad secundaria.	Ninguna.
StandbyVSwitchId	String	No	No	ID del vSwitch secundario.	Ninguna.
DeployMode	String	No	No	Modo de despliegue.	Ninguna.
ResourceGroupId	String	No	Sí	ID del resource group.	Ninguna.
VectorConfigurationStatus	String	No	No	Indica si se habilita la optimización del motor vectorial.	Valores válidos: `enabled`: Habilita la optimización del motor vectorial. `disabled` (predeterminado): Deshabilita la optimización del motor vectorial. Nota Se recomienda deshabilitar esta función para escenarios de análisis general, almacenamiento de datos y almacenamiento de datos en tiempo real. Se recomienda habilitar esta función para escenarios que requieren un motor de análisis vectorial, como contenido generado por IA (AIGC) y recuperación vectorial.
ZoneId	String	Sí	No	ID de la zona de disponibilidad.	Ejemplo: `cn-hangzhou-h`. Para obtener más información sobre las zonas de disponibilidad, consulte View available regions and zones.

Sintaxis de AINodeSpecInfos

"AINodeSpecInfos": [
  {
    "AINodeSpec": String,
    "AINodeNum": Integer
  }
]

Propiedades de AINodeSpecInfos

Parámetro	Tipo	Obligatorio	Actualización permitida	Descripción	Restricciones
AINodeSpec	String	Sí	No	Especificaciones de un nodo de IA.	Ninguna.
AINodeNum	Integer	Sí	No	Número de nodos de IA.	Ninguna.

Sintaxis de Tags

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

Propiedades de Tags

Parámetro	Tipo	Obligatorio	Actualización permitida	Descripción	Restricciones
Key	String	Sí	No	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	Valor de la etiqueta.	El valor puede tener entre 0 y 128 caracteres. No puede comenzar con `aliyun` ni con `acs:`, y no puede contener `http://` ni `https://`.

Valores de retorno

Fn::GetAtt

DBInstanceId: ID de la instancia.
Port: Número de puerto de la instancia.
OrderId: ID del pedido.
ConnectionString: Endpoint de la instancia.
Arn: Alibaba Cloud Resource Name (ARN) de la instancia.

Ejemplos

YAML

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneId:
    Type: String
  VpcId:
    Type: String
    AssociationProperty: 'ALIYUN::ECS::VPC::VPCId'
  VSwitchId:
    Type: String
    AssociationProperty: 'ALIYUN::ECS::VSwitch::VSwitchId'
    AssociationPropertyMetadata:
      ZoneId: ZoneId
      VpcId: VpcId
Resources:
  DBInstance:
    Type: 'ALIYUN::GPDB::DBInstance'
    Properties:
      ZoneId:
        Ref: ZoneId
      VPCId:
        Ref: VpcId
      VSwitchId:
        Ref: VSwitchId
      DBInstanceGroupCount: 2
      EngineVersion: '6.0'
      DBInstanceClass: gpdb.group.segsdx2
      DBInstanceDescription: AnalyticDB PostgreSQL DB Instance
Outputs:
  OrderId:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - OrderId
  ConnectionString:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - ConnectionString
  DBInstanceId:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - DBInstanceId
  Port:
    Value:
      'Fn::GetAtt':
        - DBInstance
        - Port

JSON

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ZoneId": {
      "Type": "String"
    },
    "VpcId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VPC::VPCId"
    },
    "VSwitchId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::VSwitch::VSwitchId",
      "AssociationPropertyMetadata": {
        "ZoneId": "ZoneId",
        "VpcId": "VpcId"
      }
    }
  },
  "Resources": {
    "DBInstance": {
      "Type": "ALIYUN::GPDB::DBInstance",
      "Properties": {
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "VPCId": {
          "Ref": "VpcId"
        },
        "VSwitchId": {
          "Ref": "VSwitchId"
        },
        "DBInstanceGroupCount": 2,
        "EngineVersion": "6.0",
        "DBInstanceClass": "gpdb.group.segsdx2",
        "DBInstanceDescription": "AnalyticDB PostgreSQL DB Instance"
      }
    }
  },
  "Outputs": {
    "OrderId": {
      "Value": { "Fn::GetAtt": ["DBInstance", "OrderId"] }
    },
    "ConnectionString": {
      "Value": { "Fn::GetAtt": ["DBInstance", "ConnectionString"] }
    },
    "DBInstanceId": {
      "Value": { "Fn::GetAtt": ["DBInstance", "DBInstanceId"] }
    },
    "Port": {
      "Value": { "Fn::GetAtt": ["DBInstance", "Port"] }
    }
  }
}