Bir örneğin yedekleme ayarlarını değiştirmek için ModifyBackupPolicy işlemini çağırabilirsiniz.
Bu işlemi çağırmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:
Örnek, salt okunur bir örnek değildir.
Örnek Çalışıyor durumundadır.
Hata ayıklama
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
| Action | String | Evet | ModifyBackupPolicy | Gerçekleştirmek istediğiniz işlem. Değeri ModifyBackupPolicy olarak ayarlayın. |
| DBInstanceId | String | Evet | rm-uf6wjk5xxxxxxx | Örneğin ID'si. Örneklerin ID'lerini sorgulamak için DescribeDBInstances işlemini çağırabilirsiniz. |
| BackupPolicyMode | String | Hayır | DataBackupPolicy | Gerçekleştirmek istediğiniz yedeklemenin türü. Geçerli değerler:
|
| PreferredBackupTime | String | Hayır | 00:00Z-01:00Z | Yedekleme gerçekleştirmek istediğiniz saat. Saati ISO 8601 standardında HH:mmZ-HH:mmZ biçiminde belirtin. Saat UTC cinsinden olmalıdır. Not
|
| PreferredBackupPeriod | String | Hayır | Monday | Yedekleme döngüsü. Haftanın en az iki gününü virgül (,) ile ayırarak belirtin. Geçerli değerler:
Not
|
| BackupRetentionPeriod | String | Hayır | 7 | Veri yedekleme dosyalarını saklamak istediğiniz gün sayısı. Geçerli değerler: 7 ile 730. Not
|
| BackupLog | String | Hayır | Enable | Günlük yedekleme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
Not
|
| LogBackupRetentionPeriod | String | Hayır | 7 | Günlük yedekleme dosyalarını saklamak istediğiniz gün sayısı. Geçerli değerler: 7 ile 730. Günlük yedekleme saklama süresi, veri yedekleme saklama süresinden uzun olamaz. Not
|
| EnableBackupLog | String | Hayır | 1 | Günlük yedekleme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
Not
|
| LocalLogRetentionHours | String | Hayır | 18 | Günlük yedekleme dosyalarını örnek üzerinde saklamak istediğiniz saat sayısı. Geçerli değerler: 0 ile 168. 0 değeri, günlük yedekleme dosyalarının örnek üzerinde saklanmadığını belirtir. 168 değeri şu formüle göre hesaplanır: 7 × 24. Not
|
| LocalLogRetentionSpace | String | Hayır | 30 | Örnek üzerindeki günlük yedekleme dosyaları için izin verilen maksimum depolama kullanımı. Örnek üzerindeki günlük yedekleme dosyalarının depolama kullanımı bu parametrenin değerini aşarsa ApsaraDB RDS, depolama kullanımı bu parametrenin değerinin altına düşene kadar daha eski günlük yedekleme dosyalarını siler. Geçerli değerler:0 ile 50. Varsayılan değeri koruyabilirsiniz. Not
|
| HighSpaceUsageProtection | String | Hayır | Enable | Örneğin depolama kullanımı %80'i aştığında veya örnekteki kalan depolama alanı 5 GB'tan az olduğunda ApsaraDB RDS'nin günlük yedekleme dosyalarını örnekten zorla silip silmeyeceğini belirtir. Geçerli değerler: Enable ve Disable. Varsayılan değeri koruyabilirsiniz. Not
|
| LogBackupFrequency | String | Hayır | LogInterval | Örneğin günlüklerini yedeklemek istediğiniz sıklık. Geçerli değerler:
Not
|
| CompressType | String | Hayır | 4 | Yedeklemelerin sıkıştırıldığı biçim. Geçerli değerler:
Not Bu parametre yalnızca BackupPolicyMode parametresi DataBackupPolicy olarak ayarlandığında etkili olur. |
| ArchiveBackupRetentionPeriod | String | Hayır | 365 | Arşivlenmiş yedekleme dosyalarını saklamak istediğiniz gün sayısı. Varsayılan değer 0, yedek arşivleme özelliğinin etkin olmadığını belirtir. Geçerli değerler: 30 ile 1095. Not Bu parametre yalnızca BackupPolicyMode parametresi DataBackupPolicy olarak ayarlandığında etkili olur. |
| ArchiveBackupKeepPolicy | String | Hayır | ByMonth | Arşivlenmiş yedekleme dosyalarını saklamak istediğiniz zaman aralığı. Belirtilen saklama süresi içinde saklanabilecek arşivlenmiş yedekleme dosyası sayısı ArchiveBackupKeepCount parametresi tarafından belirtilir. Varsayılan değer: 0. Geçerli değerler:
Not Bu parametre yalnızca BackupPolicyMode parametresi DataBackupPolicy olarak ayarlandığında etkili olur. |
| ArchiveBackupKeepCount | Integer | Hayır | 1 | Saklamak istediğiniz arşivlenmiş yedekleme dosyası sayısı. Varsayılan değer: 1. Geçerli değerler:
Not
|
| ReleasedKeepPolicy | String | Hayır | None | Örnek bırakıldığında ApsaraDB RDS'nin arşivlenmiş yedekleme dosyalarını saklama ilkesi. Varsayılan değer: None. Geçerli değerler:
Not Bu parametre yalnızca BackupPolicyMode parametresi DataBackupPolicy olarak ayarlandığında etkili olur. |
| LogBackupLocalRetentionNumber | Integer | Hayır | 60 | Örnek üzerinde saklamak istediğiniz ikili günlük dosyası sayısı. Varsayılan değer: 60. Geçerli değerler: 6 ile 100. Not
|
| Category | String | Hayır | Standard | Tek haneli saniye yedekleme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu özellik, ApsaraDB RDS'nin birkaç saniye içinde yedeklemeyi tamamlamasına olanak tanır. Geçerli değerler:
Not Bu parametre yalnızca BackupPolicyMode parametresi DataBackupPolicy olarak ayarlandığında etkili olur. |
| BackupInterval | String | Hayır | 30 | Örnek üzerinde anlık görüntü yedeklemesi gerçekleştirmek istediğiniz sıklık. Geçerli değerler:
Not
|
| BackupMethod | String | Hayır | Physical | Örneğin yedekleme yöntemi. Geçerli değerler:
Varsayılan değer: Physical. Not
|
| EnableIncrementDataBackup | Boolean | Hayır | false | Artımlı yedekleme özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
Not
|
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| RequestId | String | DA147739-AEAD-4417-9089-65E9B1D8240D | İsteğin ID'si. |
| CompressType | String | 4 | Yedeklemelerin sıkıştırıldığı biçim. Geçerli değerler:
|
| LocalLogRetentionSpace | String | 30 | Örnek üzerindeki günlük yedekleme dosyaları için izin verilen maksimum depolama kullanımı. |
| LogBackupLocalRetentionNumber | Integer | 60 | Örnek üzerinde saklanan ikili günlük dosyası sayısı. |
| DBInstanceID | String | rm-uf6wjk5xxxxxxx | Örneğin ID'si. |
| EnableBackupLog | String | 1 | Günlük yedekleme özelliğinin etkin olup olmadığını gösterir. Geçerli değerler:
|
| LocalLogRetentionHours | Integer | 18 | Günlük yedekleme dosyalarının örnek üzerinde saklandığı saat sayısı. |
| HighSpaceUsageProtection | String | Disable | Örneğin depolama kullanımı %80'i aştığında veya örnekteki kalan depolama alanı 5 GB'tan az olduğunda ApsaraDB RDS'nin günlük yedekleme dosyalarını örnekten zorla silip silmediğini gösterir. |
Örnekler
Örnek istekler
http(s)://rds.aliyuncs.com/?Action=ModifyBackupPolicy
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyBackupPolicyResponse>
<HighSpaceUsageProtection>Disable</HighSpaceUsageProtection>
<DBInstanceID>rm-bp1z3xxxxx</DBInstanceID>
<RequestId>E4BF5598-ED12-4406-AAA4-F375428BE741</RequestId>
<LocalLogRetentionHours>18</LocalLogRetentionHours>
<EnableBackupLog>1</EnableBackupLog>
<LocalLogRetentionSpace>30</LocalLogRetentionSpace>
<LogBackupLocalRetentionNumber>60</LogBackupLocalRetentionNumber>
</ModifyBackupPolicyResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"HighSpaceUsageProtection" : "Disable",
"DBInstanceID" : "rm-bp1z3xxxxx",
"RequestId" : "E4BF5598-ED12-4406-AAA4-F375428BE741",
"LocalLogRetentionHours" : "18",
"EnableBackupLog" : "1",
"LocalLogRetentionSpace" : "30",
"LogBackupLocalRetentionNumber" : 60
}
Hata kodları
|
HTTP durum kodu |
Hata kodu |
Hata mesajı |
Açıklama |
|
400 |
InvalidLogBackupFrequency.Malformed |
Invalid log backup frequency. |
LogBackupFrequency parametresinin değeri geçersiz olduğu için dönen hata mesajı. Parametre ayarının doğru olup olmadığını kontrol edin. |
|
400 |
InvalidBackupRetentionPeriod.Malformed |
The specified backup retention period is invalid. |
Yedekleme saklama süresi belirtilmediği için dönen hata mesajı. Bir yedekleme saklama süresi belirtin. Yedekleme saklama süresi 1 günden kısa veya 30 günden uzun olamaz. |
|
400 |
BackupPropertyNotFound |
Backup policy not found |
Yedekleme ilkeleri bulunamadığı için dönen hata mesajı. |
|
400 |
OperationDenied.SwitchToSnapshot |
Snapshot backup does not support cross region storage at present. Please turn off cross region backup before switching to snapshot backup mode. |
Anlık görüntü yedekleme dosyaları, örneğin bulunduğu bölgeden farklı bir bölgede saklanamadığı için dönen hata mesajı. Anlık görüntü yedekleme özelliğini etkinleştirmeden önce bölgeler arası yedekleme özelliğini devre dışı bırakmanız gerekir. |
|
403 |
IncorrectCategory |
Current Instance type does not support Category. |
Category parametresi geçerli örnek türü tarafından desteklenmediği için dönen hata mesajı. |
|
403 |
OperationDenied.SwitchSnapshotToPhysical |
Only physical backup to snapshot backup is supported. |
İşlem yalnızca fiziksel yedekleme yönteminden anlık görüntü yedekleme yöntemine geçişi desteklediği için dönen hata mesajı. |
|
403 |
OperationDenied.ModifyBackupSwitchOff |
The switch is not turned on. It is forbidden to modify the backup mode. |
Bölgeler arası yedekleme özelliği etkin olmadığı için dönen hata mesajı. |
|
403 |
OperationDenied.ApiForbiddenForLogBackupFrequency |
When the instance is a snapshot backup, the log backup frequency is not allowed to be consistent with the data backup. |
Anlık görüntü yedekleme özelliği etkinleştirildiğinde günlük yedekleme sıklığının veri yedekleme sıklığı ile aynı olamayacağı için dönen hata mesajı. |
|
403 |
OperationDenied.NotSupportedBackupMethod |
When the storage is larger than 4000 GB, only snapshot backup is supported. |
Depolama alanı 4.000 GB'tan büyük olduğunda örnek yalnızca anlık görüntü yedeklemelerini desteklediği için dönen hata mesajı. |
|
403 |
OperationDenied.ApiForbidden |
Operation is not permitted. |
İşleme izin verilmediği için dönen hata mesajı. |
Hata kodlarının listesi için API Error Center adresini ziyaret edin.