Long Term Retention Backups - Copy

Hizmet:: SQL Database

API Sürümü:: 2025-01-01

Mevcut bir uzun süreli saklama yedeğini kopyalayın.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?api-version=2025-01-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
backupName	path	True	string	Yedekleme adı.
locationName	path	True	string	Veritabanının konumu.
longTermRetentionDatabaseName	path	True	string	Veritabanının adı
longTermRetentionServerName	path	True	string	Sunucunun adı
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü
properties.targetDatabaseName	string	Kopyalanan yedeğin sahibi veritabanının adıdır.
properties.targetResourceGroup	string	Hedef sunucunun sahibi olan kaynak grubu
properties.targetServerFullyQualifiedDomainName	string	Hedef sunucunun tam etki alanı adı
properties.targetServerResourceId	string	Veritabanının sahibi olan hedef sunucunun kaynak kimliği
properties.targetSubscriptionId	string	Hedef sunucunun sahibi olan abonelik

Yanıtlar

Name	Tür	Description
200 OK	LongTermRetentionBackupOperationResult	Yedekleme başarıyla kopyalandı.
202 Accepted		Yedekleme kopyalama işlemi devam ediyor. Üst Bilgiler Location: string
Other Status Codes	ErrorResponse	Hata Yanıtları: *** 400 ManagedInstanceStoppingOrStopped - Örnek durdurulmuş/durdurulmuş durumdayken gönderilen çakışan işlem 400 ManagedInstanceStarting - Örnek başlatma durumundayken gönderilen çakışan işlem 400 InvalidLongTermRetentionBackupId - SQL DB'leri için geçersiz uzun süreli saklama yedekleme tanımlayıcısı. 400 InvalidParameterValue - Parametreye geçersiz bir değer verildi. 400 LongTermRetentionMismatchingSubscriptionId - Sağlanan abonelik kimliği diğer girişteki kimlikle eşleşmedi 400 LongTermRetentionMismatchingResourceGroupName - Sağlanan kaynak grubu adı diğer girişteki adla eşleşmedi 400 LongTermRetentionMismatchingServerName - Sağlanan sunucu adı diğer girişteki adla eşleşmedi 400 DeleteLtrSubscriptionMissing - Uzun süreli saklama yedeğini silmek için abonelik kimliği gereklidir. 400 DeleteLtrServerMissing - Uzun süreli saklama yedeğini silmek için sunucu adı gereklidir. 400 DeleteLtrDatabaseMissing - Veritabanı adı uzun süreli saklama yedeğini silmek için gereklidir. 400 LtrBackupResourceIdIncorrect - Sağlanan uzun süreli saklama yedekleme kaynağı kimliği veya yedekleme adı yanlış. 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - Alanlar arası yedekli yedekleme depolama alanında uzun süreli saklama yedeklemelerinin arşivlenmesi desteklenmez. Bunun yerine yerel olarak yedekli veya coğrafi olarak yedekli depolama türlerini kullanın. 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing - Uzun süreli saklama yedeklemesini güncelleştirmek için abonelik kimliği gereklidir. 400 UpdateBackupStorageAccessTierLtrServerMissing - Uzun süreli saklama yedeklemesini güncelleştirmek için sunucu adı gereklidir. 400 UpdateBackupStorageAccessTierLtrDatabaseMissing - Veritabanı adı, uzun süreli saklama yedeklemesini güncelleştirmek için gereklidir. 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect - Sağlanan uzun süreli saklama yedekleme kaynağı kimliği veya yedekleme adı yanlış. 400 LTRBackupNotExists - Yedekleme mevcut olmadığından işlem tamamlanamadı. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR Kopyalama işlemleri için yedekleme depolama yedekliliğini değiştirmeye izin verilmez. 400 LtrRestoreFailedArchiveStorageTier - Arşivlenmiş uzun süreli saklama yedeğinin geri yüklenmesi desteklenmez. Geri yükleme yalnızca yeniden doldurulan veya düzenli uzun süreli saklama yedeklemelerinde gerçekleştirilebilir. 400 LtrArchiveStorageTierNotEnabled - Uzun süreli saklama yedeklemelerinin arşivlenmesi etkinleştirilmedi. 400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier istenen (backupStorageAccessTier, operationMode) bileşimi için desteklenmiyor. Yalnızca (Arşivle, Taşı) ve (Sık Erişimli, Kopyala) izin verilir. 400 LTRArchiveRedundancyChangeFailed - Yedekleme depolama yedeklilik türünün alanlar arası yedekli depolamaya güncelleştirilmesi, 'arşiv' yedekleme depolama erişim katmanına sahip uzun süreli bir saklama ilkesi ayarlandığında desteklenmez 400 LongTermRetentionMigrationSubscriptionNotFound - Abonelik bulunamadı. 400 LtrOperationFailedBackupImmutable - Yedekleme sabit olduğundan Uzun Süreli Saklama yedeklemesi silinemedi. 400 DeleteLtrBackupWithLegalHold - Yedekleme, üzerinde yasal bir saklama olduğundan silinemez. Yasal saklamayı kaldırın ve yeniden deneyin. 400 LTRBackupImmutableNotSet - Yedekleme değişmezlik için yapılandırılmadığından işlem tamamlanamadı. 400 LTRBackupImmutabilityLocked - Yedekleme sabit ve kilitli olduğundan işlem tamamlanamadı. 400 LongTermRetentionMigrationRequestNotSupported - Aboneliğe izin verilmiyor LTR yedekleme Geçişi özelliği. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - KAYNAK ve hedef aboneliklerin LTR yedekleme kopyası özelliği için iletişim kurmasına izin verilmiyor. 400 LongTermRetentionMigrationParameterMissing - İşlem için gerekli parametre eksik. 400 LongTermRetentionMigrationSameServerNotSupported - LTR Kopyalama özelliği aynı sunucu içindeki LTR yedeklemelerini kopyalamak için desteklenmez. 400 LongTermRetentionMigrationTargetServerNotFound - Hedef sunucu yok veya LTR yedekleme kopyalama işlemi için hazır değil. 400 LongTermRetentionMigrationTargetDatabaseNotFound - Hedef Veritabanı sunucuda yok. 400 LongTermRetentionMigrationStorageTypeNotSupported - Belirtilen Yedekleme Depolama Yedekliliği hedef bölgede desteklenmiyor. 400 LongTermRetentionMigrationStorageMismatch - Veritabanının etkin yedekleme yedekliliği müşteri tarafından istenen yedeklilik ile eşleşmiyor. 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR geçişi yalnızca yönetilen örnek ve Azure SQL DB LTR yedeklemeleri için desteklenir. 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ResourceNotFound - İstenen kaynak bulunamadı. 404 LongTermRetentionMigrationBackupNotFound - Belirtilen LTR yedeklemesi yok. 404 OperationIdNotFound - Kimliği olan işlem yok. 409 LongTermRetentionMigrationRequestConflict - Bu LTR yedeklemesinde çakışma işlemi devam ediyor. 409 LongTermRetentionMigrationBackupConflict - Hedef veritabanı için aynı yedekleme süresine sahip başka bir LTR yedeklemesi var. 409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 500 LongTermRetentionMigrationRequestCopyFailed - LTR yedekleme blobları için kopyalama işlemi başarısız oldu. 500 LongTermRetentionMigrationRestoreVerExceeded - En fazla denemeye ulaşıldıktan sonra geri yükleme doğrulaması başarısız oldu. 500 LongTermRetentionMigrationRestoreVerFailed - Geri yükleme doğrulaması başarısız oldu. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Hedef bölgede LTR yedekleme kopyalama isteği başlatılamadı. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Name

