Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::GPDB::DBInstance

Última atualização: Jun 27, 2026

Use o recurso ALIYUN::GPDB::DBInstance para criar uma instância do AnalyticDB for PostgreSQL no modo de armazenamento reservado.

Sintaxe

{
  "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
  }
}

Propriedades

Parâmetro

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

EngineVersion

String

Sim

Não

Versão do mecanismo.

Valores válidos:

  • 6.0: Standard Edition.

  • 6.0x: Vector-enhanced Edition.

AINodeSpecInfos

List

Não

Não

Detalhes dos nós de IA.

Para mais informações, consulte a seção Propriedades de AINodeSpecInfos.

VSwitchId

String

Sim

Não

ID do vSwitch.

Exemplo: vsw-bp183p93qs667muql****.

BackupId

String

Não

Não

ID de um conjunto de backup histórico.

Nenhuma.

CacheStorageSize

String

Não

Não

Tamanho do disco de cache.

Unidade: GB.

EnableSSL

Boolean

Não

Não

Define se a criptografia SSL deve ser ativada.

Valores válidos:

  • true: Ativa a criptografia SSL.

  • false (padrão): Desativa a criptografia SSL.

MasterAISpec

String

Não

Não

Especificações para atualizar um nó coordenador para um nó MasterAI.

Nota

Não é possível especificar este parâmetro e o parâmetro MasterCU simultaneamente.

Essa atualização é suportada apenas em regiões e zonas de disponibilidade específicas.

Apenas instâncias Basic Edition do AnalyticDB for PostgreSQL 7.0 suportam nós MasterAI.

Os valores válidos para este parâmetro estão disponíveis na página de atualização da instância.

SrcDbInstanceName

String

Não

Não

ID da instância de origem a ser clonada.

Nenhuma.

DBInstanceClass

String

Não

Não

Tipo da instância.

Exemplo: gpdb.group.segsdx2.

DBInstanceGroupCount

Integer

Não

Não

Quantidade de grupos de computação.

Exemplo: 2.

VPCId

String

Não

Não

ID da Virtual Private Cloud (VPC).

Exemplo: vpc-bp1m6fww66xbntjyc****.

SecurityIPList

String

Não

Sim

Lista de permissões de endereços IP da instância.

Valor padrão: 127.0.0.1.

DBInstanceDescription

String

Não

Sim

Descrição da instância.

Exemplo: AnalyticDB for PostgreSQL DB Instance.

A descrição pode ter até 256 caracteres.

PayType

String

Não

Sim

Método de faturamento da instância.

Valores válidos:

  • Postpaid (padrão): Pagamento conforme o uso.

  • Prepaid: Assinatura.

Period

Integer

Não

Sim

Duração da assinatura.

Este parâmetro é obrigatório apenas se você definir PayType como Prepaid. Valores válidos:

  • Se você definir PeriodUnit como Month, os valores válidos são de 1 a 11.

  • Se você definir PeriodUnit como Year, os valores válidos são 1, 2 e 3.

PeriodUnit

String

Não

Sim

Unidade da duração da assinatura.

Este parâmetro é obrigatório apenas se você definir PayType como Prepaid. Valores válidos:

  • Month (padrão)

  • Year

Tags

List

Não

Não

Tags da instância.

Para mais informações, consulte a seção Propriedades de Tags.

EncryptionType

String

Não

Não

Tipo de criptografia.

Valores válidos:

  • NULL (padrão): Desativa a criptografia de disco em nuvem.

  • CloudDisk: Ativa a criptografia de disco em nuvem. Se você selecionar este valor, deverá especificar o parâmetro EncryptionKey.

Nota

Não é possível desativar a criptografia de disco em nuvem após ativá-la.

MasterNodeNum

Integer

Não

Não

Número de nós coordenadores.

Valores válidos: 1 e 2.

Nota

Se você não especificar este parâmetro, o valor padrão será 1.

DBInstanceMode

String

Não

Não

Modo de armazenamento da instância.

Valores válidos:

  • StorageElastic: Modo de armazenamento elástico.

  • Serverless: Modo Serverless.

  • Classic: Modo de armazenamento reservado.

SegDiskPerformanceLevel

String

Não

Não

Nível de desempenho (PL) do SSD aprimorado (ESSD).

Valores válidos:

  • pl0: PL0.

  • pl1: PL1.

  • pl2: PL2.

Nota

Este parâmetro se aplica apenas quando o tipo de armazenamento em disco é ESSD.

Se você não especificar este parâmetro, o valor padrão será pl1.

DBInstanceCategory

String

Não

Não

Edição da instância.

Valores válidos:

  • HighAvailability: High-availability Edition.

  • Basic: Basic Edition.

Nota

Este parâmetro é obrigatório para instâncias no modo de armazenamento elástico.

SegStorageType

String

Não

Não

Tipo de armazenamento em disco.

Atualmente, apenas SSDs aprimorados (ESSDs) são suportados. Defina o valor como cloud_essd.

Nota

Este parâmetro é obrigatório para instâncias no modo de armazenamento elástico.

StorageSize

Integer

Não

Não

Capacidade de armazenamento.

Unidade: GB. Valores válidos: 50 a 8000.

