Tüm Ürünler
Search

Bu Ürün

    :CreateShardingDBInstance

    Belge Merkezi

    :CreateShardingDBInstance

    Son Güncelleme:Oct 03, 2026

    ApsaraDB for MongoDB parçalı küme örneği oluşturur veya klonlar.

    • Bu işlemi çağırmadan önce ApsaraDB for MongoDB faturalandırma yöntemlerini ve fiyatlandırmayı

      tam olarak anladığınızdan emin olun.

    • ApsaraDB for MongoDB örneklerinin örnek türleri hakkında daha fazla bilgi için bkz.Örnek türleri.

    • Bağımsız ve çoğaltma kümesi örnekleri oluşturmak için CreateDBInstance işlemini çağırabilirsiniz.

    Hata Ayıklama

    OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlemin örnek kodunu dinamik olarak oluşturur.

    İstek parametreleri

    ParametreTürGerekliÖrnekAçıklama
    RegionIdStringEvetcn-hangzhou

    Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    ActionStringEvetCreateShardingDBInstance

    Gerçekleştirmek istediğiniz işlem. Değeri CreateShardingDBInstance olarak ayarlayın.

    ZoneIdStringHayırcn-hangzhou-g

    Örneğin alan kimliği. En güncel alan listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    EngineStringEvetMongoDB

    Örneğin altyapısı. Değeri MongoDB olarak ayarlayın.

    EngineVersionStringEvet4,4

    Veritabanı altyapısının sürümü. Geçerli değerler:

    • 6,0
    • 5,0
    • 4,4
    • 4,2
    • 4,0
    Not
    • Veritabanı sürümleri ve depolama altyapıları üzerindeki sınırlamalar hakkında daha fazla bilgi için bkz. MongoDB sürümleri ve depolama altyapıları.
    • Bir örneği klonlamak için bu işlemi çağırırsanız değeri kaynak örneğin altyapısına ayarlayın.
    DBInstanceDescriptionStringHayırtest

    Örneğin adı. Geçerli değerler:

    • Ad bir harfle başlamalıdır.
    • Ad rakamlar, harfler, alt çizgiler (_) ve tireler (-) içerebilir.
    • Açıklama 2 ila 256 karakter uzunluğunda olmalıdır.
    SecurityIPListStringHayır192.168.xx.xx,192.168.xx.xx

    Bir IP adresi izin listesindeki IP adresleri. Birden fazla IP adresini virgül (,) ile ayırın. IP adresi izin listesindeki her IP adresi benzersiz olmalıdır. Aşağıdaki tahmini değer türleri desteklenir:

    • 0.0.0.0/0
    • IP adresleri, örneğin 10.23.12.24.
    • Sınıfsız Alanlar Arası Yönlendirme (CIDR) blokları, örneğin 10.23.12.0/24. Bu durumda /24, her IP adresinin ön ekinin 24 bit uzunluğunda olduğunu gösterir. 24 yerine 1 ila 32 aralığında bir değer kullanabilirsiniz.
      Not
      • Her örnek için en fazla 1.000 IP adresi ve CIDR bloğu yapılandırılabilir.
      • 0.0.0.0/0 girerseniz tüm IP adresleri örneğe erişebilir. Bu durum örnek için güvenlik riskleri oluşturabilir.
    AccountPasswordStringHayır123456Aa

    Kök hesabının parolası. Parola aşağıdaki gereksinimleri karşılamalıdır:

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

    Örneğin faturalandırma yöntemi. Geçerli değerler:

    • PostPaid: kullandıkça öde
    • PrePaid: abonelik
    Not Bu parametreyi PrePaid olarak belirtirseniz Period parametresini de belirtmeniz gerekir.
    PeriodIntegerHayır1

    Örneğin abonelik süresi. Birim: ay.

    Geçerli değerler: 1 ila 9, 12, 24, 36 ve 60.

    Not ChargeType özelliğini PrePaid olarak ayarlarsanız bu özelliği yapılandırmanız gerekir.
    NetworkTypeStringHayırVPC

    Örneğin ağ türü. Geçerli değerler:

    VPC

    VpcIdStringEvetvpc-bp1n3i15v90el48nx****

    Örneğin VPC kimliği.

    VSwitchIdStringEvetvsw-bp1vj604nj5a9zz74****

    Örneğin vSwitch kimliği.

    SrcDBInstanceIdStringHayırdds-bp11483712c1****

    Kaynak veritabanının kimliği.

    Not Kaynak örneğin kimliği. Bu parametre yalnızca bir örneği klonlamak için bu işlemi çağırdığınızda gereklidir. Bu parametreyi belirtirseniz RestoreTime parametresini de belirtmeniz gerekir.
    RestoreTimeStringHayır2022-03-08T02:30:25Z

    Örneğin klonlanacağı zaman noktası. Bu süre yedi gün içinde olmalıdır. Saati yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Saat UTC cinsinden olmalıdır.

    Not Bu parametre yalnızca bir örneği klonlamak için bu işlemi çağırdığınızda gereklidir. Bu parametreyi belirtirseniz SrcDBInstanceId parametresini de belirtmeniz gerekir.
    ClientTokenStringHayırETnLKlblzczshOTUbOCz****

    İsteğin aynı tekrarlanmasını (idempotency) sağlamak için kullanılan istemci belirteci. Değeri istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve 64 karakteri aşamaz.

    StorageEngineStringHayırWiredTiger

    Örneğin depolama altyapısı. Varsayılan değer: WiredTiger.

    Not
    • Bir örneği klonlamak için bu işlemi çağırırsanız değeri kaynak örneğin altyapısına ayarlayın.
    • Veritabanı sürümleri ve depolama altyapıları üzerindeki sınırlamalar hakkında daha fazla bilgi için bkz. MongoDB sürümleri ve depolama altyapıları.
    AutoRenewStringHayırtrue

    Örnek için otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Varsayılan değer: false. Geçerli değerler:

    • true
    • false
    Not ChargeType parametresini PrePaid olarak ayarlarsanız bu isteğe bağlı parametreyi yapılandırmanız gerekir.
    ProtocolTypeStringHayırmongodb

    Örneğin erişim protokolü türü. Geçerli değerler:

    • mongodb: MongoDB protokolü
    • dynamodb: DynamoDB protokolü
    Mongos.N.ClassStringEvetmdb.shard.2x.xlarge.d

    Mongos düğümünün örnek türü. Daha fazla bilgi için bkz. Örnek türleri.

    Not
    • N, örnek türünün belirtildiği mongos düğümünün seri numarasını belirtir. Örneğin, Mongos.2.Class ikinci mongos düğümünün örnek türünü belirtir.
    • N için geçerli değerler: 2 ila 32.
    ReplicaSet.N.ClassStringEvetdds.shard.standard

    Parça düğümünün örnek türü. Daha fazla bilgi için bkz. Örnek türleri.

    Not
    • N, örnek türünün belirtildiği parça düğümünün seri numarasını belirtir. Örneğin, ReplicaSet.2.Class ikinci parça düğümünün örnek türünü belirtir.
    • N için geçerli değerler: 2 ila 32.
    ReplicaSet.N.StorageIntegerEvet10

    Parça düğümünün depolama kapasitesi. Birim: GB.

    Not
    • Bu parametre için belirtilebilecek değerler örnek türlerine bağlıdır. Daha fazla bilgi için bkz. Örnek türleri.
    • N, depolama kapasitesinin belirtildiği parça düğümünün seri numarasını belirtir. Örneğin, ReplicaSet.2.Storage ikinci parça düğümünün depolama kapasitesini belirtir.
    ReplicaSet.N.ReadonlyReplicasIntegerHayır0

    N parça düğümündeki salt okunur düğüm sayısı.

    Geçerli değerler: 0 ila 5. Değer bir tamsayı olmalıdır. Varsayılan değer: 0.

    Not N, salt okunur düğüm sayısını ayarlamak istediğiniz parça düğümünün seri numarasını belirtir. ReplicaSet.2.ReadonlyReplicas ikinci parça düğümündeki salt okunur düğüm sayısını belirtir.
    ConfigServer.N.ClassStringEvetmdb.shard.2x.xlarge.d

    Configserver düğümünün örnek türü. Geçerli değer:

    • mdb.shard.2x.xlarge.d: 4 çekirdek, 8 GB (özel). Yalnızca MongoDB 4,4 ve sonraki sürümleri çalıştıran örnekler bu örnek türünü destekler.
    • dds.cs.mid :1 çekirdek, 2 GB (genel amaçlı). Yalnızca MongoDB 4,2 ve önceki sürümleri çalıştıran örnekler bu örnek türünü destekler.
    ConfigServer.N.StorageIntegerEvet20

    Configserver düğümünün depolama kapasitesi. Birim: GB.

    Not Bu parametre için belirtilebilecek değerler örnek türlerine bağlıdır. Daha fazla bilgi için bkz. Örnek türleri.
    StorageTypeStringHayırcloud_essd1

    Örneğin depolama türü. Geçerli değerler:

    • cloud_essd1 :ESSD PL1.
    • cloud_essd2: ESSD PL2.
    • cloud_essd3: ESSD PL3.
    • local_ssd: yerel SSD
    Not
    • MongoDB 4,4 ve sonraki sürümlerin örnekleri yalnızca cloud diskleri destekler. Bu parametreyi boş bırakırsanız cloud_essd1 seçilir.
    • MongoDB 4,2 ve önceki sürümlerin örnekleri yalnızca yerel diskleri destekler. Bu parametreyi boş bırakırsanız local_ssd seçilir.

    Yanıt parametreleri

    Parametre Tür Örnek Açıklama
    RequestId String D8F1D721-6439-4257-A89C-F1E8E9C9****


    İsteğin kimliği.
    DBInstanceId String dds-bp114f14849d****


    Örneğin kimliği
    OrderId String 21010996721****


    Siparişin kimliği.

    Örnekler

    Örnek istekler

    http(s)://mongodb.aliyuncs.com/?RegionId=cn-hangzhou
