次の方法で共有

Long Term Retention Backups - Copy

サービス:
SQL Database
API バージョン:
2023-08-01

既存の長期保有バックアップをコピーします。

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

URI パラメーター

名前 / 必須 型 説明
backupName
 path True

string

バックアップ名。
locationName
 path True

string

データベースの場所。
longTermRetentionDatabaseName
 path True

string

データベースの名前
longTermRetentionServerName
 path True

string

サーバーの名前
subscriptionId
 path True

string

Azure サブスクリプションを識別するサブスクリプション ID。
api-version
 query True

string

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

要求本文

名前 型 説明
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

コピーしたバックアップのストレージ冗長タイプ
properties.targetDatabaseName

string

データベースの名前は、コピーしたバックアップを所有します。
properties.targetResourceGroup

string

ターゲット サーバーを所有するリソース グループ
properties.targetServerFullyQualifiedDomainName

string

ターゲット サーバーの完全修飾ドメイン名
properties.targetServerResourceId

string

データベースを所有するターゲット サーバーのリソース ID
properties.targetSubscriptionId

string

ターゲット サーバーを所有するサブスクリプション

応答

名前 型 説明
200 OK

LongTermRetentionBackupOperationResult

バックアップが正常にコピーされました。
202 Accepted

バックアップのコピーが進行中です。

ヘッダー

Location: string
Other Status Codes

ErrorResponse

エラー応答: ***

  • 400 ManagedInstanceStoppingOrStopped - インスタンスが停止/停止状態にある間に送信された操作の競合

  • 400 ManagedInstanceStarting - インスタンスが開始状態の間に送信された操作の競合

  • 400 InvalidLongTermRetentionBackupId - SQL DB の長期保有バックアップ識別子が無効です。

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

  • 400 LongTermRetentionMismatchingSubscriptionId - 指定されたサブスクリプション ID が、他の入力の ID と一致しませんでした

  • 400 LongTermRetentionMismatchingResourceGroupName - 指定されたリソース グループ名が、他の入力の名前と一致しませんでした

  • 400 LongTermRetentionMismatchingServerName - 指定されたサーバー名が、他の入力の名前と一致しませんでした

  • 400 DeleteLtrSubscriptionMissing - 長期保有バックアップを削除するには、サブスクリプション ID が必要です。

  • 400 DeleteLtrServerMissing - 長期保有バックアップを削除するには、サーバー名が必要です。

  • 400 DeleteLtrDatabaseMissing - 長期保有バックアップを削除するには、データベース名が必要です。

  • 400 LtrBackupResourceIdIncorrect - 指定された長期保有バックアップ リソース ID またはバックアップ名が正しくありません。

  • 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage - ゾーン冗長バックアップ ストレージでの長期保有バックアップのアーカイブはサポートされていません。 代わりに、ローカル冗長または geo 冗長ストレージの種類を使用してください。

  • 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing - 長期保有バックアップを更新するには、サブスクリプション ID が必要です。

  • 400 UpdateBackupStorageAccessTierLtrServerMissing - 長期保有バックアップを更新するには、サーバー名が必要です。

  • 400 UpdateBackupStorageAccessTierLtrDatabaseMissing - 長期保有バックアップを更新するには、データベース名が必要です。

  • 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect - 指定された長期保有バックアップ リソース ID またはバックアップ名が正しくありません。

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

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

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

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

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

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

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

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

  • 400 LtrOperationFailedBackupImmutable - バックアップが不変であるため、長期保有バックアップの削除に失敗しました。

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

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR コピー操作でバックアップ ストレージの冗長性を変更することはできません。

  • 400 LtrRestoreFailedArchiveStorageTier - アーカイブされた長期保有バックアップの復元はサポートされていません。 復元は、リハイドレートされたバックアップまたは定期的な長期保有バックアップでのみ実行できます。

  • 400 LtrArchiveStorageTierNotEnabled - 長期保有バックアップのアーカイブが有効になっていません。

  • 400 LtrArchiveWrongParameters - ChangeLongTermRetentionBackupAccessTier は、目的の (backupStorageAccessTier、operationMode) の組み合わせではサポートされていません。 (アーカイブ、移動)、(ホット、コピー) のみが許可されます。

  • 400 LTRArchiveRedundancyChangeFailed - "アーカイブ" バックアップ ストレージ アクセス層を持つ長期保有ポリシーが設定されている場合、バックアップ ストレージの冗長性の種類をゾーン冗長ストレージに更新することはできません

  • 400 LongTermRetentionMigrationSubscriptionNotFound - サブスクリプションが見つかりませんでした。

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

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

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

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

  • 404 OperationIdNotFound - Id を持つ操作が存在しません。

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

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

  • 409 CannotCancelOperation - 管理操作が取り消すことができない状態です。

  • 409 OperationCancelled - 操作がユーザーによって取り消されました。

  • 409 OperationInterrupted - 同じリソースに対する別の操作によって中断されたため、リソースに対する操作を完了できませんでした。

  • 429 SubscriptionTooManyCreateUpdateRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

  • 429 SubscriptionTooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

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

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

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

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

  • 500 OperationTimedOut - 操作がタイムアウトし、自動的にロールバックされました。 操作を再試行してください。

  • 503 TooManyRequests - 使用可能なリソースによって処理できる最大要求を超える要求。

例

Copy the long term retention backup.

要求のサンプル

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=2023-08-01

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

応答のサンプル

状態コード:
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"
  }
}
状態コード:
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

定義

名前 説明
BackupStorageRedundancy

コピーしたバックアップのストレージ冗長タイプ
CopyLongTermRetentionBackupParameters

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

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
LongTermRetentionBackupOperationResult

LongTermRetentionBackup 操作の結果リソース。

BackupStorageRedundancy

列挙

コピーしたバックアップのストレージ冗長タイプ

値 説明
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

Object

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

名前 型 説明
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

コピーしたバックアップのストレージ冗長タイプ
properties.targetDatabaseName

string

データベースの名前は、コピーしたバックアップを所有します。
properties.targetResourceGroup

string

ターゲット サーバーを所有するリソース グループ
properties.targetServerFullyQualifiedDomainName

string

ターゲット サーバーの完全修飾ドメイン名
properties.targetServerResourceId

string

データベースを所有するターゲット サーバーのリソース ID
properties.targetSubscriptionId

string

ターゲット サーバーを所有するサブスクリプション

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

LongTermRetentionBackupOperationResult

Object

LongTermRetentionBackup 操作の結果リソース。

名前 型 説明
id

string

リソース ID。
name

string

リソース名。
properties.fromBackupResourceId

string

ソース バックアップ リソース ID
properties.message

string

進行状況メッセージ
properties.operationType

string

操作の種類。
properties.requestId

string (uuid)

要求 ID。
properties.status

string

操作の状態
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

コピーしたバックアップのストレージ冗長タイプ
properties.toBackupResourceId

string

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

string

リソースの種類。