Tüm Ürünler
Search
Belge Merkezi

:CreateDBNodes

Son Güncelleme:Sep 30, 2026

Bir PolarDB kümesine salt okunur düğümler ekler.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

polardb:CreateDBNodes

create

*dbcluster

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

None None

Request parameters

Parameter

Type

Required

Description

Example

ResourceGroupId

string

No

Kaynak grubu kimliği.

rg-************

DBClusterId

string

Yes

Küme kimliği.

pc-*************

ClientToken

string

No

İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Değeri oluşturmak için istemciyi kullanabilirsiniz. Değerin farklı istekler arasında benzersiz olduğundan emin olun. Belirteç büyük/küçük harfe duyarlıdır ve yalnızca ASCII karakterleri içerebilir. Belirteç en fazla 64 karakter uzunluğunda olabilir.

6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

EndpointBindList

string

No

Yeni düğümü eklemek istediğiniz küme uç noktasının kimliği. Düğümü birden fazla uç noktaya eklemek istiyorsanız, uç nokta kimliklerini virgül (,) ile ayırın.

Not
  • Uç nokta kimlikleri dahil olmak üzere küme uç noktalarının ayrıntılarını sorgulamak için DescribeDBClusterEndpoints işlemini çağırabilirsiniz.

  • Varsayılan küme uç noktasının ve özel küme uç noktalarının kimliklerini belirtebilirsiniz.

  • Bu parametreyi boş bırakırsanız, yeni düğüm Yeni Düğümleri Otomatik Olarak İlişkilendir özelliği etkinleştirilmiş (AutoAddNewNodes değeri Enable olan) tüm küme uç noktalarına eklenir.

pe-****************,pe-****************

PlannedStartTime

string

No

Düğüm ekleme için zamanlanmış görevi çalıştırmaya başlamak üzere en erken zaman. Zamanı YYYY-MM-DDThh:mm:ssZ biçiminde (UTC) belirtin.

Not
  • Başlangıç zamanı sonraki 24 saat içinde olmalıdır. Örneğin, geçerli zaman 2021-01-14T09:00:00Z ise, 2021-01-14T09:00:00Z ile 2021-01-15T09:00:00Z aralığında bir başlangıç zamanı belirtebilirsiniz.

  • Bu parametreyi boş bırakırsanız, düğüm ekleme görevi anında çalıştırılır.

2021-01-14T09:00:00Z

PlannedEndTime

string

No

Zamanlanmış görevi çalıştırmaya başlamak için en geç zaman. Zamanı YYYY-MM-DDThh:mm:ssZ biçiminde (UTC) belirtin.

Not
  • En geç zaman, başlangıç zamanından en az 30 dakika sonra olmalıdır.

  • PlannedStartTime parametresini belirtip bu parametreyi boş bırakırsanız, en geç zaman varsayılan olarak başlangıç zamanı + 30 dakika olur. Örneğin, PlannedStartTime değerini 2021-01-14T09:00:00Z olarak ayarlayıp bu parametreyi boş bırakırsanız, görev en geç 2021-01-14T09:30:00Z zamanında başlar.

2021-01-14T09:30:00Z

DBNode

array<object>

Yes

Yeni düğüm hakkındaki bilgiler.

object

No

TargetClass

string

No

Yeni düğümün teknik özellikleri. Teknik özellikler, mevcut düğümlerinkiyle aynı olmalıdır. Daha fazla bilgi için aşağıdaki konulara bakın:

Not
  • DBNode.N.ZoneId ve DBNode.N.TargetClass parametrelerinden en az birini belirtmelisiniz. N, 1'den başlayan bir tam sayıdır. N'nin maksimum değeri = 16 - geçerli düğüm sayısı.

  • Yalnızca PolarDB for MySQL kümeleri, aynı anda birden fazla salt okunur düğüm eklemeyi destekler. En fazla 15 salt okunur düğüm ekleyebilirsiniz.

  • Bu parametre, PolarDB for PostgreSQL (Oracle Uyumlu) veya PolarDB for PostgreSQL kümeleri için gereklidir. Bu parametre, PolarDB for MySQL kümeleri için isteğe bağlıdır.