&Action=CreateShardingDBInstance
&ZoneId=cn-hangzhou-g
&Engine=MongoDB
&EngineVersion=4.4
&DBInstanceDescription=test
&SecurityIPList=192.168.xx.xx,192.168.xx.xx
&AccountPassword=123456Aa
&ChargeType=PrePaid
&Period=1
&NetworkType=VPC
&VpcId=vpc-bp1n3i15v90el48nx****
&VSwitchId=vsw-bp1vj604nj5a9zz74****
&SrcDBInstanceId=dds-bp11483712c1****
&RestoreTime=2022-03-08T02:30:25Z
&ClientToken=ETnLKlblzczshOTUbOCz****
&StorageEngine=WiredTiger
&AutoRenew=true
&ProtocolType=mongodb
&Mongos=[{"Class":"mdb.shard.2x.xlarge.d"}]
&ReplicaSet=[{"Class":"dds.shard.standard","Storage":10,"ReadonlyReplicas":0}]
&ConfigServer=[{"Class":"mdb.shard.2x.xlarge.d","Storage":20}]
&StorageType=cloud_essd1
&<Common request parameters>

    Örnek başarılı yanıt

    XML biçimi

    HTTP/1.1 200 OK
Content-Type:application/xml

<CreateShardingDBInstanceResponse>
    <RequestId>D8F1D721-6439-4257-A89C-F1E8E9C9****</RequestId>
    <DBInstanceId>dds-bp114f14849d****</DBInstanceId>
    <OrderId>21010996721****</OrderId>
</CreateShardingDBInstanceResponse>

    JSON biçimi

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D8F1D721-6439-4257-A89C-F1E8E9C9****",
  "DBInstanceId" : "dds-bp114f14849d****",
  "OrderId" : "21010996721****"
}

    Hata kodları

    Hata kodlarının listesi için bkz. Hizmet hata kodları.