Long Term Retention Backups - Update By Resource Group

既存の長期保有バックアップを更新します。

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

URI パラメーター

Name In Required Type Description
backupName
path True
  • string

バックアップ名。

locationName
path True
  • string

データベースの場所。

longTermRetentionDatabaseName
path True
  • string

データベースの名前

longTermRetentionServerName
path True
  • string

サーバーの名前

resourceGroupName
path True
  • string

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。

subscriptionId
path True
  • string

Azure サブスクリプションを識別するサブスクリプション ID。

api-version
query True
  • string

要求で使用する API のバージョン。

要求本文

Name Type Description
properties.requestedBackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

応答

Name Type Description
200 OK

バックアップが正常に更新されました。

202 Accepted

バックアップの更新が進行中です。

Other Status Codes

エラー応答: ***

  • 400 InvalidLongTermRetentionBackupId - 無効な長期保有期間のバックアップ識別子が、SQLされます。

  • 400 InvalidParameterValue - パラメーターに無効な値が指定された。

  • 400 LongTermRetentionMismatchingSubscriptionId - 指定されたサブスクリプション ID が他の入力の ID と一致しなかった

  • 400 LongTermRetentionMismatchingResourceGroupName - 指定されたリソース グループ名が他の入力の名前と一致しなかった

  • 400 LongTermRetentionMismatchingServerName - 指定されたサーバー名が他の入力の名前と一致しなかった

  • 400 LongTermRetentionMigrationRequestNotSupported - サブスクリプションには LTR バックアップ移行機能が許可されません。

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - ソースサブスクリプションとターゲット サブスクリプションは、LTR バックアップ コピー機能の通信を許可されません。

  • 400 LongTermRetentionMigrationParameterMissing - 操作に必要なパラメーターがありません。

  • 400 LongTermRetentionMigrationSameServerNotSupported - LTR コピー機能は、同じサーバー内で LTR バックアップをコピーするためにサポートされていません。

  • 400 LongTermRetentionMigrationTargetServerNotFound - ターゲット サーバーが存在しないか、LTR バックアップ コピー操作の準備ができていません。

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - ターゲット データベースがサーバーに存在しません。

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - 指定されたバックアップ Storage 冗長は、ターゲット リージョンではサポートされていません。

  • 400 LongTermRetentionMigrationStorageMismatch - データベースのアクティブ バックアップの冗長性が、お客様から要求されたバックアップの冗長性と一致しません。

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR 移行は、マネージド インスタンスと Azure SQL DB LTR バックアップでのみサポートされます。

  • 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした

  • 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソース グループとサブスクリプションに存在しません。

  • 404 ResourceNotFound - 要求されたリソースが見つかりませんでした。

  • 404 LongTermRetentionMigrationBackupNotFound - 指定された LTR バックアップが存在しません。

  • 409 LongTermRetentionMigrationRequestConflict - この LTR バックアップに対する競合操作がまだ進行中です。

  • 409 LongTermRetentionMigrationBackupConflict - ターゲット データベースのバックアップ時間が同じ別の LTR バックアップが存在します。

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - ターゲット リージョンで LTR バックアップ コピー要求を開始できません。

  • 500 LongTermRetentionMigrationRequestCopyFailed - LTR バックアップ BLOB のコピー操作に失敗しました。

  • 500 LongTermRetentionMigrationRestoreVerExceeded - 最大試行回数に達した後、復元の検証に失敗しました。

  • 500 LongTermRetentionMigrationRestoreVerFailed - 復元の検証に失敗しました。

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=2020-11-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"
  }
}

定義

BackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

LongTermRetentionBackupOperationResult

LongTermRetentionBackup 操作の結果リソース。

RequestedBackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

UpdateLongTermRetentionBackupParameters

長期保有バックアップ更新操作を実行するために必要な情報が含まれている。

BackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

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

LongTermRetentionBackupOperationResult

LongTermRetentionBackup 操作の結果リソース。

Name Type Description
id
  • string

リソースの ID

name
  • string

リソース名。

properties.fromBackupResourceId
  • string

ソース バックアップ リソース ID

properties.message
  • string

進行状況メッセージ

properties.operationType
  • string

操作の種類。

properties.requestId
  • string

要求 ID。

properties.status
  • string

操作の状態

properties.targetBackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

properties.toBackupResourceId
  • string

ターゲット バックアップ リソース ID

type
  • string

リソースの種類。

RequestedBackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類

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

UpdateLongTermRetentionBackupParameters

長期保有バックアップ更新操作を実行するために必要な情報が含まれている。

Name Type Description
properties.requestedBackupStorageRedundancy

コピーされたバックアップのストレージ冗長性の種類