Long Term Retention Backups - Copy

サービス:

SQL Database

API バージョン:

2025-01-01

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

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

URI パラメーター

名前	/	必須	型	説明
backupName	path	True	string	バックアップ名。
locationName	path	True	string	データベースの場所。
longTermRetentionDatabaseName	path	True	string	データベースの名前
longTermRetentionServerName	path	True	string	サーバーの名前
subscriptionId	path	True	string (uuid)	ターゲット サブスクリプションの ID。 値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	コピーしたバックアップのストレージ冗長タイプ
properties.targetDatabaseName	string	データベースの名前は、コピーしたバックアップを所有します。
properties.targetResourceGroup	string	ターゲット サーバーを所有するリソース グループ
properties.targetServerFullyQualifiedDomainName	string	ターゲット サーバーの完全修飾ドメイン名
properties.targetServerResourceId	string	データベースを所有するターゲット サーバーのリソース ID
properties.targetSubscriptionId	string	ターゲット サーバーを所有するサブスクリプション

応答

名前	型	説明
200 OK	LongTermRetentionBackupOperationResult	Azureの運用は無事に完了しました。
202 Accepted		リソース操作が受け入れられます。 ヘッダー Location: string
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザー アカウントを偽装する

例

Copy the long term retention backup.

要求のサンプル

HTTP

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=2025-01-01

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

応答のサンプル

状態コード:

200

{
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "properties": {
    "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",
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo",
    "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"
  }
}

状態コード:

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	長期保有バックアップ コピー操作を実行するために必要な情報が含まれています。
createdByType	リソースを作成した ID の種類。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
LongTermRetentionBackupOperationResult	LongTermRetentionBackup 操作の結果リソース。
systemData	リソースの作成と最後の変更に関連するメタデータ。

BackupStorageRedundancy

列挙

このデータベースのバックアップを格納するために使用されるストレージ アカウントの種類。

値	説明
Geo	ジオ
Local	ローカル
Zone	ゾーン
GeoZone	GeoZone

CopyLongTermRetentionBackupParameters

Object

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

名前	型	説明
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	コピーしたバックアップのストレージ冗長タイプ
properties.targetDatabaseName	string	データベースの名前は、コピーしたバックアップを所有します。
properties.targetResourceGroup	string	ターゲット サーバーを所有するリソース グループ
properties.targetServerFullyQualifiedDomainName	string	ターゲット サーバーの完全修飾ドメイン名
properties.targetServerResourceId	string	データベースを所有するターゲット サーバーのリソース ID
properties.targetSubscriptionId	string	ターゲット サーバーを所有するサブスクリプション

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

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 (arm-id)	リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
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
systemData	systemData	create By と modifiedBy の情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。 例えば「Microsoft。Compute/virtualMachines」または「Microsoft」などです。ストレージ/ストレージアカウント」

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。