Tüm Ürünler
Search
Belge Merkezi

:Örnek oluşturma

Son Güncelleme:Oct 02, 2026

Bir RDS örneği oluşturmak için CreateDBInstance işlemini çağırabilirsiniz.

Bu işlemi çağırmadan önce ApsaraDB RDS'nin faturalandırma yöntemlerini ve fiyatlandırmasını anladığınızdan emin olun. Daha fazla bilgi için bkz. Faturalandırılabilir öğeler, faturalandırma yöntemleri ve fiyatlandırma.

ApsaraDB RDS örnek türleri hakkında daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.

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'lar için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet CreateDBInstance

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

RegionId String Evet cn-hangzhou

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

Engine String Evet MySQL

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

  • MySQL
  • SQLServer
  • PostgreSQL
  • MariaDB
Not Sunucusuz bir örnek oluşturmak için bu parametreyi MySQL olarak ayarlamanız gerekir.
EngineVersion String Evet 5.6

Örneğin veritabanı altyapısı sürümü.

  • Engine parametresini MySQL olarak ayarladığınızda geçerli değerler: 5.5, 5.6, 5.7 ve 8.0
  • Engine parametresini SQLServer olarak ayarladığınızda geçerli değerler: 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha ve 2019_ent
  • Engine parametresini PostgreSQL olarak ayarladığınızda geçerli değerler: 10.0, 11.0, 12.0, 13.0, 14.0 ve 15.0
  • Engine parametresini MariaDB olarak ayarladığınızda geçerli değerler: 10.3
Not Sunucusuz bir örnek oluşturmak için bu parametreyi 8.0 olarak ayarlamanız gerekir.
DBInstanceClass String Evet rds.mysql.s1.small

Örneğin örnek türü. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Bir bölgede kullanılabilen örnek türlerini sorgulamak için DescribeAvailableResource işlemini de çağırabilirsiniz.

Not Sunucusuz bir örnek oluşturmak için bu parametreyi mysql.n2.serverless.1c olarak ayarlamanız gerekir.
DBInstanceStorage Integer Evet 100

Örneğin depolama kapasitesi. Birim: GB. Depolama kapasitesini 5 GB'lık adımlarla artırabilirsiniz. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Bir bölgede belirtilen bir örnek türü için desteklenen depolama kapasitesi aralığını sorgulamak için DescribeAvailableResource işlemini de çağırabilirsiniz.

SystemDBCharset String Hayır gbk

Örnek tarafından kullanılan karakter kümesi. Bu parametre kullanımdan kaldırılmıştır.

DBInstanceNetType String Evet Internet

Örneğe ağ bağlantısı türü. Geçerli değerler:

  • Internet: İnternet
  • Intranet: Dahili ağ
DBInstanceDescription String Hayır testdatabase

Örneğin adı. Ad 2 ila 255 karakter uzunluğunda olmalı ve harf, rakam, alt çizgi (_) ve kısa çizgi (-) içerebilir. Ad bir harfle başlamalıdır.

Not Ad http:// veya https:// ile başlayamaz.
SecurityIPList String Evet 10.10.XX.XX/24

Örneğin IP adresi izin listesi. Daha fazla bilgi için bkz. Bir veritabanı istemcisini veya CLI'yı kullanarak bir ApsaraDB RDS for MySQL örneğine bağlanma. IP adresi izin listesi birden fazla giriş içeriyorsa girişleri virgülle (,) ayırın. Her giriş benzersiz olmalıdır. IP adresi izin listesi en fazla 1.000 giriş içerebilir. IP adresi izin listesindeki girişler aşağıdaki biçimlerden birinde olmalıdır:

  • IP adresleri, örneğin 10.10.XX.XX.
  • CIDR blokları, örneğin 10.10.XX.XX/24. Bu örnekte 24, IP adresi izin listesindeki her IP adresinin ön ekinin 24 bit uzunluğunda olduğunu gösterir. 24 yerine 1 ila 32 aralığında bir değer kullanabilirsiniz.
ClientToken String Hayır ETnLKlblzczshOTUbOCz*****

İsteğin yinelenebilirliğini sağlamak için kullanılan istemci belirteci. Değeri istemci üzerinden oluşturabilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir ve 64 karakteri aşamaz.

PayType String Evet Postpaid

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

  • Postpaid: Kullandıkça öde.
  • Prepaid: Abonelik.
  • Serverless: Sunucusuz. Bu değer yalnızca MySQL çalıştıran örnekler için desteklenir. Daha fazla bilgi için bkz. Genel Bakış.
Not Sistem otomatik olarak bir satın alma siparişi oluşturur ve ödemeyi tamamlar.
ZoneId String Hayır cn-hangzhou-b

Birincil örneğin alan kimliği.

Not
  • Bir sanal özel cloud (VPC) ve vSwitch belirtirseniz bu parametreyi belirtilen vSwitch'in ait olduğu alanın kimliğine ayarlamanız gerekir. Aksi takdirde örnek oluşturulamaz.
  • Örnek RDS Yüksek Kullanılabilirlik Sürümü çalıştırıyorsa tek alanlı dağıtım yöntemini mi yoksa çok alanlı dağıtım yöntemini mi kullanacağınızı belirten ZoneIdSlave1 parametresini belirtmeniz gerekir.
  • Örnek RDS Kurumsal Sürüm çalıştırıyorsa tek alanlı dağıtım yöntemini mi yoksa çok alanlı dağıtım yöntemini mi kullanacağınızı belirten ZoneIdSlave1 ve ZoneIdSlave2 parametrelerini belirtmeniz gerekir.

