다음을 통해 공유


Backup Policies - Create Or Update

백업 자격 증명 모음에 속하는 백업 정책을 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}?api-version=2024-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
backupPolicyName
path True

string

정책의 이름

resourceGroupName
path True

string

minLength: 1
maxLength: 90

리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

vaultName
path True

string

백업 자격 증명 모음의 이름입니다.

api-version
query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicy
BaseBackupPolicyResource 속성

응답

Name 형식 Description
200 OK

BaseBackupPolicyResource

그래

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정을 가장합니다.

예제

CreateOrUpdate BackupPolicy

샘플 요청

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy?api-version=2024-04-01

{
  "properties": {
    "policyRules": [
      {
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "trigger": {
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "tagInfo": {
                "tagName": "Default"
              },
              "taggingPriority": 99,
              "isDefault": true
            },
            {
              "tagInfo": {
                "tagName": "Weekly"
              },
              "taggingPriority": 20,
              "isDefault": false,
              "criteria": [
                {
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ],
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria"
                }
              ]
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "name": "BackupWeekly",
        "objectType": "AzureBackupRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P1W"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P12W"
            }
          }
        ],
        "isDefault": false,
        "name": "Weekly",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy"
  }
}

샘플 응답

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy",
  "name": "OSSDBPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "backupParameters": {
          "backupType": "Full",
          "objectType": "AzureBackupParams"
        },
        "trigger": {
          "schedule": {
            "repeatingTimeIntervals": [
              "R/2019-11-20T08:00:00-08:00/P1W"
            ]
          },
          "taggingCriteria": [
            {
              "tagInfo": {
                "tagName": "Default",
                "id": "Default_"
              },
              "taggingPriority": 99,
              "isDefault": true
            },
            {
              "tagInfo": {
                "tagName": "Weekly",
                "id": "Weekly_"
              },
              "taggingPriority": 20,
              "isDefault": false,
              "criteria": [
                {
                  "scheduleTimes": [
                    "2019-03-01T13:00:00Z"
                  ],
                  "daysOfTheWeek": [
                    "Sunday"
                  ],
                  "objectType": "ScheduleBasedBackupCriteria"
                }
              ]
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "name": "BackupWeekly",
        "objectType": "AzureBackupRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P1W"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      },
      {
        "lifecycles": [
          {
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P12W"
            }
          }
        ],
        "isDefault": false,
        "name": "Weekly",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "OssDB"
    ],
    "objectType": "BackupPolicy"
  }
}

정의

Name Description
AbsoluteDeleteOption

AbsoluteDeleteOption

AbsoluteMarker

"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다.

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria

AdhocBasedTriggerContext

AdhocBasedTriggerContext

AzureBackupParams

AzureBackupParams

AzureBackupRule

AzureBackupRule

AzureRetentionRule

AzureRetentionRule

BackupPolicy

BackupPolicy

BackupSchedule

BackupSchedule

BaseBackupPolicyResource

BaseBackupPolicyResource

CloudError

CloudError

CopyOnExpiryOption

CopyOnExpiryOption

createdByType

리소스를 만든 ID의 형식입니다.

CustomCopyOption

CustomCopyOption

DataStoreInfoBase

DataStoreInfoBase

DataStoreTypes

데이터 저장소의 형식; 운영/자격 증명 모음/보관

Day

하루

DayOfWeek

일요일/월요일/T..../토요일이어야 합니다.

Error

리소스 관리 오류 응답입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ImmediateCopyOption

ImmediateCopyOption

Month

1월/2월/....../12월이어야 합니다.

RetentionTag

RetentionTag

ScheduleBasedBackupCriteria

ScheduleBasedBackupCriteria

ScheduleBasedTriggerContext

ScheduleBasedTriggerContext

SourceLifeCycle

SourceLifeCycle

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

TaggingCriteria

TaggingCriteria

TargetCopySetting

TargetCopySetting

WeekNumber

첫 번째/초/세 번째/네 번째/마지막이어야 합니다.

AbsoluteDeleteOption

AbsoluteDeleteOption

Name 형식 Description
duration

string

지정된 시간 범위 이후 삭제 기간

objectType string:

AbsoluteDeleteOption

역직렬화에 사용되는 특정 개체의 형식

AbsoluteMarker

"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다.

Description
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria

Name 형식 Description
tagInfo

RetentionTag

RetentionTag
보존 태그 정보

AdhocBasedTriggerContext

AdhocBasedTriggerContext

Name 형식 Description
objectType string:

AdhocBasedTriggerContext

역직렬화에 사용되는 특정 개체의 형식

taggingCriteria

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria
임시 백업에 대한 보존 태그가 포함된 조건 태그 지정

AzureBackupParams

AzureBackupParams

Name 형식 Description
backupType

string

BackupType; 전체/증분 등

objectType string:

AzureBackupParams

역직렬화에 사용되는 특정 개체의 형식

AzureBackupRule

AzureBackupRule

Name 형식 Description
backupParameters BackupParameters:

AzureBackupParams

BackupParameters
BackupParameters 기본

dataStore

DataStoreInfoBase

DataStoreInfoBase
DataStoreInfo 기본

name

string

objectType string:

AzureBackupRule

trigger TriggerContext:

TriggerContext
트리거 컨텍스트

AzureRetentionRule

AzureRetentionRule

Name 형식 Description
isDefault

boolean

lifecycles

SourceLifeCycle[]

SourceLifeCycle
원본 수명 주기