Tür

Description

200 OK

LongTermRetentionBackupOperationResult

Yedekleme başarıyla kopyalandı.

202 Accepted

Yedekleme kopyalama işlemi devam ediyor.

Üst Bilgiler

Location: string

Other Status Codes

ErrorResponse

Hata Yanıtları: ***

400 ManagedInstanceStoppingOrStopped - Örnek durdurulmuş/durdurulmuş durumdayken gönderilen çakışan işlem
400 ManagedInstanceStarting - Örnek başlatma durumundayken gönderilen çakışan işlem
400 InvalidLongTermRetentionBackupId - SQL DB'leri için geçersiz uzun süreli saklama yedekleme tanımlayıcısı.
400 InvalidParameterValue - Parametreye geçersiz bir değer verildi.
400 LongTermRetentionMismatchingSubscriptionId - Sağlanan abonelik kimliği diğer girişteki kimlikle eşleşmedi
400 LongTermRetentionMismatchingResourceGroupName - Sağlanan kaynak grubu adı diğer girişteki adla eşleşmedi
400 LongTermRetentionMismatchingServerName - Sağlanan sunucu adı diğer girişteki adla eşleşmedi
400 DeleteLtrSubscriptionMissing - Uzun süreli saklama yedeğini silmek için abonelik kimliği gereklidir.
400 DeleteLtrServerMissing - Uzun süreli saklama yedeğini silmek için sunucu adı gereklidir.
400 DeleteLtrDatabaseMissing - Veritabanı adı uzun süreli saklama yedeğini silmek için gereklidir.
400 LtrBackupResourceIdIncorrect - Sağlanan uzun süreli saklama yedekleme kaynağı kimliği veya yedekleme adı yanlış.
400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - Alanlar arası yedekli yedekleme depolama alanında uzun süreli saklama yedeklemelerinin arşivlenmesi desteklenmez. Bunun yerine yerel olarak yedekli veya coğrafi olarak yedekli depolama türlerini kullanın.
400 UpdateBackupStorageAccessTierLtrSubscriptionMissing - Uzun süreli saklama yedeklemesini güncelleştirmek için abonelik kimliği gereklidir.
400 UpdateBackupStorageAccessTierLtrServerMissing - Uzun süreli saklama yedeklemesini güncelleştirmek için sunucu adı gereklidir.
400 UpdateBackupStorageAccessTierLtrDatabaseMissing - Veritabanı adı, uzun süreli saklama yedeklemesini güncelleştirmek için gereklidir.
400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect - Sağlanan uzun süreli saklama yedekleme kaynağı kimliği veya yedekleme adı yanlış.
400 LTRBackupNotExists - Yedekleme mevcut olmadığından işlem tamamlanamadı.
400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR Kopyalama işlemleri için yedekleme depolama yedekliliğini değiştirmeye izin verilmez.
400 LtrRestoreFailedArchiveStorageTier - Arşivlenmiş uzun süreli saklama yedeğinin geri yüklenmesi desteklenmez. Geri yükleme yalnızca yeniden doldurulan veya düzenli uzun süreli saklama yedeklemelerinde gerçekleştirilebilir.
400 LtrArchiveStorageTierNotEnabled - Uzun süreli saklama yedeklemelerinin arşivlenmesi etkinleştirilmedi.
400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier istenen (backupStorageAccessTier, operationMode) bileşimi için desteklenmiyor. Yalnızca (Arşivle, Taşı) ve (Sık Erişimli, Kopyala) izin verilir.
400 LTRArchiveRedundancyChangeFailed - Yedekleme depolama yedeklilik türünün alanlar arası yedekli depolamaya güncelleştirilmesi, 'arşiv' yedekleme depolama erişim katmanına sahip uzun süreli bir saklama ilkesi ayarlandığında desteklenmez
400 LongTermRetentionMigrationSubscriptionNotFound - Abonelik bulunamadı.
400 LtrOperationFailedBackupImmutable - Yedekleme sabit olduğundan Uzun Süreli Saklama yedeklemesi silinemedi.
400 DeleteLtrBackupWithLegalHold - Yedekleme, üzerinde yasal bir saklama olduğundan silinemez. Yasal saklamayı kaldırın ve yeniden deneyin.
400 LTRBackupImmutableNotSet - Yedekleme değişmezlik için yapılandırılmadığından işlem tamamlanamadı.
400 LTRBackupImmutabilityLocked - Yedekleme sabit ve kilitli olduğundan işlem tamamlanamadı.
400 LongTermRetentionMigrationRequestNotSupported - Aboneliğe izin verilmiyor LTR yedekleme Geçişi özelliği.
400 LongTermRetentionMigrationCrossClusterRequestNotSupported - KAYNAK ve hedef aboneliklerin LTR yedekleme kopyası özelliği için iletişim kurmasına izin verilmiyor.
400 LongTermRetentionMigrationParameterMissing - İşlem için gerekli parametre eksik.
400 LongTermRetentionMigrationSameServerNotSupported - LTR Kopyalama özelliği aynı sunucu içindeki LTR yedeklemelerini kopyalamak için desteklenmez.
400 LongTermRetentionMigrationTargetServerNotFound - Hedef sunucu yok veya LTR yedekleme kopyalama işlemi için hazır değil.
400 LongTermRetentionMigrationTargetDatabaseNotFound - Hedef Veritabanı sunucuda yok.
400 LongTermRetentionMigrationStorageTypeNotSupported - Belirtilen Yedekleme Depolama Yedekliliği hedef bölgede desteklenmiyor.
400 LongTermRetentionMigrationStorageMismatch - Veritabanının etkin yedekleme yedekliliği müşteri tarafından istenen yedeklilik ile eşleşmiyor.
400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR geçişi yalnızca yönetilen örnek ve Azure SQL DB LTR yedeklemeleri için desteklenir.
404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.
404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı
404 ResourceNotFound - İstenen kaynak bulunamadı.
404 LongTermRetentionMigrationBackupNotFound - Belirtilen LTR yedeklemesi yok.
404 OperationIdNotFound - Kimliği olan işlem yok.
409 LongTermRetentionMigrationRequestConflict - Bu LTR yedeklemesinde çakışma işlemi devam ediyor.
409 LongTermRetentionMigrationBackupConflict - Hedef veritabanı için aynı yedekleme süresine sahip başka bir LTR yedeklemesi var.
409 CannotCancelOperation - Yönetim işlemi iptal edilemeyen bir durumda.
409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi.
409 İşlem Kesildi - Kaynak üzerindeki işlem, aynı kaynak üzerindeki başka bir işlem tarafından kesildiği için tamamlanamadı.
429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.
429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.
500 LongTermRetentionMigrationRequestCopyFailed - LTR yedekleme blobları için kopyalama işlemi başarısız oldu.
500 LongTermRetentionMigrationRestoreVerExceeded - En fazla denemeye ulaşıldıktan sonra geri yükleme doğrulaması başarısız oldu.
500 LongTermRetentionMigrationRestoreVerFailed - Geri yükleme doğrulaması başarısız oldu.
500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Hedef bölgede LTR yedekleme kopyalama isteği başlatılamadı.
500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin.
503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

