Verileri bölgeler arası yeni bir örneğe geri yükleme -

CreateDdrInstance işlemini çağırarak bir örneğin verilerini farklı bir bölgede bulunan yeni bir örneğe geri yükleyebilirsiniz.

Bu işlemi çağırmadan önce, kaynak örneğin verilerinin bölge dışı yedekleme dosyasından geri yüklenip yüklenemeyeceğini kontrol etmek için CheckCreateDdrDBInstance işlemini çağırabilirsiniz.

Bu işlemi çağırmadan önce örneğin aşağıdaki veritabanı altyapılarından birini çalıştırdığından emin olun:

MySQL. Daha fazla bilgi için bkz. ApsaraDB RDS for MySQL örneğini bölgeler arasında yedekleme.
SQL Server. Daha fazla bilgi için bkz. ApsaraDB RDS for SQL Server örneğini bölgeler arasında yedekleme.
PostgreSQL. Daha fazla bilgi için bkz. ApsaraDB RDS for PostgreSQL örneğini bölgeler arasında yedekleme.

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 örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	CreateDdrInstance	Gerçekleştirmek istediğiniz işlem. Değeri CreateDdrInstance olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Hedef örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
Engine	String	Evet	MySQL	Hedef örneğin veritabanı altyapısı. Geçerli değerler: MySQL SQLServer PostgreSQL
EngineVersion	String	Evet	5.6	Hedef örneğin ana altyapı sürümü. Bu parametrenin değeri, Engine parametresinin değerine göre değişir. Geçerli değerler: Engine parametresini MySQL olarak ayarlarsanız geçerli olan değerler: 5.5, 5.6, 5.7 ve 8.0 Engine parametresini SQL Server olarak ayarlarsanız geçerli olan 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 ayarlarsanız geçerli olan değerler: 9.4, 10.0, 11.0, 12.0 ve 13.0
DBInstanceClass	String	Evet	rds.mysql.s1.small	Hedef örneğin örnek türü. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.
DBInstanceStorage	Integer	Evet	20	Hedef örneğin depolama kapasitesi. Geçerli değerler: 5 ile 2000 arasında. Birim: GB. Bu değer 5 GB'nin katı olmalıdır. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri.
SystemDBCharset	String	Hayır	uft8	Hedef örneğin karakter kümesi. Geçerli değerler: utf8 gbk latin1 utf8mb4
DBInstanceNetType	String	Evet	Intranet	Hedef örneğin ağ bağlantı türü. Geçerli değerler: Internet: İnternet Intranet: Dahili ağ
DBInstanceDescription	String	Hayır	testdatabase	Hedef örneğin adı. Ad 2 ila 256 karakter uzunluğunda olmalı ve harfler, rakamlar, alt çizgiler (_) ve kısa çizgiler (-) içerebilir. Ad bir harfle başlamalıdır. Not Ad http:// veya https:// ile başlayamaz.
SecurityIPList	String	Evet	127.0.0.1	Hedef örneğin IP adresi izin listesi. IP adresi izin listesine birden fazla giriş eklemek istiyorsanız girişleri virgül (,) ile ayırın. Her giriş benzersiz olmalıdır. En fazla 1.000 giriş ekleyebilirsiniz. Daha fazla bilgi için bkz. ApsaraDB RDS for MySQL örneği için IP adresi izin listesi yapılandırma. IP adresi izin listesindeki girişler aşağıdaki biçimlerden birinde olmalıdır: IP adresi. Örnek: 10.23.12.24. CIDR bloğu. Örnek: 10.23.12.24/24. Bu örnekte 24, CIDR bloğunun ön ekinin 24 bit uzunluğunda olduğunu gösterir. 24 yerine 1 ile 32 arasında bir değer kullanabilirsiniz.
ClientToken	String	Hayır	ETnLKlblzczshOTUbOCzxxxxxxxxxx	İsteğin yinelenebilirliğini sağlamak için kullanılan istemci belirteci. Belirteci istemci kullanarak oluşturabilirsiniz ancak oluşturulan belirtecin farklı istekler arasında benzersiz olduğundan emin olmanız gerekir. Belirteç yalnızca ASCII karakterleri içerebilir ve 64 karakterden uzun olamaz.
PayType	String	Evet	Prepaid	Hedef örneğin faturalandırma yöntemi. Geçerli değerler: Postpaid: Kullandıkça öde Prepaid: Abonelik
ZoneId	String	Hayır	cn-hangzhou-b	Hedef örneğin alan kimliği. Hedef örnek birden fazla alanda dağıtılıyorsa alanların kimliklerini iki nokta üst üste (:) ile ayırın. Not Bir sanal özel cloud (VPC) ve bir vSwitch belirtirseniz ZoneId parametresini de belirtmeniz gerekir.
InstanceNetworkType	String	Hayır	Classic	Hedef örneğin ağ türü. Geçerli değerler: VPC Classic Varsayılan değer: Classic. Not Bu parametreyi VPC olarak ayarlarsanız VPCId ve VSwitchId parametrelerini de belirtmeniz gerekir.
ConnectionMode	String	Hayır	Standard	Hedef örneğin bağlantı modu. Geçerli değerler: Standard: Standart mod Safe: Veritabanı proxy modu Varsayılan değer: Standard
VPCId	String	Hayır	vpc-xxxxxxxxxxxx	Hedef örneğin VPC kimliği. Bu parametre yalnızca InstanceNetworkType parametresini VPC olarak ayarladığınızda kullanılabilir. Not Bu parametreyi belirtirseniz ZoneId parametresini de belirtmeniz gerekir.
VSwitchId	String	Hayır	vsw-xxxxxxxxxxx	Hedef örneğin vSwitch kimliği. Birden fazla vSwitch belirtirseniz vSwitch'lerin kimliklerini virgül (,) ile ayırın. Bu parametre yalnızca InstanceNetworkType parametresini VPC olarak ayarladığınızda kullanılabilir. Not Bu parametreyi belirtirseniz ZoneId parametresini de belirtmeniz gerekir.
PrivateIpAddress	String	Hayır	172.XXX.XXX.69	Hedef örneğin özel IP adresi. Özel IP adresi, belirtilen vSwitch tarafından desteklenen CIDR bloğu içinde olmalıdır. Sistem, VPCId ve VSwitchId parametrelerinin değerlerine göre bir örneğe otomatik olarak özel bir 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 ile 3 arasında olur. Period parametresini Month olarak ayarlarsanız UsedTime parametresinin değeri 1 ile 9 arasında olur. Not PayType parametresini Prepaid olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
Period	String	Hayır	Year	Hedef örneğin abonelik süresini ölçmek için kullanılan birim. Geçerli değerler: Year Month Not PayType parametresini Prepaid olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
ResourceGroupId	String	Hayır	rg-acfmyxxxxxxxxxx	Kaynak grubunun kimliği.
RestoreType	String	Evet	BackupSet	Verilerin geri yüklenmesi için kullanılan yöntem. Geçerli değerler: BackupSet: Veriler bir yedekleme setinden geri yüklenir. Bu değeri kullanırsanız BackupSetID parametresini de belirtmeniz gerekir. BackupTime: Verileri belirli bir zamana geri yükler. RestoreTime, SourceRegion ve SourceDBInstanceName parametrelerini de belirtmeniz gerekir.
BackupSetId	String	Hayır	14***	Geri yükleme için kullanılan yedekleme setinin kimliği. Yedekleme setinin kimliğini sorgulamak için DescribeCrossRegionBackups işlemini çağırabilirsiniz. Not RestoreType parametresini BackupSet olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
RestoreTime	String	Hayır	2019-05-30T03:29:10Z	Verileri geri yüklemek istediğiniz zaman noktası. Belirttiğiniz zaman noktası geçerli zamandan önce olmalıdır. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Saat UTC cinsinden olmalıdır. Not RestoreType parametresini BackupTime olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
SourceRegion	String	Hayır	cn-hangzhou	Verileri belirli bir zamana geri yüklemek istiyorsanız kaynak örneğin bölge kimliği. Not RestoreType parametresini BackupTime olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
SourceDBInstanceName	String	Hayır	rm-uf6wjk5xxxxxxx	Verileri belirli bir zamana geri yüklemek istiyorsanız kaynak örneğin kimliği. Not RestoreType parametresini BackupTime olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir.
DBInstanceStorageType	String	Hayır	local_ssd	Hedef örneğin depolama türü. Yalnızca yerel SSD depolama türü desteklenir. Varsayılan değer: local_ssd.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
DBInstanceId	String	rm-xxxxx	Hedef örneğin kimliği.
RequestId	String	E52666CC-330E-418A-8E5B-A19E3FB42D13	İsteğin kimliği.
Port	String	3306	Hedef örneğe bağlanmak için kullanılan bağlantı noktası numarası. Not DBInstanceNetType parametresi, bağlantı noktasının dahili mi yoksa genel mi olduğunu gösterir.
ConnectionString	String	rm-xxxxx.mysql.rds.aliyuncs.com	Hedef örneğe bağlanmak için kullanılan uç nokta. Not DBInstanceNetType parametresi, uç noktanın dahili mi yoksa genel mi olduğunu gösterir.
OrderId	String	2038691xxxxx	Siparişin kimliği.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=CreateDdrInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&SystemDBCharset=uft8
&DBInstanceNetType=Intranet
&DBInstanceDescription=testdatabase
&SecurityIPList=127.0.0.1
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&InstanceNetworkType=Classic
&ConnectionMode=Standard
&VPCId=vpc-xxxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX.XXX.69
&UsedTime=2
&Period=Year
&ResourceGroupId=rg-acfmyxxxxxxxxxx	
&RestoreType=BackupSet
&BackupSetId=14***
&RestoreTime=2019-05-30T03:29:10Z
&SourceRegion=cn-hangzhou
&SourceDBInstanceName=rm-uf6wjk5xxxxxxx
&DBInstanceStorageType=local_ssd
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<CreateDdrInstanceResponse>
    <RequestId>E52666CC-330E-418A-8E5B-A19E3FB42D13</RequestId>
    <DBInstanceId>rm-xxxxx</DBInstanceId>
    <Port>3306</Port>
    <ConnectionString>rm-xxxxx.mysql.rds.aliyuncs.com</ConnectionString>
    <OrderId>2038691xxxxx</OrderId>
