REST API を使用して Azure Recovery Services コンテナーの構成を更新する

この記事では、REST API を使用して Azure Recovery Services コンテナーのバックアップ関連の構成を更新する方法について説明します。

論理的な削除状態

保護された項目のバックアップの削除は、監視する必要がある重要な操作です。 誤って削除されるのを防ぐために、Azure Recovery Services コンテナーには論理的な削除機能があります。 この機能を使用すると、削除されたバックアップを必要に応じて削除後の一定期間内で復元できます。

ただし、この機能が不要なシナリオもあります。 Azure Recovery Services コンテナーは、論理的に削除されたものも含め、その中にバックアップ項目がある場合は削除できません。 コンテナーをすぐに削除する必要がある場合、このことにより問題が発生する可能性があります。 たとえば、デプロイ操作では、作成されたリソースが同じワークフローでクリーンアップされることがよくあります。 デプロイはコンテナーを作成し、項目のバックアップを構成して、テストの復元を実行してから、バックアップ項目とコンテナーの削除に進むことができます。 コンテナーの削除に失敗した場合、デプロイ全体が失敗する可能性があります。 論理的な削除を無効にすることが、即時の削除を保証する唯一の方法です。

そのため、特定のコンテナーの論理的な削除機能の無効化は、シナリオに応じて慎重に選択する必要があります。 論理的な削除の詳細については、こちらを参照してください。

REST API を使用した論理的な削除状態の取得

既定では、新しく作成されたあらゆる Recovery Services コンテナーに対して、論理的な削除状態が有効になります。 コンテナーの論理的な削除状態を取得/更新するには、バックアップ コンテナーの構成に関連する REST API ドキュメントを使用します

コンテナーの現在の論理的な削除状態を取得するには、次の GET 操作を使用します

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

GET URI には、{subscriptionId}{vaultName}{vaultresourceGroupName} のパラメーターがあります。 この例では、{vaultName} は "testVault" で、{vaultresourceGroupName} は "testVaultRG" です。 すべての必須パラメーターは URI で指定されるため、別の要求本文は不要です。

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Responses

'GET' 操作に対する正常な応答は次のようになります。

名前 種類 説明
200 OK BackupResourceVaultConfig [OK]
応答の例

'GET' 要求を送信すると、200 (successful) 応答が返されます。

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

REST API を使用した論理的な削除状態の更新

REST API を使用して Recovery Services コンテナーの論理的な削除状態を更新するには、次の PUT 操作を使用します

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

PUT URI には、{subscriptionId}{vaultName}{vaultresourceGroupName} の各パラメーターがあります。 この例では、{vaultName} は "testVault" で、{vaultresourceGroupName} は "testVaultRG" です。 URI を上記の値に置き換えると、URI は次のようになります。

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

要求本文を作成する

要求本文を作成するには、以下の一般的な定義が使用されます

詳細については、REST API のドキュメントを参照してください

名前 Required タイプ 説明
eTag String 省略可能な eTag
location true String リソースの場所
properties VaultProperties コンテナーのプロパティ
tags Object リソース タグ

要求本文の例

次の例は、論理的な削除状態を 'disabled' に更新するために使用します。

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

PATCH 操作の応答

'PATCH' 操作に対する正常な応答は次のようになります。

名前 種類 説明
200 OK BackupResourceVaultConfig [OK]
PATCH 操作の応答例

'PATCH' 要求を送信すると、200 (successful) 応答が返されます。

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

次のステップ

このコンテナーに Azure VM をバックアップするためのバックアップ ポリシーを作成します

Azure REST API について詳しくは、次のドキュメントをご覧ください。