Tüm Ürünler
Search

Bu Ürün

    :CreateShardingDBInstance

    Belge Merkezi

    :CreateShardingDBInstance

    Son Güncelleme:Sep 30, 2026

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

    Operation description

    • Bu işlemi çağırmadan önce, ApsaraDB for MongoDB faturalandırma yöntemlerini ve fiyatlandırmasını tam olarak anladığınızdan emin olun.

    • ApsaraDB for MongoDB örnek teknik özellikleri hakkında daha fazla bilgi için Örnek teknik özellikleri bölümüne bakın.

    • Bağımsız veya çoğaltma kümesi örneği oluşturmak için CreateDBInstance işlemini çağırın.

    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

    dds:CreateShardingDBInstance

    create

    *Instance

    acs:dds:{#regionId}:{#accountId}:dbinstance/*

    		 None None

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    Bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    cn-hangzhou
    ZoneId

    string

    No

    Kullanılabilirlik bölgesi kimliği. Kullanılabilirlik bölgesi kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

    cn-hangzhou-g
    Engine

    string

    Yes

    Veritabanı motoru. Değeri MongoDB olarak ayarlayın.

    Valid values:

    • MongoDB :

      MongoDB veritabanı motoru.

    MongoDB
    EngineVersion

    string

    Yes

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

    • 8.0

    • 7.0

    • 6.0

    • 5.0

    • 4.4

    • 4.2

    • 4.0

    Not

    • Depolama motorları ve sürümleri üzerindeki kısıtlamalar hakkında daha fazla bilgi için Veritabanı motoru sürümleri ve depolama motorları bölümüne bakın.

    • Bu işlemi örneği kopyalamak için çağırdığınızda, bu parametreyi kaynak örnekle aynı değere ayarlayın.

    4.4
    DBInstanceDescription

    string

    No

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

    • Ad bir harfle başlamalıdır.

    • Ad rakamlar, harfler, alt çizgiler (_), noktalar (.) ve tireler (-) içerebilir.

    • Ad 2 ila 256 karakter uzunluğunda olmalıdır.

    test
    SecurityIPList

    string

    No

    Örneğin IP adresi beyaz listesi. Birden fazla IP adresini virgülle (,) ayırın. IP adresleri yinelenemez. Aşağıdaki üç biçim desteklenir:

    • 0.0.0.0/0

    • IP adresi, örneğin 10.23.12.24.

    • CIDR bloğu, örneğin 10.23.12.0/24; burada 24, IP adresindeki ön ekin uzunluğunu belirtir ve değer 1 ile 32 arasında değişir.

    Not

    • Bir örneğin tüm IP adresi beyaz listesi gruplarına en fazla 1.000 IP adresi veya CIDR bloğu ekleyebilirsiniz.

    • Bu parametreyi 0.0.0.0/0 olarak ayarlarsanız, tüm IP adresleri örneğe erişebilir. Bu ayarı kullanırken dikkatli olun.

    192.168.xx.xx,192.168.xx.xx
    AccountPassword

    string

    No

    Kök hesabın parolası. Geçerli değerler:

    • Parola şu karakter türlerinden en az üçünü içermelidir: büyük harfler, küçük harfler, rakamlar ve özel karakterler.

    • Özel karakterler şunları içerir: !@#$%^&*()_+-=

    • Parola 8 ila 32 karakter uzunluğunda olmalıdır.

    Not

    Bağlantı dizesindeki özel karakterlerin neden olduğu veritabanı bağlantı hatalarını giderme hakkında daha fazla bilgi için Bağlantı dizesi hesap parolasındaki özel karakterlerin neden olduğu bağlantı hatalarını nasıl gideririm? bölümüne bakın.

    123456Aa
    ChargeType

    string

    No

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

    • PostPaid: Kullandıkça öde. Bu varsayılan değerdir.

    • PrePaid: Abonelik.

    Not

    Bu parametreyi PrePaid olarak ayarlarsanız, Period parametresini de yapılandırmanız gerekir.

    Valid values:

    • PostPaid :

      Kullandıkça öde.

    • PrePaid :

      Abonelik.

    PrePaid
    Period

    integer

    No

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

    Geçerli değerler: 1 ile 9 arası (tam sayı), 12, 24, 36 ve 60.

    Not

    Bu parametre yalnızca ChargeType değerini PrePaid olarak ayarladığınızda kullanılabilir ve gereklidir.

    1
    NetworkType

    string

    No

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

    VPC: Sanal özel bulut (VPC).

    VPC
    VpcId

    string

    No

    VPC kimliği.

    vpc-bp1n3i15v90el48nx****
    VSwitchId

    string

    No

    vSwitch kimliği.

    vsw-bp1vj604nj5a9zz74****
    SrcDBInstanceId

    string

    No

    Kaynak örneğin örnek kimliği.

    Not

    Bu parametre yalnızca bu işlemi örneği kopyalamak için çağırdığınızda gereklidir. Ayrıca RestoreTime parametresini de yapılandırmanız gerekir.

    dds-bp11483712c1****
    RestoreTime

    string

    No

    Verileri kurtarmak istediğiniz zaman noktası. Son yedi gün içindeki herhangi bir zaman noktasını belirtebilirsiniz. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde (UTC) belirtin.

    Not

    Bu parametre yalnızca bu işlemi örneği kopyalamak için çağırdığınızda gereklidir. Ayrıca SrcDBInstanceId parametresini de yapılandırmanız gerekir.

    2022-03-08T02:30:25Z
    ClientToken

    string

    No

    İsteğin idempotent olmasını sağlamak için kullanılan istemci belirteci. Belirteci oluşturmak için istemciyi kullanabilirsiniz, ancak belirtecin farklı istekler arasında benzersiz olduğundan emin olun. Belirteç yalnızca ASCII karakterler içerebilir ve uzunluğu 64 karakteri aşamaz.

    ETnLKlblzczshOTUbOCz****
    StorageEngine

    string

    No

    Örneğin depolama motoru. Değeri WiredTiger olarak ayarlayın.

    Not

    • Bu işlemi örneği kopyalamak için çağırdığınızda, bu parametreyi kaynak örnekle aynı değere ayarlayın.

    • Depolama motorları ve sürümleri üzerindeki kısıtlamalar hakkında daha fazla bilgi için Veritabanı motoru sürümleri ve depolama motorları bölümüne bakın.

    WiredTiger
    AutoRenew

    string

    No

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

    • true: Otomatik yenilemeyi etkinleştirir.

    • false: Otomatik yenilemeyi devre dışı bırakır. Örneği manuel olarak yenilemeniz gerekir. Bu varsayılan değerdir.

    Not

    Bu parametre yalnızca ChargeType değerini PrePaid olarak ayarladığınızda kullanılabilir ve isteğe bağlıdır.

    true
    ProtocolType

    string

    No

    Erişim protokolünün türü. Geçerli değerler:

    • mongodb: MongoDB protokolü.

    • dynamodb: DynamoDB protokolü.

    Valid values:

    • mongodb :

      MongoDB protokolü.

    • dynamodb :

      DynamoDB protokolü.

    mongodb
    Mongos

    array<object>

    Yes

    Mongos düğümleri hakkındaki bilgiler.

    object

    Yes

    Mongos düğümleri hakkındaki bilgiler.

    Class

    string

    Yes

    Mongos düğümünün teknik özellikleri. Daha fazla bilgi için Parçalı küme örnek teknik özellikleri bölümüne bakın.

    Not

    • Parametre adındaki N, Mongos düğümünün sıra numarasını belirtir. Örneğin, Mongos.2.Class ikinci Mongos düğümünün teknik özelliklerini belirtir.

    • N için geçerli değerler: 2 ile 32 arası.

    mdb.shard.2x.xlarge.d
    ReplicaSet

    array<object>

    Yes

    Shard düğümleri hakkındaki bilgiler.

    object

    No

    Shard düğümleri hakkındaki bilgiler.

    Class

    string

    Yes

    Shard düğümünün teknik özellikleri. Daha fazla bilgi için Parçalı küme örnek teknik özellikleri bölümüne bakın.

    Not

    • Parametre adındaki N, Shard düğümünün sıra numarasını belirtir. Örneğin, ReplicaSet.2.Class ikinci Shard düğümünün teknik özelliklerini belirtir.

    • N için geçerli değerler: 2 ile 32 arası.

    dds.shard.standard
    Storage

    integer

    Yes

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

    Not

    • Geçerli değerler örnek teknik özelliklerine tabidir. Daha fazla bilgi için Parçalı küme örnek teknik özellikleri bölümüne bakın.

    • Parametre adındaki N, Shard düğümünün sıra numarasını belirtir. Örneğin, ReplicaSet.2.Storage ikinci Shard düğümünün depolama kapasitesini belirtir.

    10
    ReadonlyReplicas

    integer

    No

    Shard düğümü için salt okunur düğüm sayısı.

    Geçerli değerler: 0 ile 5 arası (tam sayı). Varsayılan değer: 0.

    Not

    Parametre adındaki N, Shard düğümünün sıra numarasını belirtir. Örneğin, ReplicaSet.2.ReadonlyReplicas ikinci Shard düğümü için salt okunur düğüm sayısını belirtir.

    0
    ConfigServer

    array<object>

    Yes

    ConfigServer düğümleri hakkındaki bilgiler.

    object

    No

    ConfigServer düğümleri hakkındaki bilgiler.

    Class

    string

    Yes

    ConfigServer düğümünün teknik özellikleri. Geçerli değerler:

    • mdb.shard.2x.xlarge.d: 4 vCPU, 8 GB bellek (özel). Bu değer yalnızca 4.4 veya sonraki sürümleri çalıştıran örnekler için desteklenir.

    • dds.cs.mid: 1 vCPU, 2 GB bellek (genel amaçlı). Bu değer yalnızca 4.2 veya önceki sürümleri çalıştıran örnekler için desteklenir.

    mdb.shard.2x.xlarge.d
    Storage

    integer

    Yes

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

    Not

    Geçerli değerler örnek teknik özelliklerine tabidir. Daha fazla bilgi için Parçalı küme örnek teknik özellikleri bölümüne bakın.

    20
    SecondaryZoneId

    string

    No

    Kaynak grubu kimliği. Daha fazla bilgi için Kaynak grubunun temel bilgilerini görüntüleme bölümüne bakın.

    rg-acfmyiu4ekp****
    HiddenZoneId

    string

    No

    Çoklu bölge dağıtımı için ikincil bölge 1. Geçerli değerler:

    • cn-hangzhou-g: Hangzhou Bölge G.

    • cn-hangzhou-h: Hangzhou Bölge H.

    • cn-hangzhou-i: Hangzhou Bölge I.

    • cn-hongkong-b: Hong Kong (Çin) Bölge B.

    • cn-hongkong-c: Hong Kong (Çin) Bölge C.

    • cn-hongkong-d: Hong Kong (Çin) Bölge D.

    • cn-wulanchabu-a: Ulanqab Bölge A.

    • cn-wulanchabu-b: Ulanqab Bölge B.

    • cn-wulanchabu-c: Ulanqab Bölge C.

    • ap-southeast-1a: Singapur Bölge A.

    • ap-southeast-1b: Singapur Bölge B.

    • ap-southeast-1c: Singapur Bölge C.

    • ap-southeast-5a: Cakarta Bölge A.

    • ap-southeast-5b: Cakarta Bölge B.

    • ap-southeast-5c: Cakarta Bölge C.

    • eu-central-1a: Frankfurt Bölge A.

    • eu-central-1b: Frankfurt Bölge B.

    • eu-central-1c: Frankfurt Bölge C.

    Not

    • Bu parametre yalnızca örnek bulut diskleri kullandığında kullanılabilir.

    • Bu parametrenin değeri ZoneId veya HiddenZoneId değerleriyle aynı olamaz.

    • Parçalı küme örnekleri için çoklu bölge dağıtım stratejisi hakkında daha fazla bilgi için Çoklu bölgeli parçalı küme örneği oluşturma bölümüne bakın.

    cn-hangzhou-h
    StorageType

    string

    No

    Çoklu bölge dağıtımı için ikincil bölge 2. Geçerli değerler:

    • cn-hangzhou-g: Hangzhou Bölge G.

    • cn-hangzhou-h: Hangzhou Bölge H.

    • cn-hangzhou-i: Hangzhou Bölge I.

    • cn-hongkong-b: Hong Kong (Çin) Bölge B.

    • cn-hongkong-c: Hong Kong (Çin) Bölge C.

    • cn-hongkong-d: Hong Kong (Çin) Bölge D.

    • cn-wulanchabu-a: Ulanqab Bölge A.

    • cn-wulanchabu-b: Ulanqab Bölge B.

    • cn-wulanchabu-c: Ulanqab Bölge C.

    • ap-southeast-1a: Singapur Bölge A.

    • ap-southeast-1b: Singapur Bölge B.

    • ap-southeast-1c: Singapur Bölge C.

    • ap-southeast-5a: Cakarta Bölge A.

    • ap-southeast-5b: Cakarta Bölge B.

    • ap-southeast-5c: Cakarta Bölge C.

    • eu-central-1a: Frankfurt Bölge A.

    • eu-central-1b: Frankfurt Bölge B.

    • eu-central-1c: Frankfurt Bölge C.

    Not

    • Bu parametre yalnızca örnek bulut diskleri kullandığında kullanılabilir.

    • Bu parametrenin değeri ZoneId veya SecondaryZoneId değerleriyle aynı olamaz.

    • Parçalı küme örnekleri için çoklu bölge dağıtım stratejisi hakkında daha fazla bilgi için Çoklu bölgeli parçalı küme örneği oluşturma bölümüne bakın.

    cn-hangzhou-i
    GlobalSecurityGroupIds

    string

    No

    Depolama türü. Geçerli değerler:

    • cloud_essd1: PL1 ESSD.

    • cloud_essd2: PL2 ESSD.

    • cloud_essd3: PL3 ESSD.

    • local_ssd: Yerel SSD.

    Not

    • 4.4 veya sonraki sürümleri çalıştıran örnekler yalnızca bulut disklerini destekler. Bu parametreyi belirtmezseniz, varsayılan olarak cloud_essd1 kullanılır.

    • 4.2 veya önceki sürümleri çalıştıran örnekler yalnızca yerel diskleri destekler. Bu parametreyi belirtmezseniz, varsayılan olarak local_ssd kullanılır.

    cloud_essd1
    Tag

    array<object>

    No

    Örneğin global IP adresi beyaz listesi şablonları. Birden fazla şablonu virgülle (,) ayırın. Şablonlar yinelenemez.

    g-qxieqf40xjst1ngpr3jz

    object

    No

    The custom tags added to the instance.

    Key

    string

    No

    The key of the tag.

    Not

    • N specifies the serial number of the tag. For example, Tag.1.Key specifies the key of the first tag, and Tag.2.Key specifies the key of the second tag.

    testdatabase
    Value

    string

    No

    The value of the tag.

    Not

    N specifies the serial number of the tag. For example, Tag.1.Value specifies the value of the first tag, and Tag.2.Value specifies the value of the second tag.

    apitest
    Encrypted

    boolean

    No

    Özel etiketler.

    true
    EncryptionKey

    string

    No

    Bulut diski şifrelemesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

    true
    ProvisionedIops

    integer

    No

    Özel şifreleme anahtarı kimliği.

    2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    SrcRegion

    string

    No

    Sağlanan IOPS.

    1960
    BackupId

    string

    No

    Kaynak örneğin bulunduğu bölge.

    Not

    • Yedek kurtarma türü silinmiş bir örneği yeniden oluşturma olduğunda bu parametre gereklidir.

    • Yedek kurtarma türü coğrafi yedeklilik yedeğinden kopyalama olduğunda bu parametre gereklidir.

    cn-beijing
    RestoreType

    string

    No

    Küme yedeği kimliği.

    Not

    Bu parametre yalnızca RestoreType 2 veya 3 olarak ayarlandığında gereklidir.

    cb-xxx
    DestRegion

    string

    No

    Yedek kurtarma türü. Geçerli değerler:

    • 1: Örneği belirtilen bir zaman noktasına kurtarır.

    • 2: Serbest bırakılmış bir örneği belirtilen bir yedek kümesinden kurtarır.

    • 3: Örneği belirtilen bir coğrafi yedeklilik yedek kümesinden kurtarır.

    1

    Response elements

    Element

    Type

    Description

    Example

    object

    Yanıt parametreleri.

    RequestId

    string

    İstek kimliği.

    D8F1D721-6439-4257-A89C-F1E8E9C9****
    DBInstanceId

    string

    Örnek kimliği.

    dds-bp114f14849d****
    OrderId

    string

    Sipariş kimliği.

    21010996721****

    Examples

    Success response

    JSON format

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

    Error codes

    HTTP status code

    Error code

    Error message

    Description
    400 SecurityRisk.AuthVerification we have detected a risk with your default payment method. An email and notification has been sent to you. Please re-submit your order before after verificaiton.
    400 InvaliadParameter.ShardsCount.LessThanSrc The specified number of shards is less than that of source instance.
    400 ORDER.ACCOUNT_INFORMATION_INCOMPLETE Your information is incomplete. Complete your information before ordering.
    400 InvalidRegion.Format Specified Region is not valid.
    400 Zone.Closed The specified zone is closed.
    400 TokenServiceError The request token is duplicated.
    400 InvalidParam Param not valid.
    400 InvalidEngineVersion.Malformed Specified engine version is not valid.
    400 InvalidParameters.Format Specified parameters is not valid.
    400 RestoreTypeNotSupported The specified restoreType is not supported for the instance, check the input parameters 'RestoreType/BackupID/RestoreTime'.
    500 VpcServiceError Invoke vpc service error.
    403 InvalidBackupLogStatus Current backup log enable status does not support this operation.
    403 ReduceDiskNotSupport Reduce disk size is not supported in clone/restore.

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.