ZoneIdSlave1 String Hayır cn-hangzhou-c

İkincil örneğin alan kimliği. ZoneIdSlave1 parametresini ZoneId parametresiyle aynı değere ayarlarsanız tek alanlı dağıtım yöntemi kullanılır. ZoneIdSlave1 parametresini ZoneId parametresinden farklı bir değere ayarlarsanız çok alanlı dağıtım yöntemi kullanılır.

ZoneIdSlave2 String Hayır cn-hangzhou-d

Günlükleyici örneğinin alan kimliği. ZoneIdSlave2 parametresini ZoneId parametresiyle aynı değere ayarlarsanız tek alanlı dağıtım yöntemi kullanılır. ZoneIdSlave2 parametresini ZoneId parametresinden farklı bir değere ayarlarsanız çok alanlı dağıtım yöntemi kullanılır.

InstanceNetworkType String Hayır Classic

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

  • VPC.
  • Classic: Klasik ağ. Bu varsayılan değerdir.
Not
  • Örnek MySQL çalıştırıyor ve standart SSD'ler veya geliştirilmiş SSD'ler (ESSD) kullanıyorsa bu parametreyi VPC olarak ayarlamanız gerekir.
  • Örnek PostgreSQL veya MariaDB çalıştırıyorsa bu parametreyi VPC olarak ayarlamanız gerekir.
  • Örnek SQL Server Basic veya SQL Server Web çalıştırıyorsa bu parametreyi VPC veya Classic olarak ayarlayabilirsiniz. Örnek diğer veritabanı altyapılarını çalıştırıyorsa bu parametreyi VPC olarak ayarlamanız gerekir.
ConnectionMode String Hayır Standard

Örneğin bağlantı modu. Geçerli değerler:

  • Standard: Standart mod
  • Safe: Veritabanı proxy modu

Sistem örneğe otomatik olarak bir bağlantı modu atar.

Not SQL Server 2012, SQL Server 2016 ve SQL Server 2017 yalnızca standart modu destekler.
VPCId String Hayır vpc-*****

VPC kimliği.

Not InstanceNetworkType parametresini VPC olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
VSwitchId String Hayır vsw-*****

vSwitch kimliği. vSwitch, ZoneId parametresi tarafından belirtilen alana ait olmalıdır.

Not
  • InstanceNetworkType parametresini VPC olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
  • ZoneSlaveId1 parametresini belirtirseniz bu parametre için iki vSwitch kimliği belirtmeniz ve kimlikleri virgülle (,) ayırmanız gerekir.
PrivateIpAddress String Hayır 172.16.XX.XX

Örneğin özel IP adresi. Özel IP adresi, belirtilen vSwitch tarafından desteklenen CIDR bloğu içinde olmalıdır. ApsaraDB RDS, VPCId ve vSwitchId parametrelerinin değerlerine göre örneğe otomatik olarak bir özel IP adresi atar.

UsedTime String Hayır 2

Örneğin abonelik süresi. Geçerli değerler:

  • Period parametresini Year olarak ayarlarsanız UsedTime parametresinin değeri 1 ila 5 arasında olur.
  • Period parametresini Month olarak ayarlarsanız UsedTime parametresinin değeri 1 ila 11 arasında olur.
Not PayType parametresini Prepaid olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
Period String Hayır Year

Abonelik süresinin birimi. Geçerli değerler:

  • Year
  • Month
Not PayType parametresini Prepaid olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
ResourceGroupId String Hayır rg-acfmy*****

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

DBInstanceStorageType String Evet cloud_essd

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

  • local_ssd: Yerel SSD. Bu önerilen depolama türüdür.
  • cloud_ssd: Standart SSD. Bu depolama türü önerilmez. Bazı Alibaba Cloud bölgelerinde standart SSD'ler artık satın alınamamaktadır.
  • cloud_essd: PL1 performans seviyesine sahip ESSD.
  • cloud_essd2: PL2 performans seviyesine sahip ESSD.
  • cloud_essd3: PL3 performans seviyesine sahip ESSD.
Not Bu parametrenin varsayılan değeri, DBInstanceClass parametresi tarafından belirtilen örnek türüne göre belirlenir.
  • Örnek türü yerel SSD depolama türünü belirtiyorsa bu parametrenin varsayılan değeri local_ssd olur.
  • Örnek türü standart SSD veya ESSD depolama türünü belirtiyorsa bu parametrenin varsayılan değeri cloud_essd olur.
BusinessInfo String Hayır 121436975448952

Örnek hakkındaki ek iş bilgileri.

EncryptionKey String Hayır 0d24*****-da7b-4786-b981-9a164dxxxxxx

Örneğin bulunduğu bölgede disk şifreleme için kullanılan anahtarın kimliği. EncryptionKey parametresini belirtirseniz disk şifreleme otomatik olarak etkinleştirilir. Bu durumda RoleARN parametresini de belirtmeniz gerekir. Disk şifreleme etkinleştirildikten sonra devre dışı bırakılamaz.

Anahtarın kimliğini Key Management Service (KMS) konsolundan alabilirsiniz. Ayrıca bir anahtar da oluşturabilirsiniz. Daha fazla bilgi için bkz. CMK oluşturma.

