Long Term Retention Backups - Update By Resource Group

Memperbarui cadangan retensi jangka panjang yang ada.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?api-version=2021-08-01-preview

Parameter URI

Name In Required Type Description
backupName
path True
  • string

Nama cadangan.

locationName
path True
  • string

Lokasi database.

longTermRetentionDatabaseName
path True
  • string

Nama database

longTermRetentionServerName
path True
  • string

Nama server

resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Type Description
properties.requestedBackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin

Respons

Name Type Description
200 OK

Berhasil memperbarui cadangan.

202 Accepted

Memperbarui cadangan sedang berlangsung.

Other Status Codes

Respons Kesalahan: ***

  • 400 InvalidLongTermRetentionBackupId - Pengidentifikasi cadangan retensi jangka panjang tidak valid untuk SQL DB.

  • 400 InvalidParameterValue - Nilai yang tidak valid diberikan ke parameter.

  • 400 LongTermRetentionMismatchingSubscriptionId - Id langganan yang disediakan tidak cocok dengan id di input lain

  • 400 LongTermRetentionMismatchingResourceGroupName - Nama grup sumber daya yang disediakan tidak cocok dengan nama di input lain

  • 400 LongTermRetentionMismatchingServerName - Nama server yang disediakan tidak cocok dengan nama di input lain

  • 400 LongTermRetentionMigrationRequestNotSupported - Langganan tidak diizinkan fitur Migrasi cadangan LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Langganan sumber dan target tidak diizinkan untuk berkomunikasi untuk fitur salinan cadangan LTR.

  • 400 LongTermRetentionMigrationParameterMissing - Parameter yang diperlukan hilang untuk operasi.

  • Fitur 400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy tidak didukung untuk menyalin cadangan LTR dalam server yang sama.

  • 400 LongTermRetentionMigrationTargetServerNotFound - Server target tidak ada atau tidak siap untuk operasi salinan cadangan LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - Database Target tidak ada di server.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - Backup Storage Redundancy yang ditentukan tidak didukung di wilayah target.

  • 400 LongTermRetentionMigrationStorageMismatch - Redundansi cadangan database aktif tidak cocok dengan redundansi cadangan yang diminta oleh pelanggan.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - Migrasi LTR hanya didukung untuk instans terkelola dan Azure SQL cadangan DB LTR.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - Mengubah redundansi penyimpanan cadangan tidak diizinkan untuk operasi Salinan LTR.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - Langganan tidak dapat ditemukan.

  • 404 SubscriptionDoesNotHaveServer - Server yang diminta tidak ditemukan

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 404 ResourceNotFound - Sumber daya yang diminta tidak ditemukan.

  • 404 LongTermRetentionMigrationBackupNotFound - Pencadangan LTR yang ditentukan tidak ada.

  • 409 LongTermRetentionMigrationRequestConflict - Operasi konflik pada pencadangan LTR ini masih berlangsung.

  • 409 LongTermRetentionMigrationBackupConflict - Pencadangan LTR lain dengan waktu pencadangan yang sama untuk database target ada.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Gagal memulai permintaan salinan cadangan LTR di wilayah target.

  • 500 LongTermRetentionMigrationRequestCopyFailed - Operasi salin gagal untuk blob cadangan LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - Verifikasi pemulihan gagal setelah upaya maksimal tercapai.

  • 500 LongTermRetentionMigrationRestoreVerFailed - Verifikasi pemulihan gagal.

Contoh

Update the long term retention backup.

Sample Request

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-08-01-preview

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

Sample Response

{
  "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"
  }
}

Definisi

BackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin

LongTermRetentionBackupOperationResult

Sumber daya hasil operasi LongTermRetentionBackup.

UpdateLongTermRetentionBackupParameters

Berisi informasi yang diperlukan untuk melakukan operasi pembaruan cadangan retensi jangka panjang.

BackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

Sumber daya hasil operasi LongTermRetentionBackup.

Name Type Description
id
  • string

ID Sumber Daya.

name
  • string

Nama sumber daya.

properties.fromBackupResourceId
  • string

Id sumber daya cadangan sumber

properties.message
  • string

Pesan kemajuan

properties.operationType
  • string

Jenis operasi.

properties.requestId
  • string

Id Permintaan.

properties.status
  • string

Status operasi

properties.targetBackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin

properties.toBackupResourceId
  • string

Id sumber daya cadangan target

type
  • string

Jenis sumber daya

UpdateLongTermRetentionBackupParameters

Berisi informasi yang diperlukan untuk melakukan operasi pembaruan cadangan retensi jangka panjang.

Name Type Description
properties.requestedBackupStorageRedundancy

Jenis redundansi penyimpanan dari cadangan yang disalin