Tüm Ürünler
Search

Bu Ürün

    :CreateDBInstance

    Belge Merkezi

    :CreateDBInstance

    Son Güncelleme:Oct 03, 2026

    ApsaraDB for MongoDB çoğaltma kümesi örneği oluşturur veya klonlar.

    Bu işlemi çağırmadan önce 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.

    Parçalanmış küme örnekleri oluşturmak için CreateShardingDBInstance işlemini çağırabilirsiniz.

    Hata Ayıklama

    OpenAPI Explorer imza değerini otomatik hesaplar. Kullanım kolaylığı açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

    İstek parametreleri

    ParametreTürGerekliÖrnekAçıklama
    ActionStringEvetCreateDBInstance

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

    RegionIdStringEvetcn-hangzhou

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

    ClientTokenStringHayırETnLKlblzczshOTUbOCz****

    İsteğin yinelenebilirliğini (idempotence) 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 olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.

    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 veritabanı altyapısı. Değer MongoDB olarak ayarlanır.

    EngineVersionStringEvet4.4

    Örneğin veritabanı altyapısı sürümü. Geçerli değerler:

    • 6.0
    • 5.0
    • 4.4
    • 4.2
    • 4.0
    Not Bir örneği klonlamak için bu işlemi çağırırsanız değeri kaynak örneğin veritabanı altyapısına ayarlayın.
    DBInstanceClassStringEvetdds.mongo.standard

    Örnek türü. Örnek türlerini görüntülemek için DescribeAvailableResource işlemini de çağırabilirsiniz.

    DBInstanceStorageIntegerEvet10

    Örneğin depolama kapasitesi. Birim: GB.

    Bu parametre için belirtilebilecek değerler örnek türlerine tabidir. Daha fazla bilgi için bkz. Çoğaltma kümesi örnek türleri.

    DBInstanceDescriptionStringHayırtest

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

    • Ad bir harfle başlamalıdır.
    • Ad rakam, harf, alt çizgi (_) ve kısa çizgi (-) içerebilir.
    • Ad 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 IP adresi 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; büyük harfler, küçük harfler, rakamlar ve özel karakterler olmak üzere aşağıdaki karakter türlerinden en az üçünü içermelidir.
    • 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 belirtmelisiniz.
    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-bp175iuvg8nxqraf2****

    Örneğin VPC kimliği.

    VSwitchIdStringEvetvsw-bp1gzt31twhlo0sa5****

    Örneğin vSwitch kimliği.

    SrcDBInstanceIdStringHayırdds-bp1ee12ad351****

    Kaynak örneğin kimliği.

    Not Bu parametre yalnızca örnekleri klonlamak için bu işlem çağrıldığında belirtilebilir. Ayrıca BackupId parametresini veya RestoreTime parametresini de belirtmelisiniz.
    BackupIdStringHayır32994****

    Yedekleme setinin kimliği. Yedekleme seti kimliğini sorgulamak için DescribeBackups işlemini çağırabilirsiniz.

    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 belirtmelisiniz.
    RestoreTimeStringHayır2022-03-13T12:11:14Z

    Örneği klonlamak için zaman damgası; son yedi gün içinde bir zaman olmalıdır. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Zaman 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 belirtmelisiniz.
    BusinessInfoStringHayır{“ActivityId":"000000000"}

    İş bilgileri. Bu ek bir parametredir.

    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.
    DatabaseNamesStringHayırmongodbtest

    Veritabanının adı.

    Not Bir örneği klonlamak için bu işlemi çağırdığınızda klonlama için bu parametre tarafından belirtilen veritabanlarını ayarlayabilirsiniz. Aksi takdirde örneğin tüm veritabanları klonlanır.
    CouponNoStringHayıryouhuiquan_promotion_option_id_for_blank

    Kupon kodu. Varsayılan değer: youhuiquan_promotion_option_id_for_blank.

    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 veritabanı 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ı.
    ReplicationFactorStringHayır3

    Çoğaltma kümesi örneğindeki düğüm sayısı. Varsayılan değer: 3. Geçerli değerler:

    • 3
    • 5
    • 7
    ReadonlyReplicasStringHayır0

    Çoğaltma kümesi örneğindeki salt okunur düğüm sayısı. Varsayılan değer: 0. Geçerli değerler: 0 ila 5.

    StorageTypeStringHayırcloud_essd

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

    • cloud_essd: geliştirilmiş SSD (ESSD)
    • local_ssd: yerel SSD

    Yanıt parametreleri

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


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


    Örnek kimlikleri.
    OrderId String 21077576248****


    Siparişin kimliği.

    Örnekler

    Örnek istekler

    http(s)://mongodb.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&ClientToken=ETnLKlblzczshOTUbOCz****
&ZoneId=cn-hangzhou-g
&Engine=MongoDB
&EngineVersion=4.4
&DBInstanceClass=dds.mongo.standard
&DBInstanceStorage=10
&DBInstanceDescription=test
&SecurityIPList=192.168.xx.xx,192.168.xx.xx
&AccountPassword=123456Aa
&ChargeType=PrePaid
&Period=1
&NetworkType=VPC
&VpcId=vpc-bp175iuvg8nxqraf2****
&VSwitchId=vsw-bp1gzt31twhlo0sa5****
&BusinessInfo={“ActivityId":"000000000"}
&AutoRenew=true
&CouponNo=youhuiquan_promotion_option_id_for_blank
&StorageEngine=WiredTiger
&ReplicationFactor=3
&ReadonlyReplicas=0
&StorageType=cloud_essd
&SecondaryZoneId=cn-hangzhou-h
&HiddenZoneId=cn-hangzhou-i
&Common request parameters

    Örnek başarılı yanıt

    XML biçimi

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

<CreateDBInstanceResponse>
    <RequestId>D8F1D721-6439-4257-A89C-F1E8E9C9****</RequestId>
    <DBInstanceId>dds-bp144a7f2db8****</DBInstanceId>
    <OrderId>21077576248****</OrderId>
</CreateDBInstanceResponse>

    JSON biçimi

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

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

    Hata kodları

    HTTP durum kodu Hata kodu Hata mesajı Açıklama
    400 InvalidDBInstanceDescription.Malformed Specified parameter DBInstanceDescription is not valid. Düğüm adı geçersiz olduğu için dönen hata mesajı.
    400 InsufficientBalance Your account does not have enough balance. Ödemeniz başarısız olduğu için dönen hata mesajı. Başka bir ödeme yöntemi ekleyin veya hesabınıza bakiye yükleyip tekrar deneyin.
    400 InvalidCapacity.NotFound The Capacity provided does not exist in our records. Belirtilen örnek depolama alanı geçersiz olduğu için dönen hata mesajı. Geçerli değer aralığında bir değer belirtin. Birim: MB.
    400 IdempotentParameterMismatch Request uses a client token in a previous request but is not identical to that request. Belirtilen ClientToken parametresi zaten kullanıldığı için dönen hata mesajı. Kullanılmamış bir değer belirtin. Değeri istemci aracılığıyla oluşturabilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.
    403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. Alibaba Cloud hesabınız için gerçek ad doğrulamasını tamamlamadığınız için dönen hata mesajı. Gerçek ad doğrulamasını tamamlayıp tekrar deneyin.
    403 IncorrectBackupSetState Current backup set state does not support operations. En son yedekleme seti hazır olmadığı için dönen hata mesajı. Daha sonra tekrar deneyin.

    Hata kodlarının listesi için API Error Center adresini ziyaret edin.