RoleARN String Hayır acs:ram::1406xxxxxx:role/aliyunrdsinstanceencryptiondefaultrole

RAM kullanıcılarının ApsaraDB RDS'yi KMS'ye bağlamak için kullanabileceği, Alibaba Cloud hesabınız tarafından sağlanan Alibaba Cloud Resource Name (ARN). ARN'yi sorgulamak için CheckCloudResourceAuthorized işlemini çağırabilirsiniz.

AutoRenew String Hayır true

Örnek için otomatik yenileme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametreyi yalnızca örnek abonelik faturalandırma yöntemini kullandığında belirtmeniz gerekir. Geçerli değerler:

  • true: Özelliği etkinleştirir.
  • false: Özelliği devre dışı bırakır.
Not
  • Period parametresini Month olarak ayarlarsanız otomatik yenileme döngüsü bir aydır.
  • Period parametresini Year olarak ayarlarsanız otomatik yenileme döngüsü bir yıldır.
Category String Hayır HighAvailability

Örneğin RDS sürümü. Geçerli değerler:

  • Basic: RDS Temel Sürüm
  • HighAvailability: RDS Yüksek Kullanılabilirlik Sürümü

  • AlwaysOn: SQL Server için RDS Küme Sürümü
  • Finance: RDS Kurumsal Sürüm
  • serverless_basic: RDS Sunucusuz Temel Sürüm
    Not Sunucusuz bir örnek oluşturmak için bu değeri kullanmanız gerekir.
DedicatedHostGroupId String Hayır dhg-4n*****

Örneğin ait olduğu özel kümenin kimliği.

Örneği özel bir kümede oluşturuyorsanız bu parametreyi belirtmeniz gerekir.

Not
TargetDedicatedHostIdForMaster String Hayır i-bp*****1

Özel kümedeki örneğin ait olduğu ana bilgisayarın kimliği.

Örneği özel bir kümede oluşturuyorsanız bu parametreyi belirtmeniz gerekir. Bu parametreyi belirtmezseniz sistem otomatik olarak bir ana bilgisayar atar.

Not
  • Özel bir kümedeki ana bilgisayarlarla ilgili ayrıntıları sorgulamak için DescribeDedicatedHost işlemini çağırabilirsiniz.
  • Ana bilgisayar oluşturulmamışsa bir ana bilgisayar oluşturmak için CreateDedicatedHost işlemini çağırabilirsiniz.
TargetDedicatedHostIdForSlave String Hayır i-bp*****2

Özel kümedeki ikincil örneğin ait olduğu ana bilgisayarın kimliği.

Örnek RDS Yüksek Kullanılabilirlik Sürümü veya RDS Kurumsal Sürüm çalıştırıyorsa ve örneği özel bir kümede oluşturuyorsanız bu parametreyi belirtmeniz gerekir. Bu parametreyi belirtmezseniz sistem otomatik olarak bir ana bilgisayar atar.

Not
  • Özel bir kümedeki ana bilgisayarlarla ilgili ayrıntıları sorgulamak için DescribeDedicatedHosts işlemini çağırabilirsiniz.
  • Ana bilgisayar oluşturulmamışsa bir ana bilgisayar oluşturmak için CreateDedicatedHost işlemini çağırabilirsiniz.
TargetDedicatedHostIdForLog String Hayır i-bp*****3

Özel kümedeki günlükleyici örneğin ait olduğu ana bilgisayarın kimliği.

Örnek RDS Kurumsal Sürüm çalıştırıyorsa ve örneği özel bir kümede oluşturuyorsanız bu parametreyi belirtmeniz gerekir. Bu parametreyi belirtmezseniz sistem otomatik olarak bir ana bilgisayar atar.

Not
  • Özel bir kümedeki ana bilgisayarlarla ilgili ayrıntıları sorgulamak için DescribeDedicatedHosts işlemini çağırabilirsiniz.
  • Ana bilgisayar oluşturulmamışsa bir ana bilgisayar oluşturmak için CreateDedicatedHost işlemini çağırabilirsiniz.
DBParamGroupId String Hayır rpg-sys-*****

Parametre şablonunun kimliği. Parametre şablonunun kimliğini sorgulamak için DescribeParameterGroups işlemini çağırabilirsiniz.

Not
  • RDS Temel Sürüm çalışan ve X-Engine depolama altyapısını kullanan bir örnek oluşturmak istiyorsanız yukarıdaki işlemi çağırmanız, yanıtta mysql_xengine_8.0_basic_normal_safe alanını bulmanız, gerekli sistem parametre şablonunun kimliğini tespit etmeniz ve ardından bu kimliği bu parametrenin değeri olarak kullanmanız gerekir.
  • RDS Yüksek Kullanılabilirlik Sürümü çalışan ve X-Engine depolama altyapısını kullanan bir örnek oluşturmak istiyorsanız yukarıdaki işlemi çağırmanız, yanıtta mysql_xengine_8.0_standard_normal_safe alanını bulmanız, gerekli sistem parametre şablonunun kimliğini tespit etmeniz ve ardından bu kimliği bu parametrenin değeri olarak kullanmanız gerekir.
DBTimeZone String Hayır +08:00

