Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::POLARDB::DBNodes

Última atualização: Jun 27, 2026

Adiciona nós a um cluster do PolarDB.

Sintaxe

 {
  "Type": "ALIYUN::POLARDB::DBNodes",
  "Properties": {
    "DBClusterId": String,
    "Amount": Integer,
    "ImciSwitch": String,
    "ResourceGroupId": String,
    "DBNodeType": String,
    "EndpointBindList": List,
    "PlannedEndTime": String,
    "PlannedStartTime": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

DBClusterId

String

Sim

Não

ID do cluster do PolarDB.

Nenhuma.

Amount

Integer

Sim

Sim

Número de nós a adicionar ao cluster.

Nenhuma.

ImciSwitch

String

Não

Não

Defina se o recurso In-Memory Column Index (IMCI) está ativado.

Valores válidos:

  • ON

  • OFF

ResourceGroupId

String

Não

Não

ID do grupo de recursos.

Nenhuma.

DBNodeType

String

Não

Não

Tipo do nó.

Valores válidos:

  • RO

  • STANDBY

  • DLNode

EndpointBindList

List

Não

Não

IDs dos endpoints de cluster aos quais os nós serão adicionados.

Nota

Chame a operação DescribeDBClusterEndpoints para consultar os endpoints do cluster, incluindo seus IDs.

Especifique os IDs do endpoint de cluster padrão e de um endpoint de cluster personalizado.

Se esta propriedade estiver vazia, os nós serão adicionados a todos os endpoints de cluster com o recurso Automatically Associate New Nodes ativado. Definir AutoAddNewNodes como Enable ative o recurso Automatically Associate New Nodes.

PlannedEndTime

String

Não

Não

Horário mais tardio em que a tarefa agendada pode iniciar.

Especifique o horário no padrão ISO 8601, no formato YYYY-MM-DDThh:mm:ssZ. O horário deve estar em UTC.

Nota

O horário de início mais tardio deve ser pelo menos 30 minutos posterior ao horário de início mais cedo.

Ao definir PlannedStartTime e deixar PlannedEndTime vazio, o sistema considera o horário de início mais tardio como 30 minutos após o horário de início mais cedo por padrão. Por exemplo, se você definir PlannedStartTime como 2021-01-14T09:00:00Z e deixar PlannedEndTime vazio, o horário de início mais tardio da tarefa será 2021-01-14T09:30:00Z.

PlannedStartTime

String

Não

Não

Horário mais cedo em que a tarefa agendada de adição de nós pode iniciar.

Especifique o horário de início mais cedo no padrão ISO 8601, no formato YYYY-MM-DDThh:mm:ssZ. O horário deve estar em UTC.

Nota

O horário de início mais cedo da tarefa pode ser qualquer momento dentro das próximas 24 horas a partir do horário atual. Por exemplo, se o horário atual for 2021-01-14T09:00:00Z, especifique um horário entre 2021-01-14T09:00:00Z e 2021-01-15T09:00:00Z.

Se esta propriedade estiver vazia, a tarefa de adição de nós será executada imediatamente por padrão.

Valores de retorno

Fn::GetAtt

  • DBNodeIds: IDs dos nós adicionados ao cluster.

  • OrderIds: IDs dos pedidos.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DBClusterId:
    Type: String
    Description: The ID of the ApsaraDB for POLARDB cluster to be added nodes to.
Resources:
  DBNodes:
    Type: ALIYUN::POLARDB::DBNodes
    Properties:
      DBClusterId:
        Ref: DBClusterId
      Amount: 1
Outputs:
  DBNodeIds:
    Description: The ID list of added cluster nodes.
    Value:
      Fn::GetAtt:
        - DBNodes
        - DBNodeIds
  OrderIds:
    Description: The order ID list of added cluster nodes.
    Value:
      Fn::GetAtt:
        - DBNodes
        - OrderIds
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DBClusterId": {
      "Type": "String",
      "Description": "The ID of the ApsaraDB for POLARDB cluster to be added nodes to."
    }
  },
  "Resources": {
    "DBNodes": {
      "Type": "ALIYUN::POLARDB::DBNodes",
      "Properties": {
        "DBClusterId": {
          "Ref": "DBClusterId"
        },
        "Amount": 1
      }
    }
  },
  "Outputs": {
    "DBNodeIds": {
      "Description": "The ID list of added cluster nodes.",
      "Value": {
        "Fn::GetAtt": [
          "DBNodes",
          "DBNodeIds"
        ]
      }
    },
    "OrderIds": {
      "Description": "The order ID list of added cluster nodes.",
      "Value": {
        "Fn::GetAtt": [
          "DBNodes",
          "OrderIds"
        ]
      }
    }
  }
}