Tüm Ürünler
Search
Belge Merkezi

Resource Orchestration Service:ALIYUN::MONGODB::ShardingInstance

Son Güncelleme:Oct 05, 2026

ALIYUN::MONGODB::ShardingInstance kaynağı, bir ApsaraDB for MongoDB parçalı küme örneği oluşturmak veya klonlamak için kullanılır.

Syntax

{
  "Type": "ALIYUN::MONGODB::ShardingInstance",
  "Properties": {
    "EngineVersion": String,
    "ZoneId": String,
    "AutoRenew": Boolean,
    "VSwitchId": String,
    "Period": Integer,
    "SecurityIPArray": String,
    "Mongos": List,
    "StorageEngine": String,
    "RestoreTime": String,
    "AccountPassword": String,
    "VpcId": String,
    "ProtocolType": String,
    "ChargeType": String,
    "ConfigServer": List,
    "SrcDBInstanceId": String,
    "ReplicaSet": List,
    "Tags": List,
    "TDEStatus": Boolean,
    "DBInstanceDescription": String,
    "ResourceGroupId": String,
    "SecondaryZoneId": String,
    "HiddenZoneId": String,
    "StorageType": String
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

ConfigServer

List

Yes

No

ConfigServer düğümünün yapılandırmaları.

Daha fazla bilgi için bkz. ConfigServer özellikleri.

Mongos

List

Yes

No

mongos düğümleri.

2 ile 32 arasında mongos düğümü kullanabilirsiniz.

Daha fazla bilgi için bkz. Mongos özelliği.

ReplicaSet

List

Yes

No

Parça (shard) düğümleri.

2 ile 32 arasında parça düğümü kullanabilirsiniz.

Daha fazla bilgi için bkz. ReplicaSet özellikleri.

EngineVersion

String

No

No

Veritabanı altyapısının sürümü.

Geçerli değerler:

  • 3.4

  • 4.0

  • 4.2

Not

Bir örneği klonlarken bu özelliğin değeri, kaynak örneğin veritabanı altyapısı sürümüyle aynı olmalıdır.

ZoneId

String

No

No

Alan kimliği.

Yok.

AutoRenew

Boolean

No

No

Örnek için otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir.

Geçerli değerler:

  • true: Örnek için otomatik yenilemeyi etkinleştirir.

  • false (varsayılan): Örnek için otomatik yenilemeyi devre dışı bırakır. Örneği manuel olarak yenilemeniz gerekir.

Not

Bu özellik, ChargeType PrePaid olarak ayarlandığında geçerli olur.

VSwitchId

String

No

No

vSwitch kimliği.

Yok.

Period

Integer

No

Yes

Örneğin abonelik süresi.

Geçerli değerler: 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24 ve 36.

Birim: ay.

Not

ChargeType PrePaid olarak ayarlandığında bu özelliği belirtmeniz gerekir.

SecurityIPArray

String

No

Yes

Örneğin IP adresi izin listesindeki girişler.

İzin listesindeki birden çok IP adresini virgülle (,) ayırın. Her IP adresi izin listesinde benzersiz olmalıdır. İzin listesi en fazla 1.000 IP adresi içerebilir.

İzin listesinde aşağıdaki biçimlerde girişler belirtebilirsiniz:

  • %.

  • 0.0.0.0/0.

  • IP adresleri, örneğin 10,23.XX.XX.

  • CIDR blokları, örneğin 10,23.XX.XX/24. /24, CIDR bloğunun ön ekinin 24 bit uzunluğunda olduğunu belirtir. 24 yerine 1 ile 32 arasındaki bir değeri kullanabilirsiniz.

Not

% ve 0.0.0.0/0 değerleri, örnekteki veritabanlarına tüm IP adreslerinden erişilebileceğini belirtir. Bu durum güvenlik risklerine neden olabilir. Bu değerleri kullanırken dikkatli olun.

StorageEngine

String

No

No

Örnek tarafından kullanılan depolama altyapısı.

Geçerli değerler:

  • WiredTiger (varsayılan): Çoğu senaryo için uygundur.

  • RocksDB: Çok sayıda yazma işlemi ve az sayıda okuma işleminin yapıldığı senaryolar için uygundur.

  • TerarkDB: Yazma işlemlerinden daha fazla okuma işleminin yapıldığı senaryolar veya aynı anda birden çok yazma işleminin ve çok sayıda okuma işleminin yapıldığı senaryolar için uygundur.

Not

Bir örneği klonlarken bu özelliğin değeri, kaynak örneğin depolama altyapısıyla aynı olmalıdır.

RestoreTime

String

No

No

Örneği klonlarken verileri geri yüklemek istediğiniz zaman noktası.

Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Zaman UTC cinsinden olmalıdır. Bu özelliği yalnızca bir örneği klonlarken belirtebilirsiniz. Bu özelliği SrcDBInstanceId özelliğiyle birlikte belirtmeniz gerekir.

Not

Bu özelliği önceki yedi gün içindeki bir zaman noktasına ayarlayabilirsiniz.

AccountPassword

String

No

Yes

Kök hesabın parolası.

Parola 8 ila 32 karakter uzunluğunda olmalıdır. Büyük harfler, küçük harfler, rakamlar ve özel karakterler olmak üzere aşağıdaki karakter türlerinden en az üçünü içermelidir. Desteklenen özel karakterler şunlardır: ! # $ % ^ & * ( ) _ + - =.

VpcId

String

No

No

Sanal özel cloud (VPC) kimliği.

Yok.

ProtocolType

String

No

No

Erişim protokolü türü.

Geçerli değerler:

  • mongodb

  • dynamodb

ChargeType

String

No

Yes

Örneğin faturalandırma yöntemi.

Geçerli değerler:

  • PostPaid (varsayılan): Kullandıkça öde.

  • PrePaid: Abonelik.

    Not

    Bu özelliği PrePaid olarak ayarlarsanız Period değerini belirtmeniz gerekir.

SrcDBInstanceId

String

No

No

Kaynak örnek kimliği.

Bu özelliği yalnızca bir örneği klonlarken belirtebilirsiniz. Bu özelliği RestoreTime özelliğiyle birlikte belirtmeniz gerekir.

Tags

List

No

Yes

Etiketler.

En fazla 20 etiket ekleyebilirsiniz.

Daha fazla bilgi için bkz. Tags özellikleri.

TDEStatus

Boolean

No

Yes

Şeffaf veri şifrelemenin (TDE) etkinleştirilip etkinleştirilmeyeceğini belirtir.

Geçerli değerler:

  • true: TDE'yi etkinleştirir.

    Not

    TDE etkinleştirildikten sonra devre dışı bırakılamaz.

  • false (varsayılan): TDE'yi devre dışı bırakır.

ResourceGroupId

String

No

Yes

Örneğin ait olduğu kaynak grubunun kimliği.

Yok.

DBInstanceDescription

String

No

No

Örneğin adı.

Ad 2 ila 256 karakter uzunluğunda olmalı ve harfler, rakamlar, alt çizgiler (_) ve tire (-) içerebilir. Ad bir harfle başlamalıdır.

SecondaryZoneId

String

No

No

İkincil düğümün alan kimliği.

Geçerli değerler:

  • cn-hangzhou-g: Hangzhou G Alanı kimliği.

  • cn-hangzhou-h: Hangzhou H Alanı kimliği.

  • cn-hangzhou-i: Hangzhou I Alanı kimliği.

  • cn-hongkong-b: Hong Kong B Alanı kimliği.

  • cn-hongkong-c: Hong Kong C Alanı kimliği.

  • cn-hongkong-d: Hong Kong D Alanı kimliği.

  • cn-wulanchabu-a: Ulanqab A Alanı kimliği.

  • cn-wulanchabu-b: Ulanqab B Alanı kimliği.

  • cn-wulanchabu-c: Ulanqab C Alanı kimliği.

  • ap-southeast-1a: Singapur A Alanı kimliği.

  • ap-southeast-1b: Singapur B Alanı kimliği.

  • ap-southeast-1c: Singapur C Alanı kimliği.

  • ap-southeast-5a: Cakarta A Alanı kimliği.

  • ap-southeast-5b: Cakarta B Alanı kimliği.

  • ap-southeast-5c: Cakarta C Alanı kimliği.

  • eu-central-1a: Frankfurt A Alanı kimliği.

  • eu-central-1b: Frankfurt B Alanı kimliği.

  • eu-central-1c: Frankfurt C Alanı kimliği.

Not
  • EngineVersion 4.4 veya 5.0 olarak ayarlandığında bu özelliği belirtmeniz gerekir.

  • SecondaryZoneId değeri, ZoneId ve HiddenZoneId değerlerinden farklı olmalıdır.

HiddenZoneId

String

No

No

Gizli düğümün alan kimliği.

Geçerli değerler:

  • cn-hangzhou-g: Hangzhou G Alanı kimliği.

  • cn-hangzhou-h: Hangzhou H Alanı kimliği.

  • cn-hangzhou-i: Hangzhou I Alanı kimliği.

  • cn-hongkong-b: Hong Kong B Alanı kimliği.

  • cn-hongkong-c: Hong Kong C Alanı kimliği.

  • cn-hongkong-d: Hong Kong D Alanı kimliği.

  • cn-wulanchabu-a: Ulanqab A Alanı kimliği.

  • cn-wulanchabu-b: Ulanqab B Alanı kimliği.

  • cn-wulanchabu-c: Ulanqab C Alanı kimliği.

  • ap-southeast-1a: Singapur A Alanı kimliği.

  • ap-southeast-1b: Singapur B Alanı kimliği.

  • ap-southeast-1c: Singapur C Alanı kimliği.

  • ap-southeast-5a: Cakarta A Alanı kimliği.

  • ap-southeast-5b: Cakarta B Alanı kimliği.

  • ap-southeast-5c: Cakarta C Alanı kimliği.

  • eu-central-1a: Frankfurt A Alanı kimliği.

  • eu-central-1b: Frankfurt B Alanı kimliği.

  • eu-central-1c: Frankfurt C Alanı kimliği.

Not
  • EngineVersion 4.4 veya 5.0 olarak ayarlandığında bu özelliği belirtmeniz gerekir.

  • HiddenZoneId değeri, ZoneId ve SecondaryZoneId değerlerinden farklı olmalıdır.

StorageType

String

No

No

Depolama kategorisi.

Geçerli değerler:

  • cloud_essd1: PL1 Enterprise SSD (ESSD).

  • cloud_essd2: PL2 ESSD.

  • cloud_essd3: PL3 ESSD.

  • local_ssd: Yerel SSD.

Mongos syntax

"Mongos": [
  {
    "Class": String
  }
]

Mongos property


Property


Type


Required


Editable


Description


Constraint


Class


String


Yes


No


mongos düğümünün örnek türü.


Daha fazla bilgi için bkz. Örnek teknik özelliklerine genel bakış.

ConfigServer syntax

"ConfigServer": [
  {
    "Storage": Integer,
    "Class": String
  }
]

ConfigServer properties

Property

Type

Required

Editable

Description

Constraint

Class

String

Yes

No

ConfigServer düğümünün örnek türü.

Değeri dds.cs.mid olarak ayarlayın.

Not

Bu örnek türü 1 vCPU ve 2 GB belleğe sahiptir. ConfigServer düğüm sayısı 1 olarak sabittir.

Storage

Integer

Yes

No

ConfigServer düğümünün depolama kapasitesi.

Değeri 20 olarak ayarlayın.

Birim: GB.

Not

Depolama kapasitesi 20 GB olarak sabittir.

ReplicaSet syntax

"ReplicaSet": [
  {
    "Storage": Integer,
    "Class": String,
    "ReadonlyReplicas": Integer
  }
]

ReplicaSet properties

Property

Type

Required

Editable

Description

Constraint

Class

String

Yes

No

Parça düğümünün örnek türü.

Daha fazla bilgi için bkz. Örnek teknik özelliklerine genel bakış.

Storage

Integer

Yes

No

Parça düğümünün depolama kapasitesi.

Geçerli değerler: 10 ila 2000.

Birim: GB.

Değer 10 GB'lık artışlar halinde olmalıdır.

ReadonlyReplicas

Integer

No

No

Oluşturmak istediğiniz salt okunur düğüm sayısı.

Geçerli değerler: 1 ila 5.

Tags syntax

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

Tags properties


Property


Type


Required


Editable


Description


Constraint


Key


String


Yes


No


Etiket anahtarı.


Anahtar 1 ila 128 karakter uzunluğunda olmalı ve http:// veya https:// içermemelidir. aliyun veya acs: ile başlayamaz.


Value


String


No


No


Etiket değeri.


Değer en fazla 128 karakter uzunluğunda olabilir ve http:// veya https:// içermemelidir. aliyun veya acs: ile başlayamaz.

Return values

Fn::GetAtt

  • DBInstanceStatus: Örneğin durumu.

  • DBInstanceId: Örneğin kimliği.

  • OrderId: Siparişin kimliği.

  • Arn: Alibaba Cloud Kaynak Adı (ARN).

Examples

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneId:
    Type: String
    AssociationProperty: ALIYUN::ECS::ZoneId
Resources:
  MongoDbShardingInstance:
    Type: ALIYUN::MONGODB::ShardingInstance
    Properties:
      ZoneId:
        Ref: ZoneId
      EngineVersion: '4.0'
      Mongos:
        - Class: dds.mongos.mid
        - Class: dds.mongos.mid
      ReplicaSet:
        - Class: dds.shard.mid
          Storage: 10
        - Class: dds.shard.mid
          Storage: 20
      ConfigServer:
        - Class: dds.cs.mid
          Storage: 20
      TDEStatus: false
Outputs:
  DBInstanceStatus:
    Description: Status of mongodb instance.
    Value:
      Fn::GetAtt:
        - MongoDbShardingInstance
        - DBInstanceStatus
  DBInstanceId:
    Description: The instance id of created mongodb instance.
    Value:
      Fn::GetAtt:
        - MongoDbShardingInstance
        - DBInstanceId
  OrderId:
    Description: Order Id of created instance.
    Value:
      Fn::GetAtt:
        - MongoDbShardingInstance
        - OrderId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ZoneId": {
      "Type": "String",
      "AssociationProperty": "ALIYUN::ECS::ZoneId"
    }
  },
  "Resources": {
    "MongoDbShardingInstance": {
      "Type": "ALIYUN::MONGODB::ShardingInstance",
      "Properties": {
        "ZoneId": {
          "Ref": "ZoneId"
        },
        "EngineVersion": "4.0",
        "Mongos": [
          {
            "Class": "dds.mongos.mid"
          },
          {
            "Class": "dds.mongos.mid"
          }
        ],
        "ReplicaSet": [
          {
            "Class": "dds.shard.mid",
            "Storage": 10
          },
          {
            "Class": "dds.shard.mid",
            "Storage": 20
          }
        ],
        "ConfigServer": [
          {
            "Class": "dds.cs.mid",
            "Storage": 20
          }
        ],
        "TDEStatus": false
      }
    }
  },
  "Outputs": {
    "DBInstanceStatus": {
      "Description": "Status of mongodb instance.",
      "Value": {
        "Fn::GetAtt": [
          "MongoDbShardingInstance",
          "DBInstanceStatus"
        ]
      }
    },
    "DBInstanceId": {
      "Description": "The instance id of created mongodb instance.",
      "Value": {
        "Fn::GetAtt": [
          "MongoDbShardingInstance",
          "DBInstanceId"
        ]
      }
    },
    "OrderId": {
      "Description": "Order Id of created instance.",
      "Value": {
        "Fn::GetAtt": [
          "MongoDbShardingInstance",
          "OrderId"
        ]
      }
    }
  }
}

Daha fazla örnek için bkz. sharding-instance.yml.