Örneğin saat dilimi. Bu parametre yalnızca Engine parametresini MySQL veya PostgreSQL olarak ayarladığınızda etkili olur.

  • Engine parametresini MySQL olarak ayarlarsanız:
    • Örneğin saat dilimi UTC cinsindendir. Geçerli değerler: -12:59 ila +13:00.
    • Örnek yerel SSD'ler kullanıyorsa saat diliminin adını belirtebilirsiniz. Örneğin Asia/Hong_Kong saat dilimini belirtebilirsiniz. Daha fazla bilgi için bkz. Saat dilimleri.
  • Engine parametresini PostgreSQL olarak ayarlarsanız:
    • Örneğin saat dilimi UTC cinsinden değildir. Daha fazla bilgi için bkz. Saat dilimleri.
    • Bu parametreyi yalnızca örnek standart SSD'ler veya ESSD'ler ile PostgreSQL çalıştırdığında belirtebilirsiniz.
Not
  • Örnek bir birincil örnekse bu parametreyi belirtebilirsiniz. Örnek bir salt okunur örnekse bu parametreyi belirtemezsiniz. Salt okunur örnek, birincil örneğinin saat dilimini devralır.
  • Bu parametreyi belirtmezseniz sistem otomatik olarak örneğin bulunduğu bölgenin varsayılan saat dilimini atar.
DBIsIgnoreCase String Hayır true

Tablo adının büyük/küçük harfe duyarlı olup olmadığını belirtir. Geçerli değerler:

  • true: Tablo adları büyük/küçük harfe duyarlı değildir. Bu varsayılan değerdir.
  • false: Tablo adları büyük/küçük harfe duyarlıdır.
TargetMinorVersion String Hayır rds_20200229

Örneğin küçük altyapı sürümü. Bu parametre yalnızca MySQL veya PostgreSQL çalıştıran bir örnek oluşturduğunuzda gereklidir.

Değer biçimi, örneğin veritabanı altyapısına göre değişir.

  • Bir ApsaraDB RDS for MySQL örneği oluşturursanız değer aşağıdaki biçimdedir: <RDS sürümü>_<Küçük altyapı sürümü>. Örnekler: rds_20200229, xcluster_20200229 ve xcluster80_20200229. Aşağıdaki listede örnek değerlerdeki alanlar açıklanmaktadır:
    • rds: Örnek RDS Temel Sürüm veya Yüksek Kullanılabilirlik Sürümü çalıştırır.
    • xcluster: Örnek, RDS Kurumsal Sürüm üzerinde MySQL 5.7 çalıştırır.
    • xcluster80: Örnek, RDS Kurumsal Sürüm üzerinde MySQL 8.0 çalıştırır.
Not Küçük altyapı sürümünü sorgulamak için DescribeDBMiniEngineVersions işlemini çağırabilirsiniz. Küçük altyapı sürümleri hakkında daha fazla bilgi için bkz. AliSQL sürüm notları.
  • Bir ApsaraDB RDS for PostgreSQL örneği oluşturursanız değer aşağıdaki biçimdedir: rds_postgres_<Ana altyapı sürümü>00_<Küçük altyapı sürümü>. Örnek: rds_postgres_1400_20220830. Aşağıdaki listede örnek değerdeki alanlar açıklanmaktadır:
    • 1400: Ana altyapı sürümü PostgreSQL 14'tür.
    • 20220830: AliPG sürümü. AliPG sürümünü sorgulamak için DescribeDBMiniEngineVersions işlemini çağırabilirsiniz. Küçük altyapı sürümleri hakkında daha fazla bilgi için bkz. AliPG sürüm notları.
Not ApsaraDB RDS for PostgreSQL örneğiniz için BabelfishConfig parametresini yapılandırırsanız ve babelfishEnabled alanını true olarak ayarlarsanız bu parametrenin değeri aşağıdaki biçimdedir: rds_postgres_Ana altyapı sürümü00_AliPG sürümü_babelfish.
StorageAutoScale String Hayır Disable

Örnek için otomatik depolama genişletme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • Enable.
  • Disable. Bu varsayılan değerdir.
Not Örnek oluşturulduktan sonra örnek için otomatik depolama genişletme özelliğinin ayarlarını değiştirmek üzere ModifyDasInstanceConfig işlemini çağırabilirsiniz. Daha fazla bilgi için bkz. Bir ApsaraDB RDS for MySQL örneği için otomatik depolama genişletmeyi yapılandırma.
StorageThreshold Integer Hayır 50

Otomatik depolama genişletmenin tetiklendiği yüzde eşik değeri.

  • 10
  • 20
  • 30
  • 40
  • 50
Not StorageAutoScale parametresini Enable olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
StorageUpperBound Integer Hayır 2000

Otomatik depolama genişletme için izin verilen maksimum depolama kapasitesi. Örneğin depolama kapasitesi maksimum depolama kapasitesini aşamaz. Birim: GB.

  • Geçerli değerler: 0'a eşit veya 0'dan büyük bir tamsayı.
  • StorageAutoScale parametresini Enable olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
DryRun Boolean Hayır false

Kuru çalıştırma yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Kuru çalıştırma gerçekleştirir. Sistem istek parametreleri, istek biçimi, hizmet sınırları ve kullanılabilir kaynaklar gibi öğeleri denetler.
  • false: Kuru çalıştırma gerçekleştirir ve isteği gönderir. İstek kuru çalıştırmayı geçerse işlem gerçekleştirilir. Bu varsayılan değerdir.
UserBackupId String Hayır 67798*****

