CreateDBInstance - - Alibaba Cloud Dokümantasyon Merkezi

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

Operation description

Bu işlemi kullanmadan önce, ApsaraDB for MongoDB faturalandırma yöntemlerini ve fiyatlandırmasını anladığınızdan emin olun.

Örnek teknik özellikleri hakkında bilgi için Örnek teknik özellikleri konusuna bakın.

Parçalanmış küme örneği oluşturmak için CreateShardingDBInstance 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:CreateDBInstance

create

*Örnek.

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

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. Not Çoğaltma kümesi örneğini kopyalamak veya geri dönüşüm kutusundan geri yüklemek için bu işlemi çağırıyorsanız, bu parametreyi kaynak örneğin değeriyle aynı olacak şekilde ayarlayın.	cn-hangzhou
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 olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve uzunluğu 64 karakteri aşamaz.	ETnLKlblzczshOTUbOCz****
ZoneId	string	No	Bölge kimliği. Bölge kimliğini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.	cn-hangzhou-g
EngineVersion	string	Yes	Veritabanı motoru sürümü. Geçerli değerler: 8.0 7.0 6.0 5.0 4.4 4.2 4.0 Not Çoğaltma kümesi örneğini kopyalamak veya geri dönüşüm kutusundan geri yüklemek için bu işlemi çağırıyorsanız, bu parametreyi kaynak örneğin değeriyle aynı olacak şekilde ayarlayın. Uyarı 3.4 ve önceki sürümler artık satın alınamaz.	4.4
DBInstanceClass	string	Yes	Örnek türü. Kullanılabilir örnek türlerini sorgulamak için DescribeAvailableResource işlemini çağırabilirsiniz.	dds.mongo.standard
DBInstanceStorage	integer	Yes	Örnek depolama kapasitesi. Birim: GB. Geçerli değerler örnek türüne bağlıdır. Ayrıntılar için Çoğaltma kümesi örneği teknik özellikleri konusuna bakın.	10
DBInstanceDescription	string	No	Örnek adı. Ad aşağıdaki gereksinimleri karşılamalıdır: Bir Çince karakter veya harfle başlamalıdır. Rakamlar, Çince karakterler, harfler, alt çizgiler (_), noktalar (.) ve tireler (-) içerebilir. Uzunluğu 2 ila 256 karakter arasında olmalıdır.	test
SecurityIPList	string	No	Örneğin IP beyaz listesi. Birden fazla IP adresını virgülle (,) ayırın. Yinelenen IP adreslarına izin verilmez. Aşağıdaki biçimler desteklenir: 0.0.0.0/0 IP adresı biçimi, örneğin 10.23.12.24. CIDR bloğu biçimi, örneğin 10.23.12.0/24. Bu örnekte 24, CIDR bloğunun ön ekinin 24 bit uzunluğunda olduğunu gösterir. Ön ek uzunluğu 1 ila 32 arasında değişir. Not Her örnek, tüm IP beyaz listesi grupları genelinde en fazla 1.000 IP adresini veya CIDR bloğunu destekler. 0.0.0.0/0, tüm IP adreslarının örnek veritabanına erişmesine izin verir. Bu yüksek riskli bir ayardır. Dikkatli ilerleyin.	192.168.xx.xx,192.168.xx.xx
AccountPassword	string	No	Kök hesabın parolası. Parola aşağıdaki gereksinimleri karşılamalıdır: Ş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: !@#$%^&()_+-=. Uzunluğu 8 ila 32 karakter arasında olmalıdır. Not* Paroladaki özel karakterlerin neden olduğu veritabanı bağlantı hatalarını giderme hakkında bilgi için Bağlantı dizesindeki özel karakterlerin neden olduğu veritabanı bağlantı hatalarını nasıl gideririm? konusuna bakın.	123456Aa
Period	integer	No	Örneğin abonelik süresi. Birim: ay. Geçerli değerler: 1 ile 9 arası (tam sayılar), 12, 24, 36 ve 60. Not Bu parametre, ChargeType değeri PrePaid olarak ayarlandığında kullanılabilir ve gereklidir.	1
ChargeType	string	No	Örneğin faturalandırma yöntemi. Geçerli değerler: PostPaid: varsayılan değer. Kullandıkça öde. 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
NetworkType	string	No	Örneğin ağ türü. Geçerli değerler: VPC: Sanal Özel Bulut. Valid values: VPC : Sanal Özel Bulut.	VPC
VpcId	string	No	VPC kimliği.	vpc-bp175iuvg8nxqraf2****
VSwitchId	string	No	vSwitch kimliği.	vsw-bp1gzt31twhlo0sa5****
SrcDBInstanceId	string	No	Kaynak örnek kimliği. Not Çoğaltma kümesi örneğini kopyalamak için bu işlemi çağırıyorsanız, bu parametreyi BackupId veya RestoreTime parametresiyle birlikte yapılandırmanız gerekir. Çoğaltma kümesi örneğini geri dönüşüm kutusundan geri yüklemek için bu işlemi çağırıyorsanız, yalnızca bu parametreyi yapılandırmanız yeterlidir. BackupId ve RestoreTime parametreleri gerekli değildir.	dds-bp1ee12ad351****
BackupId	string	No	Yedekleme kimliği. Yedekleme kimliğini sorgulamak için DescribeBackups işlemini çağırabilirsiniz. Not Bu parametre yalnızca bir yedekleme noktasından çoğaltma kümesi örneği kopyalamak için bu işlemi çağırdığınızda gereklidir. Ayrıca SrcDBInstanceId parametresini de yapılandırmanız gerekir.	32994****
RestoreTime	string	No	Örneğin geri yükleneceği zaman noktası. Son 7 gün içindeki herhangi bir zaman noktasını belirtebilirsiniz. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Zaman UTC olmalıdır. Not Bu parametre yalnızca bir zaman noktasına çoğaltma kümesi örneği kopyalamak için bu işlemi çağırdığınızda gereklidir. Ayrıca SrcDBInstanceId parametresini de yapılandırmanız gerekir.	2022-03-13T12:11:14Z
BusinessInfo	string	No	İşletme hakkındaki ek bilgiler.	{“ActivityId":"000000000"}
AutoRenew	string	No	Örnek için otomatik yenilemenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: true: Otomatik yenilemeyi etkinleştirir. false: Varsayılan değer. Otomatik yenilemeyi devre dışı bırakır. Örneği manuel olarak yenilemeniz gerekir. Not Bu parametre, ChargeType değeri PrePaid olarak ayarlandığında kullanılabilir ve isteğe bağlıdır.	true
DatabaseNames	string	No	Veritabanının adı. Not Çoğaltma kümesi örneği kopyalamak için bu işlemi çağırdığınızda, belirli veritabanlarını kopyalamak için bu parametreyi belirtebilirsiniz. Bu parametreyi belirtmezseniz, tüm veritabanları kopyalanır.	mongodbtest
CouponNo	string	No	Kupon kullanılıp kullanılmayacağını belirtir. Geçerli değerler: default veya null (varsayılan): Kupon kullanır. youhuiquan_promotion_option_id_for_blank: Kupon kullanmaz.	default
StorageEngine	string	No	Örneğin depolama motoru. Değer WiredTiger olarak sabitlenmiştir. Not Çoğaltma kümesi örneğini kopyalamak veya geri dönüşüm kutusundan geri yüklemek için bu işlemi çağırıyorsanız, bu parametreyi kaynak örneğin değeriyle aynı olacak şekilde ayarlayın. Depolama motorları ve sürümleri üzerindeki kısıtlamalar hakkında bilgi için Sürümler ve depolama motorları konusuna bakın. Valid values: WiredTiger : WiredTiger depolama motoru.	WiredTiger
ReplicationFactor	string	No	Çoğaltma kümesi örneğindeki birincil ve ikincil düğüm sayısı. Geçerli değerler: 3 (varsayılan) 5 7 Önemli Bu parametre tek düğümlü örnekler için gerekli değildir.	3
ReadonlyReplicas	string	No	Çoğaltma kümesi örneğindeki salt okunur düğüm sayısı. Geçerli değerler: 0 ile 5 arası (tam sayılar). Varsayılan değer: 0.	0
Engine	string	No	Kaynak grubu kimliği. Valid values: MongoDB : MongoDB veritabanı motoru.	rg-acfmyiu4ekp****
StorageType	string	No	Ayrılmış küme kimliği.	dhg-2x78****
SecondaryZoneId	string	No	Veritabanı motoru. Değer MongoDB olarak sabitlenmiştir.	MongoDB
HiddenZoneId	string	No	Depolama türü. Geçerli değerler: cloud_essd1: PL1 ESSD. cloud_essd2: PL2 ESSD. cloud_essd3: PL3 ESSD. cloud_auto: ESSD AutoPL disk. local_ssd: Yerel SSD. Not Tek düğümlü örnekler için cloud_essd1 belirtirseniz, örnek bir cloud_essd diski kullanır. ESSD AutoPL diskleri şu anda yalnızca Çin sitesinde kullanılabilir. 4.4 veya sonraki sürümleri çalıştıran örnekler için varsayılan değer cloud_essd1'dir. 4.2 veya önceki sürümleri çalıştıran örnekler için varsayılan değer local_ssd'dir.	cloud_essd1
Tag	array<object>	No	Çok bölgeli dağıtımı uygulamak için ikincil düğümün dağıtıldığı bölge. 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, örnek bulut diskleri kullandığında kullanılabilir. Bu parametrenin değeri, ZoneId ve HiddenZoneId değerleriyle aynı olamaz.	cn-hangzhou-h
	object	No
Key	string	No	Etiketin anahtarı. Not N, etiketin numarasını belirtir. Örneğin, Tag.1.Key ilk etiketin anahtarını, Tag.2.Key ise ikinci etiketin anahtarını belirtir.	testdatabase
Value	string	No	Etiketin değeri. Not N, etiketin numarasını belirtir. Örneğin, Tag.1.Value ilk etiketin değerini, Tag.2.Value ise ikinci etiketin değerini belirtir.	apitest
GlobalSecurityGroupIds	string	No	Çok bölgeli dağıtımı uygulamak için gizli düğümün dağıtıldığı bölge. 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, örnek bulut diskleri kullandığında kullanılabilir. Bu parametrenin değeri, ZoneId ve SecondaryZoneId değerleriyle aynı olamaz.	cn-hangzhou-i
Encrypted	boolean	No	Kullanıcı tanımlı etiketler.	true
EncryptionKey	string	No	Örnek için global IP beyaz listesi şablonları. Birden fazla şablonu virgülle (,) ayırın. Yinelenen şablonlara izin verilmez. (Bu özellik kanarya sürümündedir.)	g-qxieqf40xjst1ngpr3jz
ProvisionedIops	integer	No	Bulut diski şifrelemesinin etkinleştirilip etkinleştirilmeyeceğini belirtir.	true
RestoreType	string	No	Özel anahtar kimliği.	2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
SrcRegion	string	No	Sağlanan performans (IOPS). Geçerli değerler: 0 ile 50000 arası.	1960

Response elements

Element	Type	Description	Example
	object
RequestId	string	İstek kimliği.	D8F1D721-6439-4257-A89C-F1E8E9C9****
DBInstanceId	string	Örnek kimliği.	dds-bp144a7f2db8****
OrderId	string	Sipariş kimliği.	21077576248****

Examples

Success response

JSON format

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

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	MissingParameter	Period is mandatory for this action.
400	ORDER.ACCOUNT_INFORMATION_INCOMPLETE	Your information is incomplete. Complete your information before ordering.
400	InvalidClientToken.Malformed	Specified parameter ClientToken is not valid.
400	InvalidDBInstanceDescription.Malformed	Specified parameter DBInstanceDescription is not valid.	Düğüm adı geçersiz.
400	InvalidSecurityIPListLength.Malformed	The quota of security ip exceeds.
400	InsufficientBalance	Your account does not have enough balance.
400	QuotaExceed.AfterpayInstance	Living afterpay instances quota exceeded.
400	InvalidCapacity.NotFound	The Capacity provided does not exist in our records.
400	ResourceNotAvailable	Resource you requested is not available for finance user.
400	IdempotentParameterMismatch	Request uses a client token in a previous request but is not identical to that request.
400	InvalidSecurityIPList.Malformed	The specified parameter "SecurityIPList" is not valid.
400	InvalidSecurityIPList.Duplicate	The Security IP address is not in the available range or occupied.
400	InvalidDBInstanceStorage.ValueNotSupported	The specified parameter DBInstanceStorage is not valid.
400	InvalidAccountPassword.Malformed	Specified parameter AccountPassword is not valid.
400	TokenServiceError	Duplicate ClientToken request.
400	Zone.Closed	The specified zone is closed.
400	PRICE.ORIGIN_PRICE_ERROR	The origin price error.
400	NO_AVAILABLE_PAYMENT_METHOD	No payment method is specified for your account. We recommend that you add a payment method.
400	InvalidEcsImage.NotFound	Specified ecs image does not exist.
400	SaleValidateNoSpecificCodeFailed	Specified Storage or Version or InstanceClass is invalid.	Storage, Version veya InstanceClass parametresi boştur.
400	Trade_Not_Support_Async_Pay	Trade not support async pay.
400	InvalidZoneld	The specified primary zone, secondary zone and hidden zone cannot be the same.	Birincil bölge, ikincil bölge 1 ve ikincil bölge 2 parametrelerinin hepsi aynı olamaz.
400	SameZoneId	The specified primary zone, secondary zone require two different zones.	Belirtilen birincil bölge ve ikincil bölge parametreleri farklı olmalıdır.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.
403	RegionUnauthorized	There is no authority to create instance in the specified region.
403	OperationDenied	The resource is out of usage.	Kaynak kullanım dışıdır.
403	InvalidEngineVersionInRegion.NotAvailable	The EngineVersion in the Region is not available.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.
403	IncorrectBackupSetState	Current backup set state does not support operations.
404	InvalidBackup.NotFound	The available backup does not exist in recovery time.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.