다음을 통해 공유


REST API를 사용하여 Azure Recovery Services 보관소 구성 업데이트

이 문서에서는 REST API를 사용하여 Azure Recovery Services 볼트에서 백업 설정을 업데이트하는 방법을 설명합니다.

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Responses

'GET' 작업에 대한 성공적인 응답은 다음과 같습니다.

이름 유형 Description
200 확인 BackupResourceVaultConfig 그래
응답 예제

'GET' 요청이 제출되면 200(성공) 응답이 반환됩니다.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

요청 본문 만들기

요청 본문을 만드는 데 사용되는 일반적인 정의는 다음과 같습니다.

자세한 내용은 REST API 설명서를 참조하세요.

이름 필수 유형 Description
eTag String 선택적 eTag
location true String 리소스 위치
properties VaultProperties 자격 증명 모음의 속성
tags Object 리소스 태그

요청 본문 예제

다음 예제를 사용하여 일시 삭제 상태를 'disabled'로 업데이트합니다.

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

PATCH 작업에 대한 응답

'PATCH' 작업에 대한 성공적인 응답은 다음과 같습니다.

이름 유형 Description
200 확인 BackupResourceVaultConfig 그래
PATCH 작업에 대한 응답 예제

'PATCH' 요청이 제출되면 200(성공) 응답이 반환됩니다.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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에 대한 자세한 내용은 다음 문서를 참조하세요.