Yedekleme dosyasının kimliği. Yedekleme dosyalarını sorgulamak için ListUserBackupFiles işlemini çağırabilirsiniz. Bir yedekleme dosyasının verilerini kullanarak bir örnek oluşturmak istiyorsanız bu parametreyi belirtmeniz gerekir.

Not Bu parametre yalnızca aşağıdaki gereksinimler karşılandığında desteklenir:
  • PayType parametresi Postpaid olarak ayarlanır.
  • Engine parametresi MySQL olarak ayarlanır.
  • EngineVersion parametresi 5.7 olarak ayarlanır.
  • Category parametresi Basic olarak ayarlanır.
Amount Integer Hayır 2

Oluşturmak istediğiniz ApsaraDB RDS for MySQL örneklerinin sayısı. Parametre yalnızca tek bir istek kullanarak aynı anda birden çok ApsaraDB RDS for MySQL örneği oluşturduğunuzda etkili olur.

Geçerli değerler: 1 ila 20. Varsayılan değer: 1.

Not
  • Tek bir istek kullanarak aynı anda birden çok ApsaraDB RDS for MySQL örneği oluşturmak istiyorsanız Tag.N.Key parametresi ve Tag.N.Value parametresi kullanarak tüm örneklere etiket ekleyebilirsiniz. Örnekler oluşturulduktan sonra örnekleri etiketlere göre yönetebilirsiniz.
  • Birden çok ApsaraDB RDS for MySQL örneği oluşturma isteği gönderdikten sonra bu işlem TaskId, RequestId ve Message parametrelerini döndürür. Bir örnekle ilgili ayrıntıları sorgulamak için DescribeDBInstanceAttribute işlemini çağırabilirsiniz.
  • Engine parametresinin değeri MySQL değilse ve Amount parametresinin değeri 1'den büyükse bu işlem başarısız olur ve InvalidParam.Engine hata kodu döndürülür.
CreateStrategy String Hayır Atomicity

Birden çok örneğin oluşturulmasına dayalı ilke. Parametre yalnızca Amount parametresinin değeri 1'den büyük olduğunda etkili olur. Geçerli değerler:

  • Atomicity: Atomiklik. Örneklerin tümü oluşturulur. Bir örnek oluşturulamazsa örneklerin hiçbiri oluşturulmaz.
  • Partial: Atomik olmama. Her örnek bağımsız olarak oluşturulur. Bir örneğin oluşturulmasındaki başarısızlık diğer örneklerin oluşturulmasını etkilemez.
Not Varsayılan değer: Atomicity.
Tag.N.Key String Hayır testkey1

Örneğe eklemek istediğiniz N. etiketin anahtarı. Bu parametreyi kullanarak örneğe etiket ekleyebilirsiniz.

Not
  • Belirtilen etiket anahtarı mevcut bir anahtarsa sistem etiket anahtarını doğrudan örneğe ekler. Mevcut etiketlerle ilgili ayrıntıları sorgulamak için ListTagResources işlemini çağırabilirsiniz.
  • Belirtilen etiket anahtarı mevcut değilse sistem etiket anahtarını oluşturur ve örneğe ekler.
  • Bu parametrenin değeri boş bir dize olamaz.
  • Bu parametre Tag.N.Value parametresi ile birlikte kullanılmalıdır.
Tag.N.Value String Hayır testvalue1

Örneğe eklenen N. etiketin değeri. Bu parametreyi kullanarak örneğe etiket ekleyebilirsiniz.

Not
  • Belirtilen etiket değeri belirtilen etiket anahtarında bulunursa sistem etiket değerini doğrudan örneğe ekler. Mevcut etiketlerle ilgili ayrıntıları sorgulamak için ListTagResources işlemini çağırabilirsiniz.
  • Belirtilen etiket değeri belirtilen etiket anahtarında bulunmuyorsa sistem etiket değerini oluşturur ve örneğe ekler.
  • Bu parametre Tag.N.Key parametresi ile birlikte kullanılmalıdır.
DeletionProtection Boolean Hayır true

Örnek için silme koruma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir.

  • true: Özelliği etkinleştirir.
  • false: Özelliği devre dışı bırakır. Bu varsayılan değerdir.
BabelfishConfig String Hayır {"babelfishEnabled":"true","migrationMode":"single-db","masterUsername":"babelfish_user","masterUserPassword":"Babelfish123!"}

ApsaraDB RDS for PostgreSQL örneği için Babelfish özelliğinin yapılandırması.

Biçim:{"babelfishEnabled":"true","migrationMode":"xxxxxxx","masterUsername":"xxxxxxx","masterUserPassword":"xxxxxxxx"}

Aşağıdaki listede biçimdeki alanlar açıklanmaktadır:

  • babelfishEnabled: Örnek için Babelfish'in etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu alanı true olarak ayarlarsanız örnek için Babelfish'i etkinleştirirsiniz. Bu parametreyi boş bırakırsanız örnek için Babelfish'i etkinleştirmezsiniz.
  • migrationMode: Örneğin geçiş modu. Geçerli değerler: single-db ve multi-db.
  • masterUsername: Yönetici hesabının kullanıcı adı. Kullanıcı adı küçük harf, rakam ve alt çizgi (_) içerebilir. Bir harfle başlamalı ve bir harf veya rakamla bitmelidir. Uzunluğu en fazla 63 karakter olabilir ve pg ile başlayamaz.
  • masterUserPassword: Yönetici hesabının parolası. Parola büyük harf, küçük harf, rakam ve özel karakterlerden oluşan aşağıdaki karakter türlerinden en az üçünü içermelidir. Uzunluğu 8 ila 32 karakter arasında olmalıdır. Parola aşağıdaki karakterlerden herhangi birini içerebilir: ! @ # $ % ^ & * ( ) _ + - =.
