다음을 통해 공유


REST API를 사용하여 Azure Backup 자격 증명 모음 만들기

Azure Backup의 새로운 데이터 보호 플랫폼은 스토리지 계정, 관리 디스크, PostgreSQL 서버 PaaS 플랫폼의 Blob과 같은 최신 워크로드를 백업 및 복원하는 향상된 기능을 제공합니다. 이 기능의 목표는 관리 오버헤드를 최소화하면서 백업을 쉽게 구성하는 것입니다. ‘백업 자격 증명 모음’은 데이터 보호 플랫폼의 토대이며 이는 ‘Recovery Services’ 자격 증명 모음과 다릅니다.

REST API를 사용하여 Azure Backup 자격 증명 모음을 만드는 단계는 자격 증명 모음 REST API 만들기 설명서에 설명되어 있습니다. 이 문서를 참조하여 “미국 서부” 및 ‘TestBkpVaultRG’ 리소스 그룹에서 “testBkpVault”라는 자격 증명 모음을 만들어 보겠습니다.

Azure Backup 자격 증명 모음을 만들거나 업데이트하려면 다음 PUT 작업을 사용합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

요청 만들기

PUT 요청을 만들려면 {subscription-id} 매개 변수는 필수입니다. 구독이 여러 개인 경우 여러 구독으로 작업을 참조합니다. 리소스에 대해 {resourceGroupName}{vaultName}과 함께 api-version 매개 변수를 정의합니다. 이 문서에서는 api-version=2021-01-01을 사용합니다.

다음과 같은 헤더가 필요합니다.

요청 헤더 설명
Content-Type: 필수 사항입니다. application/json로 설정합니다.
권한 부여 필수 사항입니다. 유효한 Bearer액세스 토큰으로 설정합니다.

요청을 만드는 방법에 대한 자세한 내용은 REST API 요청/응답의 구성 요소를 참조하세요.

요청 본문 만들기

다음과 같은 일반적인 정의가 요청 본문을 빌드하는 데 사용됩니다.

Name 필수 형식 설명
eTag String 선택적 eTag
위치 true String 리소스 위치
properties true BackupVault 자격 증명 모음의 속성
ID DPPIdentityDetails 각 Azure 리소스에 대한 고유한 시스템 식별자를 식별합니다.
tags Object 리소스 태그

자격 증명 모음 이름 및 리소스 그룹 이름은 PUT URI에 제공되어 있습니다. 요청 본문은 위치를 정의합니다.

요청 본문 예제

다음 예제 본문은 “미국 서부”에 자격 증명 모음을 만드는 데 사용됩니다. 위치를 지정하세요.

{
  "___location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

백업 자격 증명 모음을 만들고 시스템이 할당한 ID도 생성하려면 다음 요청 본문을 제공해야 합니다.

{
  "___location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

응답

백업 자격 증명 모음 만들기는 비동기 작업입니다. 즉, 이 작업은 별도로 추적해야 하는 다른 작업을 만듭니다. 백업 자격 증명 모음을 만들거나 업데이트하는 작업에 대한 성공적인 응답에는 두 가지가 있습니다.

Name 형식 설명
200 정상 BackupVaultResource 확인
201 생성됨 BackupVaultResource 생성일
기타 상태 코드 CloudError

REST API 응답에 대한 자세한 내용은 응답 메시지 처리를 참조하세요.

예제 응답

이전 요청 본문 예제에서 압축된 201 생성됨 응답은 id가 할당되었으며 provisioningState성공임을 보여 줍니다.

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "___location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

다음 단계

이 자격 증명 모음에서 Blob을 백업하기 위한 백업 정책을 만듭니다.

Azure REST API에 대한 자세한 내용은 다음 문서를 참조하세요.