Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Mevcut bir uzun süreli saklama yedeklemesi Güncelleştirmeler.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?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.requestedBackupStorageRedundancy	BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü

Yanıtlar

Name	Tür	Description
200 OK	LongTermRetentionBackupOperationResult	Yedekleme başarıyla güncelleştirildi.
202 Accepted		Yedekleme güncelleştiriliyor.
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 kopyalama özelliği için iletişim kurmasına izin verilmiyor. 400 LongTermRetentionMigrationParameterMissing - İşlem için gerekli parametre eksik. 400 LongTermRetentionMigrationSameServerNotSupported - LTR Kopyalama özelliğinin aynı sunucu içindeki LTR yedeklemelerini kopyalaması 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 yedekleme yedekliliğiyle 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 yedek 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 - Kimlikli 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 - Aynı kaynakta başka bir işlem tarafından kesildiği için kaynak üzerindeki işlem tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Hedef bölgede LTR yedekleme kopyası 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 isteklerin ötesindeki istekler.

Örnekler

Update the long term retention backup.

Sample Request

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/update?api-version=2021-11-01

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            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

Sample Response

Status code:

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": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Status code:

202

Tanımlar

Name	Description
BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü
LongTermRetentionBackupOperationResult	LongTermRetentionBackup işlemi sonuç kaynağı.
UpdateLongTermRetentionBackupParameters	Uzun süreli saklama yedekleme güncelleştirme işlemini gerçekleştirmek için gereken bilgileri içerir.

BackupStorageRedundancy

Kopyalanan yedeklemenin depolama yedeklilik türü

Name	Tür	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

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

UpdateLongTermRetentionBackupParameters

Uzun süreli saklama yedekleme güncelleştirme işlemini gerçekleştirmek için gereken bilgileri içerir.

Name	Tür	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Kopyalanan yedeklemenin depolama yedeklilik türü