Not Bu parametre yalnızca bir ApsaraDB RDS for PostgreSQL örneği oluşturduğunuzda etkili olur. Daha fazla bilgi için bkz. Babelfish'e Giriş.
ServerlessConfig Object Hayır

Sunucusuz örneğin ayarları. Bu parametre sunucusuz bir örnek oluşturduğunuzda gereklidir.

Not Bu parametre yalnızca bir ApsaraDB RDS for MySQL örneği oluşturduğunuzda etkili olur.
MaxCapacity double Hayır 8

Maksimum RDS Kapasite Birimi (RCU) sayısı. Geçerli değerler: 0,5 ila 8.

Not Bu parametrenin değeri MinCapacity parametresinin değerine eşit veya ondan büyük olmalıdır.
MinCapacity double Hayır 0.5

Minimum RCU sayısı. Geçerli değerler: 0,5 ila 8.

Not Bu parametrenin değeri MaxCapacity parametresinin değerine eşit veya ondan küçük olmalıdır.
AutoPause Boolean Hayır true

Sunucusuz örnek için akıllı başlatma ve durdurma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Özelliği etkinleştirir.
  • false: Özelliği devre dışı bırakır. Bu varsayılan değerdir.
Not Akıllı başlatma ve durdurma özelliği etkinleştirildikten sonra örneğe 10 dakika içinde bağlantı kurulmazsa örnek durdurulur. Örneğe bir bağlantı kurulduktan sonra örnek otomatik olarak uyanır.
SwitchForce Boolean Hayır false

Sunucusuz örnek için zorunlu ölçeklendirme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Özelliği etkinleştirir.
  • false: Özelliği devre dışı bırakır. Bu varsayılan değerdir.
Not
  • Bu parametreyi true olarak ayarlarsanız zorunlu ölçeklendirme işlemi sırasında yaklaşık 1 dakika süren geçici bir bağlantı kesintisi oluşur. Dikkatli ilerleyin.
  • Sunucusuz bir örnek için RCU ölçeklendirmesi hemen etkili olur. Büyük işlemlerin çalıştırılması gibi bazı durumlarda ölçeklendirme hemen etkili olmaz. Bu durumda örneğin RCU'larını zorunlu olarak ölçeklendirmek için bu özelliği etkinleştirebilirsiniz.
ConnectionString String Hayır rm-uf6wjk5*****.mysql.rds.aliyuncs.com

Örneğin uç noktası.

Not DBInstanceNetType parametresi uç noktanın dahili bir uç nokta mı yoksa genel bir uç nokta mı olduğunu belirtir.

Yanıt parametreleri

Parametre Tür Örnek Açıklama
DryRunResult Boolean true

İsteğin kuru çalıştırmayı geçip geçmediğini belirtir. Geçerli değerler:

  • true: İstek kuru çalıştırmayı geçti.
  • false: İstek kuru çalıştırmayı geçemedi.
    Not
    • Sistem kuru çalıştırma yapmazsa bu parametre döndürülmez.
    • İstek kuru çalıştırmayı geçemezse bir hata iletisi döndürülür.
TagResult Boolean true

Belirtilen etiketin örneğe eklenip eklenmediğini belirtir. Geçerli değerler:

  • true: Belirtilen etiket örneğe eklenir.
  • false: Belirtilen etiket örneğe eklenemez.
Not Örneğe bir etiket eklemezseniz bu parametre döndürülmez.
RequestId String 1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC

İsteğin kimliği.

ConnectionString String rm-uf6wjk5*****.mysql.rds.aliyuncs.com

Örneğin uç noktası.

Not DBInstanceNetType parametresi uç noktanın dahili bir uç nokta mı yoksa genel bir uç nokta mı olduğunu belirtir.
Message String Batch Create DBInstance Task Is In Process.

Birden çok örneğin oluşturulup oluşturulmadığını belirten ileti.

Not Bu parametre yalnızca Amount parametresinin değeri 1'den büyük olduğunda döndürülür.
DBInstanceId String rm-uf6wjk5*****

Örneğin kimliği. Amount parametresinin değeri 1'den büyükse birden fazla örnek kimliği döndürülür. Döndürülen örnek kimliklerinin sayısı Amount parametresinin değeriyle aynıdır. Döndürülen örnek kimlikleri virgülle (,) ayrılır.

Örneğin Amount parametresinin değeri 3 ise üç örnek kimliği döndürülür. Örnekler:

rm-uf6wjk5*****1,rm-uf6wjk5*****2,rm-uf6wjk5*****3
Port String 3306

Örneğin bağlantı noktası.

Not DBInstanceNetType parametresi bağlantı noktasının dahili bir bağlantı noktası mı yoksa genel bir bağlantı noktası mı olduğunu belirtir.
TaskId String s2365879-a9d0-55af-fgae-f2*****

Birden çok örnek oluşturmak için çalıştırılan görevin kimliği.

Not
  • Bu parametre yalnızca Amount parametresinin değeri 1'den büyük olduğunda döndürülür.
  • TaskID parametresi bir görevi sorgulamak için kullanılamaz.
