Verileri yeni bir örneğe geri yükleme - - Alibaba Cloud Dokümantasyon Merkezi

Bu işlemi çağırmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

Orijinal örnek Çalışıyor (Running) durumundadır.
Orijinal örnekte devam eden geçiş görevleri yoktur.
Zaman damgasına göre kurtarma özelliğini desteklemek için orijinal örnekte günlük yedekleme etkinleştirilmiştir.
Orijinal örneği yedek kümelerini kullanarak klonlamak istiyorsanız orijinal örnekte en az bir yedek kümesi bulunmalıdır.

Not

ApsaraDB RDS, bir RAM kullanıcısının kimlik bilgilerini kullanarak bir örneği klonlamanıza olanak tanır. RAM kullanıcısına örnek klonlamak için gereken izinlerin verildiğinden emin olun. Daha fazla bilgi için bkz.

RAM kullanarak ApsaraDB RDS izinlerini yönetme

.

Aşağıdaki bilgilere dikkat edin:

Yeni örnek; IP adresi izin listesi, SQL Explorer (SQL Audit), uyarı eşiği, yedekleme ve parametre ayarları açısından orijinal örnekle aynıdır.
Yeni örneğin hesap bilgileri ve verileri, orijinal örneğin geri yüklenmesi için kullanılan yedek dosya veya zaman damgasında belirtilen hesap bilgileri ve verilerle aynıdır.

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	Hayır	CloneDBInstance	Gerçekleştirmek istediğiniz işlem. Değeri CloneDBInstance olarak ayarlayın.
RegionId	String	Hayır	cn-hangzhou	Yeni örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
ZoneId	String	Hayır	cn-hangzhou-b	Birincil örneğin alan kimliği. En güncel alan listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz. Not Bu parametrenin varsayılan değeri, orijinal örneğin ait olduğu alanın kimliğidir.
DBInstanceClass	String	Hayır	mysql.n1.micro.1	Yeni örneğin örnek türü. Bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Not Bu parametrenin varsayılan değeri, birincil örneğin örnek türüdür.
DBInstanceStorage	Integer	Hayır	1000	Yeni örneğin depolama kapasitesi. Birim: GB. Depolama kapasitesi 5 GB'lık adımlarla artar. Daha fazla bilgi için bkz. Birincil ApsaraDB RDS örnek türleri. Not Bu parametrenin varsayılan değeri, birincil örneğin depolama kapasitesidir.
DbNames	String	Hayır	test1,test2	Veritabanının adı. Birden fazla veritabanı belirtirseniz bu parametrenin değeri şu biçimde olur: `Orijinal veritabanı adı 1,Orijinal veritabanı adı 2`.
PayType	String	Hayır	Postpaid	Yeni ö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ış.
InstanceNetworkType	String	Hayır	VPC	Yeni örneğin ağ türü. Geçerli değerler: VPC Classic Not Bu parametrenin varsayılan değeri, birincil örneğin ağ türüdür.
DBInstanceId	String	Hayır	rm-uf6wjk5xxxxxxxxxx	Örneğin kimliği.
BackupId	String	Hayır	902****	Yedek kümesinin kimliği. Yedek kümelerini sorgulamak için DescribeBackups işlemini çağırabilirsiniz. Not BackupId ve RestoreTime parametrelerinden en az birini belirtmeniz gerekir.
RestoreTime	String	Hayır	2011-06-11T16:00:00Z	Verileri geri yüklemek istediğiniz zaman damgası. Zaman damgası, belirtilen yedek saklama süresi içinde olmalıdır. Saati ISO 8601 standardında yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Saat UTC cinsinden olmalıdır. Not BackupId ve RestoreTime parametrelerinden en az birini belirtmeniz gerekir.
VPCId	String	Hayır	vpc-uf6f7l4fg90xxxxxxxxxx	Yeni örneğin ait olduğu sanal özel cloud (VPC) kimliği. Not VPC, belirtilen bölgeye ait olmalıdır.
VSwitchId	String	Hayır	vsw-uf6adz52c2pxxxxxxxxxx	vSwitch kimliği. vSwitch, ZoneId parametresi tarafından belirtilen alana ait olmalıdır. InstanceNetworkType parametresini VPC olarak ayarlarsanız bu parametreyi de belirtmeniz gerekir. ZoneSlaveId1 parametresini belirtirseniz bu parametre için iki vSwitch kimliği belirtmeli ve kimlikleri virgülle (,) ayırmalısınız.
PrivateIpAddress	String	Hayır	172.XX.XXX.69	Yeni örneğin dahili IP adresi. Bu adres, belirtilen vSwitch tarafından desteklenen CIDR bloğu içinde olmalıdır. Sistem, VPCId ve VSwitchId parametrelerinin değerlerine göre yeni örneğe otomatik olarak bir dahili IP adresi atar.
UsedTime	Integer	Hayır	1	Yeni örneğin abonelik süresi. 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 UsedTime parametresini belirtmeniz gerekir.
Period	String	Hayır	Year	Yeni örneğin faturalandırma döngüsünü hesaplamak için kullanılan birim. Geçerli değerler: Year Month Not PayType parametresini Prepaid olarak ayarlarsanız Period parametresini belirtmeniz gerekir.
Category	String	Hayır	HighAvailability	Yeni örneğin RDS sürümü. Geçerli değerler: Basic: RDS Basic Edition. HighAvailability: RDS High-availability Edition. AlwaysOn: SQL Server için RDS Cluster Edition. cluster: MySQL için RDS Cluster Edition. Finance: RDS Enterprise Edition. Bu sürüm yalnızca Çin sitesinde (aliyun.com) kullanılabilir. serverless_basic: RDS Serverless Basic Edition.
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ük kaydı ö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.
DBInstanceStorageType	String	Hayır	cloud_essd	Yeni örneğin depolama türü. Geçerli değerler: local_ssd: yerel SSD'ler cloud_ssd: standart SSD'ler cloud_essd: performans düzeyi 1 (PL1) geliştirilmiş SSD (ESSD) cloud_essd2: PL2 ESSD cloud_essd3: PL3 ESSD'ler
RestoreTable	String	Hayır	1	Belirttiğiniz veritabanlarının ve tabloların geri yüklenip yüklenmeyeceğini belirtir. 1 değeri, belirtilen veritabanlarını ve tabloları geri yüklemek istediğinizi gösterir. Belirtilen veritabanlarını veya tabloları geri yüklemek istemiyorsanız bu parametreyi belirtmeyin.
TableMeta	String	Hayır	[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]	Geri yüklemek istediğiniz veritabanları ve tablolar hakkındaki bilgiler. Söz dizimi: [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
DedicatedHostGroupId	String	Hayır	dhg-7a9xxxxxxxx	Yeni örneğin ait olduğu özel kümenin kimliği.
BackupType	String	Hayır	FullBackup	Yedekleme türü. Geçerli değerler: FullBackup IncrementalBackup
DeletionProtection	Boolean	Hayır	true	Yeni örnek için silme koruma ö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. Varsayılan değer: false.
AutoPause	Boolean	Hayır	true	Sunucusuz örnek için otomatik başlatma ve durdurma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Otomatik başlatma ve durdurma özelliği etkinleştirildikten sonra, örneğe 10 dakika içinde bağlantı kurulmazsa örnek askıya alınır. Örneğe bir bağlantı kurulduğunda örnek otomatik olarak devam ettirilir. Geçerli değerler: true: özelliği etkinleştirir. false: özelliği devre dışı bırakır. Bu varsayılan değerdir.
MaxCapacity	double	Hayır	8	Maksimum RDS Kapasite Birimi (RCU) sayısı.
MinCapacity	double	Hayır	0,5	Minimum RCU sayısı.
SwitchForce	Boolean	Hayır	false	Sunucusuz örnek için zorunlu ölçeklendirme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Çoğu durumda ApsaraDB RDS, iş gereksinimlerine göre sunucusuz bir örneğin RCU'larını gerçek zamanlı olarak otomatik şekilde ölçeklendirir. Nadiren ölçeklendirme işlemi gerçekleşmeyebilir. Örneğin RCU'larını zorunlu olarak içeri veya dışarı ölçeklendirmek için zorunlu ölçeklendirme özelliğini etkinleştirebilirsiniz. Geçerli değerler: true: özelliği etkinleştirir. false: özelliği devre dışı bırakır. Bu varsayılan değerdir.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
DBInstanceId	String	rm-uf6wjk5xxxxxxx	Örneğin kimliği.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	İsteğin kimliği.
OrderId	String	100789370****	Siparişin kimliği.

Örnekler

Örnek istekler

http(s)://rds.aliyuncs.com/?Action=CloneDBInstance
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&DBInstanceClass=mysql.n1.micro.1
&DBInstanceStorage=1000
&DbNames=test1,test2
&PayType=Postpaid
&InstanceNetworkType=VPC
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&BackupId=902****
&RestoreTime=2011-06-11T16:00:00Z
&VPCId=vpc-uf6f7l4fg90xxxxxxxxxx
&VSwitchId=vsw-uf6adz52c2pxxxxxxxxxx
&PrivateIpAddress=172.XX.XXX.69
&UsedTime=1
&Period=Year
&Category=HighAvailability
&ZoneIdSlave1=cn-hangzhou-c
&ZoneIdSlave2=cn-hangzhou-d
&DBInstanceStorageType=cloud_essd
&RestoreTable=1
&TableMeta=[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&BackupType=FullBackup
&DeletionProtection=true
&ServerlessConfig={"AutoPause":true,"MaxCapacity":8.0,"MinCapacity":0.5,"SwitchForce":false}
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<CloneDBInstanceResponse>
    <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
    <OrderId>100789370****</OrderId>
</CloneDBInstanceResponse>

JSON biçimi

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

{
  "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "OrderId" : "100789370****"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	InvalidAvZone.Format	Specified AvZone is not valid.	ZoneID parametresinin değeri geçersiz olduğundan hata döndürüldü.
400	InvalidAvZone.NotSupport	Specified availableArea multiZone does not support in RDS.	availableArea multiZone parametresi için belirtilen değer ApsaraDB RDS tarafından desteklenmediğinden hata döndürüldü.
400	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	Depolama türünün değiştirilmesine izin verilmediğinden hata döndürüldü. Standart SSD'lerle SQL Server çalıştıran bir örneğin depolama türü yalnızca ESSD'lere değiştirilebilir. Yerel SSD'lerle SQL Server çalıştıran bir örneğin depolama türü standart SSD'lere veya ESSD'lere değiştirilebilir.
400	CannotDecreaseEssdPerfLevel	invalid cloud essd storage size.	DBInstanceStorage parametresinin değeri geçersiz olduğundan hata döndürüldü.
400	InvalidIPAddress.Conflict	IP address conflict.	IP adresleri çakıştığından hata döndürüldü.
400	CDDC.AvailableHostsNotEnoughInZone	Not enough available hosts are in the target zone.	Belirtilen alanda kullanılabilir ana bilgisayar bulunmadığından hata döndürüldü. Alanda bir ana bilgisayar oluşturun ve tekrar deneyin.
400	InvalidInstanceLevel.DiskType	Specified instance level not support request disk type	Belirtilen örnek türü, belirtilen depolama türünü desteklemediğinden hata döndürüldü.
400	InvalidRecoveryDbInstance.StorageType	The disk local_ssd can not clone to cloud disk type	Yerel SSD'ler kullanan bir örneğin verileri, standart SSD'ler veya ESSD'ler kullanan bir örneğe geri yüklenemediğinden hata döndürüldü.
400	InvalidRecoveryDbInstance.StorageSize	The disk space of the new instance cannot be less than that of the current instance	Yeni örneğin kullanılabilir depolama alanı, orijinal örnekte depolanan toplam veri boyutuna eşit veya ondan büyük olması gerektiğinden hata döndürüldü.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	Geçerli küçük altyapı sürümü için bu işlem desteklenmediğinden hata döndürüldü.
403	IncorrectCharacterType	Current DB instance character type does not support this operation.	Geçerli örneğin karakter türü için bu işlem desteklenmediğinden hata döndürüldü.

Hata kodlarının listesi için bkz. Service error codes.