</CreateDdrInstanceResponse>

JSON biçimi

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

{
  "RequestId" : "E52666CC-330E-418A-8E5B-A19E3FB42D13",
  "DBInstanceId" : "rm-xxxxx",
  "Port" : "3306",
  "ConnectionString" : "rm-xxxxx.mysql.rds.aliyuncs.com",
  "OrderId" : "2038691xxxxx"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidZoneId.NotSupported	The Specified vpc Zone not supported.	Belirtilen alan, bir VPC'de örnek oluşturmanıza izin vermediği için döndürülen hata mesajı. Farklı bir alan belirtin ve tekrar deneyin.
400	InvalidDBInstanceName.Format	Specified DB instance name is not valid.	Örnek bulunamadığı için döndürülen hata mesajı. Örnek bilgilerini kontrol edin.
400	InvalidDBInstanceName.Duplicate	Specified DB instance name already exists in the Aliyun RDS.	Örnek adı zaten mevcut olduğu için döndürülen hata mesajı. Farklı bir ad belirtin ve tekrar deneyin.
400	InvalidRegion.Format	Specified Region is not valid.	Belirtilen bölge geçersiz olduğu için döndürülen hata mesajı.
400	InvalidServiceType.Format	Specified service type is not valid.	Hizmet türü geçersiz olduğu için döndürülen hata mesajı: Hizmet türünü 0 veya 1 olarak ayarlayın. 0 değeri bir Alibaba Cloud hizmetini, 1 değeri ise bir JST hizmetini gösterir.
400	InvalidEngine.Malformed	Specified engine is not valid.	Veritabanı altyapısı geçersiz olduğu için döndürülen hata mesajı. Geçerli bir veritabanı altyapısı belirtin.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	Belirtilen veritabanı altyapısı sürümü geçersiz olduğu için döndürülen hata mesajı. Veritabanı altyapısı sürümünü kontrol edin ve tekrar deneyin.
400	InvalidConnectionString.Format	Specified connection string is not valid.	Uç nokta ön eki geçersiz olduğu için döndürülen hata mesajı. Ön ek 5 ila 40 karakter uzunluğunda olmalıdır.
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 mesajı. Farklı bir uç nokta belirtin.
400	InvalidCharacterSetName.Format	Specified character set name is not valid.	Belirtilen karakter kümesi geçersiz olduğu için döndürülen hata mesajı. ApsaraDB RDS aşağıdaki karakter kümelerini destekler: GBK, UTF-8, EUC-KR ve ASCII.
400	InvalidDBInstanceType.Format	Specified instance type is not valid.	Belirtilen örnek türü geçersiz olduğu için döndürülen hata mesajı. Geçerli bir örnek türü belirtin.
400	InvalidPort.Malformed	Specified port is not valid.	Belirttiğiniz bağlantı noktası numarası geçersiz olduğu için döndürülen hata mesajı.
400	InvalidBackupRetentionPeriod.Malformed	Specified backup retention period is not valid.	Belirtilen yedekleme döngüsü geçersiz olduğu için döndürülen hata mesajı. Yedekleme döngüsü 1 günden büyük veya 30 güne eşit ya da daha küçük olmalıdır.
400	InvalidPreferredBackupTime.Format	Specified preferred backup time is not valid.	Yedekleme zamanının biçimi yanlış olduğu için döndürülen hata mesajı. Zamanı YYYY-MM-DDThh:mmZ biçiminde GMT cinsinden belirtin. Örnek: 2012-06-11T15:00Z.
400	InvalidPreferredBackupPeriod.Malformed	Specified backup period is not valid.	Yedekleme zamanı geçersiz olduğu için döndürülen hata mesajı.
400	InvalidExpiredTime.Format	Specified expired time is not valid.	ExpiredTime parametresinin değeri geçersiz olduğu için döndürülen hata mesajı. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Saat UTC cinsinden olmalıdır.
400	InvalidSecurityIPList.Format	Specified security IP list format is not valid.	IP adresi izin listesi geçersiz olduğu için döndürülen hata mesajı. IP adresi izin listesini kontrol edin.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list	Belirtilen IP adresleri veya CIDR blokları geçersiz olduğu için döndürülen hata mesajı. Belirtilen IP adresleri veya CIDR blokları yineleniyor.
400	InvalidSecurityIPList.QuotaExceeded	Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.	Belirtilen IP adresi izin listesindeki giriş sayısı üst sınırı aştığı için döndürülen hata mesajı. Bir IP adresi izin listesi için en fazla 1.000 giriş belirtebilirsiniz.
400	InvalidDBInstanceDescription.Format	Specified DB instance description is not valid.	DBInstanceDescription parametresinin değeri geçersiz olduğu için döndürülen hata mesajı. Parametre için geçerli bir değer belirtin. Bu parametrenin değeri 2 ila 256 karakter uzunluğunda olmalı ve harfler, rakamlar, alt çizgiler (_) ve kısa çizgiler (-) içerebilir. Değer bir harfle başlamalıdır.
400	InvalidStorage.Format	Specified Storage is not valid.	Depolama parametresinin değeri geçersiz olduğu için döndürülen hata mesajı. Parametre için geçerli bir değer belirtin.
400	InvalidDBInstanceConnType.Format	Specified DB instance conn type is not valid.	Örneğin ağ türü bu işlemi desteklemediği için döndürülen hata mesajı.
400	PreCheckInvalid	CreateDdrInstance PreCheck Is Invalid	CreateDdrInstance işlemi için ön denetim geçersiz olduğu için döndürülen hata mesajı.
400	IncorrectDBInstanceType	Current DB instance engine and type does not support operations.	İşlem, örneğin veritabanı altyapısı ve örnek türü için desteklenmediği için döndürülen hata mesajı.
400	InvalidRestoreType.Format	Specified restore type is not valid.	Belirtilen geri yükleme türü geçersiz olduğu için döndürülen hata mesajı. Geçerli bir geri yükleme türü belirtin.
400	NoBackupSetRegion	BackupSetRegion is absence.	Yedekleme bölgesi mevcut olmadığı için döndürülen hata mesajı.
400	NoBaksetName	BaksetName is absence.	Yedekleme setinin adı mevcut olmadığı için döndürülen hata mesajı.
400	NoSourceInstanceName	No SourceDBInstanceName.	Kaynak örneğin adı bulunamadığı için döndürülen hata mesajı.
400	NoAvailableDisasterRestoreBakset	No available disaster restore bakset.	Kullanılabilir yedekleme seti bulunamadığı için döndürülen hata mesajı.
400	InvalidBackupType.Format	Specified backup type is not valid.	Yedekleme türü geçersiz olduğu için döndürülen hata mesajı.
400	IncorrectEngineVersion	Current engine version does not support operations.	Bu işlem, örnekte çalışan veritabanı altyapısı sürümü için desteklenmediği için döndürülen hata mesajı.
400	DisasterRestoreRegionNotMatched	Disaster restore should be operated in the ddr region or source region.	Olağanüstü durum kurtarma işleminin kaynak veya hedef örneğin bölgesinde gerçekleştirilmesi gerektiği için döndürülen hata mesajı.
403	IncorrectBackupSetMethod	Current backup set method does not support operations.	Belirtilen yedekleme seti, tek tek veritabanlarını ve tabloları geri yüklemek için kullanılamadığı için döndürülen hata mesajı.
403	IncorrectBaksetVersion	Current bakset version does not support operations.	İşlem, yedekleme setinin sürümü için desteklenmediği için döndürülen hata mesajı.
403	CrossRegionUnsupportTDE	Cross-region disaster restore not support TDE bakset.	TDE tabanlı yedekleme seti, bir örneği başka bir bölgeye geri yüklemek için kullanılamadığı için döndürülen hata mesajı.
404	InvalidRegion.NotFound	Specified Region does not exist in the RDS	Bölge kimliği geçersiz olduğu için döndürülen hata mesajı.
404	InvalidClusterName.NotFound	The specified cluster name is not available.	Küme adı mevcut olmadığı için döndürülen hata mesajı. Küme adını kontrol edin ve tekrar deneyin.
404	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	Yeni örnek türü bulunamadığı veya artık satın alınamadığı için döndürülen hata mesajı. Kullanılabilir bir örnek türü seçin.
404	InvalidDBInstanceNetType.NotFound	Specified DB instance net type is not found.	Örneğin ağ türü geçersiz olduğu için döndürülen hata mesajı. Ağ türünü kontrol edin.
404	RestoreType.NotFound	RestoreType is not found.	Belirtilen geri yükleme yöntemi mevcut olmadığı için döndürülen hata mesajı.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	Belirtilen yedekleme seti mevcut olmadığı için döndürülen hata mesajı. Mevcut yedekleme setlerini kontrol etmeniz gerekir.

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