Copy the long term retention backup.

Örnek isteği

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/copy?api-version=2025-01-01

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "CopyBackup",
    "status": "Succeeded",
    "toBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver2/longterRetentionDatabases/testDatabase2/longTermRetentionBackups/55555555-6666-7777-8888-111111111111;131637960820000000",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Durum kodu:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706?api-version=2021-05-01

Tanımlar

Name	Description
BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü
CopyLongTermRetentionBackupParameters	Uzun süreli saklama yedekleme kopyalama işlemi gerçekleştirmek için gerekli bilgileri içerir.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
LongTermRetentionBackupOperationResult	LongTermRetentionBackup işlemi sonuç kaynağı.

BackupStorageRedundancy

Numaralandırma

Kopyalanan yedeklemenin depolama yedeklilik türü

Değer	Description
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

Nesne

Uzun süreli saklama yedekleme kopyalama işlemi gerçekleştirmek için gerekli bilgileri içerir.

Name	Tür	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü
properties.targetDatabaseName	string	Kopyalanan yedeğin sahibi veritabanının adıdır.
properties.targetResourceGroup	string	Hedef sunucunun sahibi olan kaynak grubu
properties.targetServerFullyQualifiedDomainName	string	Hedef sunucunun tam etki alanı adı
properties.targetServerResourceId	string	Veritabanının sahibi olan hedef sunucunun kaynak kimliği
properties.targetSubscriptionId	string	Hedef sunucunun sahibi olan abonelik

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

LongTermRetentionBackupOperationResult

Nesne

LongTermRetentionBackup işlemi sonuç kaynağı.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.fromBackupResourceId	string	Kaynak yedekleme kaynak kimliği
properties.message	string	İlerleme iletisi
properties.operationType	string	İşlem türü.
properties.requestId	string (uuid)	İstek Kimliği.
properties.status	string	İşlem durumu
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü
properties.toBackupResourceId	string	Hedef yedekleme kaynak kimliği
type	string	Kaynak türü.

Aracılığıyla paylaş

Long Term Retention Backups - Copy

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Copy the long term retention backup.

Örnek isteği

Örnek yanıt

Tanımlar

BackupStorageRedundancy

CopyLongTermRetentionBackupParameters

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

LongTermRetentionBackupOperationResult