polar.mysql.x4.medium

ZoneId

string

No

Yeni düğümün bölgesi. Bölge, mevcut düğümlerinkiyle aynı olmalıdır. Bölge kimliklerini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

Not
  • DBNode.N.ZoneId ve DBNode.N.TargetClass parametrelerinden en az birini belirtmelisiniz. N, 1'den başlayan bir tam sayıdır. N'nin maksimum değeri = 16 - geçerli düğüm sayısı.

  • Yalnızca PolarDB for MySQL kümeleri, aynı anda birden fazla salt okunur düğüm eklemeyi destekler. En fazla 15 salt okunur düğüm ekleyebilirsiniz.

  • Bu parametre, PolarDB for PostgreSQL (Oracle Uyumlu) veya PolarDB for PostgreSQL kümeleri için gereklidir. Bu parametre, PolarDB for MySQL kümeleri için isteğe bağlıdır.

cn-qingdao-c

DBNodeType

string

No

Düğüm türü. Geçerli değerler:

  • RO

  • STANDBY

  • DLNode.

Valid values:

  • DLNode :

    Yapay zeka düğümü.

  • STANDBY :

    Yedek düğüm.

  • RO :

    Salt okunur düğüm.

RO

ImciSwitch

string

No

Bellek İçi Sütun Dizininin (IMCI) etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • ON: etkin.

  • OFF: devre dışı. Bu, varsayılan değerdir.

Not

PolarDB for PostgreSQL (Oracle Uyumlu) ve PolarDB for PostgreSQL bu parametreyi desteklemez.

ON

CloudProvider

string

No

Düğümün ait olduğu bulut hizmeti sağlayıcısı.

ENS

AutoUseCoupon

boolean

No

Kuponların otomatik olarak kullanılıp kullanılmayacağını belirtir. Geçerli değerler:

  • true (varsayılan): Kuponları kullan.

  • false: Kuponları kullanma.

PromotionCode

string

No

Kupon kodu. Bu parametreyi belirtmezseniz, varsayılan kupon kullanılır.

727xxxxxx934

Response elements

Element

Type

Description

Example

object

DBNodeIds

object

DBNodeId

array

Oluşturulan DBNodeId değerlerinin listesi.

string

Oluşturulan DBNodeId değerlerinin listesi.

pi-***************

RequestId

string

İstek kimliği.

E053E730-5755-4AA9-AA9D-A47867******

DBClusterId

string

Küme kimliği.

pc-***************

OrderId

string

Sipariş kimliği.

2148126708*****

Examples

Success response

JSON format

{
  "DBNodeIds": {
    "DBNodeId": [
      "pi-***************"
    ]
  },
  "RequestId": "E053E730-5755-4AA9-AA9D-A47867******",
  "DBClusterId": "pc-***************",
  "OrderId": "2148126708*****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ORDER.ARREARAGE 您有欠费账单,不符合购买条件,请先结清账单后再购买
400 InvalidDBNodeNum.Malformed The number of parameter DBNode.N is not valid.
400 InvalidDBNode.Malformed The specified parameter DBNode.N is not valid.
400 OperationDenied.CreateDBNodesWithStrictConsistencyOn 3AZ cluster does not allow create db nodes.
400 InvalidZoneId.Malformed The specified parameter ZoneId is not valid.
403 OperationDenied.ClusterCategory The operation is not permitted due to cluster category.
403 OperationDenied.DbVersion The operation is not permitted due to DbVersion.
404 InvalidDBClusterId.NotFound The DBClusterId provided does not exist in our records.
404 InvalidDBClusterId.Malformed The specified parameter DBClusterId is not valid.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.