Long Term Retention Backups - Copy By Resource Group

Hizmet:

SQL Database

API Sürümü:

2021-11-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?api-version=2021-11-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ı
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
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.
Other Status Codes		Hata Yanıtları: *** 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 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. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR Kopyalama işlemleri için yedekleme depolama yedekliliğini değiştirmeye izin verilmez. 400 LongTermRetentionMigrationSubscriptionNotFound - Abonelik bulunamadı. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 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 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 LongTermRetentionMigrationRequestFailedToStartOnTarget - Hedef bölgede LTR yedekleme kopyalama isteği başlatılamadı. 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 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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/copy?api-version=2021-11-01

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

Java

import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.CopyLongTermRetentionBackupParameters;

/**
 * Samples for LongTermRetentionBackups CopyByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupCopy.json
     */
    /**
     * Sample code: Copy the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void copyTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().copyByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000",
            new CopyLongTermRetentionBackupParameters().withTargetServerResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2")
                .withTargetDatabaseName("testDatabase2").withTargetBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Örnek yanıt

Durum kodu:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/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

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.
LongTermRetentionBackupOperationResult	LongTermRetentionBackup işlemi sonuç kaynağı.

BackupStorageRedundancy

Listeleme

Kopyalanan yedeklemenin depolama yedeklilik türü

Değer	Description
Geo
GeoZone
Local
Zone

CopyLongTermRetentionBackupParameters

Object

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

LongTermRetentionBackupOperationResult

Object

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ü.