name

string

objectType string:

AzureRetentionRule

BackupPolicy

BackupPolicy

Name 형식 Description
datasourceTypes

string[]

백업 관리를 위한 데이터 원본 유형

objectType string:

BackupPolicy

policyRules BasePolicyRule[]:

각 backuptype에 대한 규칙(예: 전체/증분/로그 등)을 포함하는 정책 규칙 사전

BackupSchedule

BackupSchedule

Name 형식 Description
repeatingTimeIntervals

string[]

ISO 8601 반복 시간 간격 형식

timeZone

string

일정에 대한 표준 시간대입니다. 예: 태평양 표준시

BaseBackupPolicyResource

BaseBackupPolicyResource

Name 형식 Description
id

string

리소스 ID는 리소스에 대한 전체 경로를 나타냅니다.

name

string

리소스와 연결된 리소스 이름입니다.

properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicy
BaseBackupPolicyResource 속성

systemData

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

type

string

리소스 종류는 네임스페이스/ResourceType/ResourceType/... 양식의 전체 경로를 나타냅니다.

CloudError

CloudError

Name 형식 Description
error

Error

리소스 관리 오류 응답입니다.

CopyOnExpiryOption

CopyOnExpiryOption

Name 형식 Description
objectType string:

CopyOnExpiryOption

역직렬화에 사용되는 특정 개체의 형식

createdByType

리소스를 만든 ID의 형식입니다.

Description
Application
Key
ManagedIdentity
User

CustomCopyOption

CustomCopyOption

Name 형식 Description
duration

string

지정된 시간 범위 후에 복사된 데이터

objectType string:

CustomCopyOption

역직렬화에 사용되는 특정 개체의 형식

DataStoreInfoBase

DataStoreInfoBase

Name 형식 Description
dataStoreType

DataStoreTypes

데이터 저장소의 형식; 운영/자격 증명 모음/보관

objectType

string

오른쪽 상속된 형식을 초기화하는 데 사용되는 Datasource 개체의 형식

DataStoreTypes

데이터 저장소의 형식; 운영/자격 증명 모음/보관

Description
ArchiveStore
OperationalStore
VaultStore

Day

하루

Name 형식 Description
date

integer (int32)

월의 날짜

isLast

boolean

날짜가 월의 마지막 날짜인지 여부

DayOfWeek

일요일/월요일/T..../토요일이어야 합니다.

Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

리소스 관리 오류 응답입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

Error[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ImmediateCopyOption

ImmediateCopyOption

Name 형식 Description
objectType string:

ImmediateCopyOption

역직렬화에 사용되는 특정 개체의 형식

Month

1월/2월/....../12월이어야 합니다.

Description
April
August
December
February
January
July
June
March
May
November
October
September

RetentionTag

RetentionTag

Name 형식 Description
eTag

string

보존 태그 버전입니다.

id

string

보존 태그 버전입니다.

tagName

string

보존 태그 이름을 보존 규칙과 연결합니다.

ScheduleBasedBackupCriteria

ScheduleBasedBackupCriteria

Name 형식 Description
absoluteCriteria

AbsoluteMarker[]

"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다.

daysOfMonth

Day[]

이 날짜는 월의 마지막 1에서 28까지의 다른 현명한 날입니다.

daysOfTheWeek

DayOfWeek[]

일요일/월요일/T..../토요일이어야 합니다.

monthsOfYear

Month[]

1월/2월/....../12월이어야 합니다.

objectType string:

ScheduleBasedBackupCriteria

역직렬화에 사용되는 특정 개체의 형식

scheduleTimes

string[] (date-time)

백업 일정 시간 목록

weeksOfTheMonth

WeekNumber[]

첫 번째/초/세 번째/네 번째/마지막이어야 합니다.

ScheduleBasedTriggerContext

ScheduleBasedTriggerContext

Name 형식 Description
objectType string:

ScheduleBasedTriggerContext

역직렬화에 사용되는 특정 개체의 형식

schedule

BackupSchedule

BackupSchedule
이 백업 예약

taggingCriteria

TaggingCriteria[]

지정된 일정에 적용할 수 있는 태그 목록입니다.

SourceLifeCycle

SourceLifeCycle

Name 형식 Description
deleteAfter DeleteOption:

AbsoluteDeleteOption

DeleteOption
삭제 옵션

sourceDataStore

DataStoreInfoBase

DataStoreInfoBase
DataStoreInfo 기본

targetDataStoreCopySettings

TargetCopySetting[]

TargetCopySetting
대상 복사 설정

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.

TaggingCriteria

TaggingCriteria

Name 형식 Description
criteria BackupCriteria[]:

ScheduleBasedBackupCriteria[]

태그를 트리거된 백업에 적용할 수 있는지 여부를 결정하는 조건입니다.

isDefault

boolean

태그가 기본값인지를 지정합니다.

tagInfo

RetentionTag

RetentionTag
보존 태그 정보

taggingPriority

integer (int64)

보존 태그 우선 순위입니다.

TargetCopySetting

TargetCopySetting

Name 형식 Description
copyAfter CopyOption:

CopyOption
CustomCopyOption 또는 ImmediateCopyOption일 수 있습니다.

dataStore

DataStoreInfoBase

DataStoreInfoBase
대상 데이터 저장소 정보

WeekNumber

첫 번째/초/세 번째/네 번째/마지막이어야 합니다.

Description
First
Fourth
Last
Second
Third