DryRun Boolean true

Sistemin kuru çalıştırma yaptığını belirtir.

Not
  • Dönüş değeri sabit olarak true şeklindedir.
  • Sistem kuru çalıştırma yapmazsa bu parametre döndürülmez.
OrderId String 1007893702*****

Siparişin kimliği.

Not

SDK'nin en son sürümünde istemci tarafındaki varsayılan zaman aşımı süresi örnekteki varsayılan zaman aşımı süresinden farklıdır. Bu işlemi çağırmak için SDK'nin en son sürümünü kullanırsanız bu işlem başarılı bir şekilde çağrılsa bile zaman aşımı hatası bildirilebilir. Bu sorunu önlemek için bu işlemi çağırmadan önce ReadTimeout parametresini 20000 olarak ayarlayabilirsiniz.

Configure the setReadTimeout parameter

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=CreateDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=100
&DBInstanceNetType=Internet
&PayType=Postpaid
&SecurityIPList=10.23.XX.XX/24
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<CreateDBInstanceResponse>
    <OrderId>1007893702*****</OrderId>
    <ConnectionString>rm-uf6wjk5*****.mysql.rds.aliyuncs.com</ConnectionString>
    <DBInstanceId>rm-uf6wjk5*****</DBInstanceId>
    <Port>3306</Port>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
</CreateDBInstanceResponse>

JSON biçimi

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

{
  "OrderId" : "1007893702*****",
  "ConnectionString" : "rm-uf6wjk5*****.mysql.rds.aliyuncs.com",
  "DBInstanceId" : "rm-uf6wjk5*****",
  "Port" : 3306,
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC"
}

Hata kodları

HTTP durum kodu

Hata kodu

Hata iletisi

Açıklama

400

InvalidInstanceLevel.DiskType

Specified instance level not support request disk type

Belirtilen örnek türünün belirtilen depolama türünü desteklememesi nedeniyle döndürülen hata iletisi.

400

RR309

We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.

Ödeme yönteminizde güvenlik riskleri algılandığı için döndürülen hata iletisi. Size gönderilen e-postadaki veya ApsaraDB RDS konsolundaki bağlantıya tıklayarak doğrulamaya devam edin. Doğrulamayı tamamladıktan sonra siparişi tekrar gönderin.

400

InvalidZoneId.NotSupported

The Specified vpc Zone not supported.

Belirtilen alanda VPC içinde örnek oluşturmanıza izin verilmediği için döndürülen hata iletisi. Farklı bir alan belirtin ve tekrar deneyin.

400

InvalidZone.NotSupportedForStorageType

The specified zone is closed or invalid for Specified DBInstanceStorageType.

Belirtilen alan artık kullanılamadığı veya belirtilen DBInstanceStorageType parametresi geçersiz olduğu için döndürülen hata iletisi.

400

InvalidZone.NotSupported

The Specified Zone not supported.

Belirtilen bölge kimliği geçersiz olduğu için döndürülen hata iletisi.

400

InvalidEssdStorageSize

invalid cloud essd storage size.

Belirtilen örnek türü geçersiz olduğu için döndürülen hata iletisi. Geçerli bir örnek türü seçin ve tekrar deneyin.

400

IncompleteAccountInfo

Your information is incomplete. Complete your information before the operation.

Hesap bilgileriniz eksik olduğu için döndürülen hata iletisi. Account Center konsoluna oturum açın ve yıldız işareti (*) ile işaretlenen tüm hesap bilgisi öğelerini belirtin. Temel Bilgiler sayfasındaki bilgi öğelerini kontrol edin.

400

IncompleteTaxInfo

Your tax information is incomplete. Complete your information before the operation.

Vergi bilgileriniz eksik olduğu için döndürülen hata iletisi. Gerekli tüm vergi bilgilerini belirtin.

400

InvalidPaymentMethod.Incomplete

No payment method is specified for your account. We recommend that you add a payment method.

Alibaba Cloud hesabınızda geçerli bir ödeme yöntemi sağlanmadığı için döndürülen hata iletisi. Geçerli bir ödeme yöntemi ekleyin ve tekrar deneyin.

400

InvalidPaymentMethod.Missing

No payment method is specified for your account. We recommend that you add a payment method.

Alibaba Cloud hesabınızda geçerli bir ödeme yöntemi sağlanmadığı için döndürülen hata iletisi. Geçerli bir ödeme yöntemi ekleyin ve tekrar deneyin.

400

InsuffcientBalanceOrBankAccount

Add a payment method or add funds to the prepayment balance. Get started by creating an instance.

Geçerli Alibaba Cloud hesabında geçerli bir ödeme yöntemi sağlanmadığı için döndürülen hata iletisi. Geçerli bir ödeme yöntemi ekleyin veya geçerli Alibaba Cloud hesabına fon ekleyin.

400

VswitchIpExhausted

Vswitch IP exhausted.

vSwitch IP adresleri tükendiği için döndürülen hata iletisi.

400

InvalidPrivateIpAddress.AlreadyUsed

The specified IP is already used.

Belirtilen IP adresi kullanımda olduğu için döndürülen hata iletisi.

400

InvalidConcurrentOperate

Concurrent operation is detected.

Sistemde eşzamanlı işlemler çalıştığı için döndürülen hata iletisi. Önceki işlem tamamlanana kadar bekleyin ve tekrar deneyin.

400

ZoneId.NotMatchWithCategory