EncryptionKey

String

Não

Não

ID da chave.

Este parâmetro é obrigatório apenas quando EncryptionType está definido como CloudDisk. Você deve especificar o ID de uma chave que esteja na mesma região da instância. Caso contrário, deixe este parâmetro vazio.

CreateSampleData

Boolean

Não

Não

Define se um conjunto de dados de amostra deve ser carregado após a criação da instância.

Valores válidos:

  • true: Carrega um conjunto de dados de amostra.

  • false (padrão): Não carrega um conjunto de dados de amostra.

ServerlessMode

String

Não

Não

Modo da instância Serverless.

Valores válidos:

  • Manual (padrão): Agendamento manual.

  • Auto: Agendamento automático.

Nota

Este parâmetro é obrigatório para instâncias no modo Serverless.

ServerlessResource

Integer

Não

Não

Limiar de recursos de computação.

O valor deve estar entre 8 e 32, em incrementos de 8 ACU. Valor padrão: 32.

Nota

Este parâmetro é obrigatório para instâncias no modo Serverless que utilizam agendamento automático.

PrivateIpAddress

String

Não

Não

Endereço IP privado.

Nenhuma.

SegNodeNum

Integer

Não

Não

Número de nós de computação.

Valores válidos:

  • Para uma instância High-availability Edition no modo de armazenamento elástico: 4 a 512. O valor deve ser um múltiplo de 4.

  • Para uma instância Basic Edition no modo de armazenamento elástico: 2 a 512. O valor deve ser um múltiplo de 2.

  • Para uma instância no modo Serverless: 2 a 512. O valor deve ser um múltiplo de 2.

Nota

Este parâmetro é obrigatório para instâncias no modo de armazenamento elástico ou no modo Serverless.

InstanceSpec

String

Não

Não

Especificações dos nós de computação.

  • Valores para a High-availability Edition no modo de armazenamento elástico:

    • 2C16G

    • 4C32G

    • 16C128G

  • Valores para a Basic Edition no modo de armazenamento elástico:

    • 2C8G

    • 4C16G

    • 8C32G

    • 16C64G

  • Valores para o modo Serverless:

    • 4C16G

    • 8C32G

Nota

Este parâmetro é obrigatório para instâncias no modo de armazenamento elástico ou no modo Serverless.

IdleTime

Integer

Não

Não

Tempo ocioso em segundos antes da suspensão automática da instância.

A instância fica ociosa após esse período de inatividade. Valor mínimo: 60. Valor padrão: 600.

Nota

Este parâmetro é obrigatório para instâncias no modo Serverless que utilizam agendamento automático.

ProdType

String

Não

Não

Tipo de produto.

Valores válidos:

  • standard (padrão): Standard Edition.

  • cost-effective: Cost-efficient Edition.

MasterCU

Integer

Não

Não

Recursos do nó coordenador.

Nenhuma.

StandbyZoneId

String

Não

Não

ID da zona de disponibilidade secundária.

Nenhuma.

StandbyVSwitchId

String

Não

Não

ID do vSwitch secundário.

Nenhuma.

DeployMode

String

Não

Não

Modo de implantação.

Nenhuma.

ResourceGroupId

String

Não

Sim

ID do grupo de recursos.

Nenhuma.

VectorConfigurationStatus

String

Não

Não

Define se a otimização do mecanismo vetorial deve ser ativada.

Valores válidos:

  • enabled: Ativa a otimização do mecanismo vetorial.

  • disabled (padrão): Desativa a otimização do mecanismo vetorial.

Nota
  • Recomendamos desativar este recurso para cenários de análise convencional, data warehousing e data warehousing em tempo real.

  • Recomendamos ativar este recurso para cenários que exigem um mecanismo de análise vetorial, como conteúdo gerado por IA (AIGC) e recuperação vetorial.

ZoneId

String

Sim

Não

ID da zona de disponibilidade.

Exemplo: cn-hangzhou-h.

Para obter mais informações sobre zonas de disponibilidade, consulte Visualizar regiões e zonas disponíveis.

Sintaxe de AINodeSpecInfos

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

Propriedades de AINodeSpecInfos

Parâmetro

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

AINodeSpec

String

Sim

Não

Especificações de um nó de IA.

Nenhuma.

AINodeNum

Integer

Sim

Não

Número de nós de IA.

Nenhuma.

Sintaxe de Tags

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

Propriedades de Tags

Parâmetro

Tipo

Obrigatório

Atualização permitida

Descrição

Restrições

Key

String

Sim

Não

Chave da tag.

A chave deve ter de 1 a 128 caracteres. A chave não pode começar com aliyun ou acs: e não pode conter http:// ou https://.

Value

String

Não

Não

Valor da tag.

O valor pode ter de 0 a 128 caracteres. O valor não pode começar com aliyun ou acs: e não pode conter http:// ou https://.

Valores de retorno

Fn::GetAtt

  • DBInstanceId: ID da instância.

  • Port: Número da porta da instância.

  • OrderId: ID do pedido.

  • ConnectionString: Endpoint da instância.

  • Arn: Alibaba Cloud Resource Name (ARN) da instância.

Exemplos

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
{
  "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"] }
    }
  }
}