The number of ZoneId specified does not match with category.

Belirttiğiniz alan sayısı belirtilen veritabanı altyapısı veya RDS sürümü için desteklenmediği için döndürülen hata iletisi. Geçerli bir alan sayısı belirtin ve tekrar deneyin.

400

InvalidSecurityIPList.Format

The specified parameter securityIPList is not valid.

Belirtilen IP adresi izin listesi geçersiz biçimde olduğu için döndürülen hata iletisi. IP adresi izin listesini değiştirin ve tekrar deneyin.

400

InvalidEngineVersion.Malformed

The specified parameter EngineVersion is not valid.

Belirtilen veritabanı altyapısı sürümü geçersiz olduğu için döndürülen hata iletisi. Veritabanı altyapısı sürümünü kontrol edin ve tekrar deneyin.

400

CreditPayInsufficientBalance

Insufficient credit pay limit. Please contact your channel partner to increase the limit.

Alibaba Cloud hesabınızda yeterli bakiye olmadığı için döndürülen hata iletisi. Alibaba Cloud hesabınızın bakiyesinin yeterli olduğundan emin olun.

400

InvalidTagKey.Malformed

The Tag.N.Key parameter is empty.

Tag.N.Key parametresi boş olduğu için döndürülen hata iletisi.

400

InvalidTagValue.Malformed

The Tag.N.Value parameter is empty.

Tag.N.Value parametresi boş olduğu için döndürülen hata iletisi.

400

Duplicate.TagKey

The Tag.N.Key contains duplicate keys.

Tag.N.Key parametresi yinelenen bir anahtar belirttiği için döndürülen hata iletisi.

400

NumberExceed.Tags

The maximum number of Tags is exceeded. The maximum is 20.

Belirttiğiniz etiket sayısı izin verilen maksimum etiket sayısını aştığı için döndürülen hata iletisi. En fazla 20 etikete izin verilir.

400

MissingParameter.ResourceIds

The parameter ResourceIds.N must not be null.

ResourceIds.N parametresi boş olduğu için döndürülen hata iletisi.

400

InvalidParameter.TagKey

The Tag.N.Key parameter is invalid.

Tag.N.Key parametresinin değeri geçersiz olduğu için döndürülen hata iletisi.

400

InvalidParameter.TagValue

The Tag.N.Value parameter is invalid.

Tag.N.Value parametresi geçersiz olduğu için döndürülen hata iletisi.

400

NoPermission.SystemTag

You have no permission to use system tags.

Belirttiğiniz etiketler sistem etiketleri olduğu için döndürülen hata iletisi.

400

InvalidParam.Amount

Amount is allowed from 1 to 20.

Amount parametresinin değeri 1 ila 20 aralığında olmadığı için döndürülen hata iletisi.

400

InvalidParam.CreateStrategy

Only Atomicity and Partial are allowed.

CreateStrategy parametresinin değeri Atomicity veya Partial olmadığı için döndürülen hata iletisi.

400

InvalidConnectionString.Duplicate

Specified connection string already exists in the Aliyun RDS.

Belirttiğiniz uç nokta zaten mevcut olduğu için döndürülen hata iletisi. Farklı bir uç nokta belirtin.

401

CannotDecreaseEssdPerfLevel

cannot decrease cloud essd performance level.

Depolama türü değişikliği doğrulamayı geçemediği için döndürülen hata iletisi. Standart SSD'ler veya ESSD'ler ile SQL Server çalıştıran bir örnek yalnızca yeni özelliklere sahip standart SSD'ler veya ESSD'ler kullanacak şekilde yükseltilebilir.

403

AliCroup2CloudUserCannotBuyNotInnerCommodity

There is no group cloud commodity label, and users within the group are not allowed to purchase.

Ürünler Alibaba Cloud ile etiketlenmediği ve dahili kullanıcılar için kullanılamadığı için döndürülen hata iletisi.

403

GroupReplicationNotSupport.InvalidEngineVersion

Group Replication requires the instance engine version to be 8.0.

Örneğin ana altyapı sürümü MySQL 8.0 olmadığı ve grup çoğaltmanın desteklenmediği için döndürülen hata iletisi.

403

GroupReplicationNotSupport.InvalidNodeClassCode

Group Replication requires the ClassCode of each node to be consistent.

Örnekteki düğümlerin teknik özellikleri farklı olduğu ve grup çoğaltmanın desteklenmediği için döndürülen hata iletisi.

403

GroupReplicationNotSupport.InvalidNodeNum

Group Replication is not supported, the number of nodes must be an odd number greater than or equal to 3.

Örnekteki düğüm sayısı 3'ten büyük tek sayı olmadığı ve grup çoğaltmanın desteklenmediği için döndürülen hata iletisi.

403

GroupReplicationNotSupport.InvalidXengine

Group Replication is not supported because the instance has xengine tables.

Örnekte X-Engine tabloları bulunduğu ve grup çoğaltmanın desteklenmediği için döndürülen hata iletisi.

403

GroupReplicationNotSupport.MemoryTooSmall

Group Replication is not supported because the memory is too small.

Örneğin bellek kapasitesi küçük olduğu ve MySQL grup çoğaltmasının desteklenmediği için döndürülen hata iletisi.

403

IncorrectMinorVersion

Current engine minor version does not support operations.

Geçerli küçük altyapı sürümü için bu işlem desteklenmediği için döndürülen hata iletisi.

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