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 |
---|---|---|---|---|
backup
|
path | True |
string |
정책의 이름 |
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다. |
subscription
|
path | True |
string (uuid) |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
vault
|
path | True |
string |
백업 자격 증명 모음의 이름입니다. |
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
properties | BaseBackupPolicy: |
BaseBackupPolicy |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 |
---|---|
Absolute |
AbsoluteDeleteOption |
Absolute |
"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다. |
Adhoc |
AdhocBasedTaggingCriteria |
Adhoc |
AdhocBasedTriggerContext |
Azure |
AzureBackupParams |
Azure |
AzureBackupRule |
Azure |
AzureRetentionRule |
Backup |
BackupPolicy |
Backup |
BackupSchedule |
Base |
BaseBackupPolicyResource |
Cloud |
CloudError |
Copy |
CopyOnExpiryOption |
created |
리소스를 만든 ID의 형식입니다. |
Custom |
CustomCopyOption |
Data |
DataStoreInfoBase |
Data |
데이터 저장소의 형식; 운영/자격 증명 모음/보관 |
Day |
하루 |
Day |
일요일/월요일/T..../토요일이어야 합니다. |
Error |
리소스 관리 오류 응답입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Immediate |
ImmediateCopyOption |
Month |
1월/2월/....../12월이어야 합니다. |
Retention |
RetentionTag |
Schedule |
ScheduleBasedBackupCriteria |
Schedule |
ScheduleBasedTriggerContext |
Source |
SourceLifeCycle |
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
Tagging |
TaggingCriteria |
Target |
TargetCopySetting |
Week |
첫 번째/초/세 번째/네 번째/마지막이어야 합니다. |
AbsoluteDeleteOption
AbsoluteDeleteOption
Name | 형식 | Description |
---|---|---|
duration |
string |
지정된 시간 범위 이후 삭제 기간 |
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
AbsoluteMarker
"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다.
값 | Description |
---|---|
AllBackup | |
FirstOfDay | |
FirstOfMonth | |
FirstOfWeek | |
FirstOfYear |
AdhocBasedTaggingCriteria
AdhocBasedTaggingCriteria
Name | 형식 | Description |
---|---|---|
tagInfo |
RetentionTag |
AdhocBasedTriggerContext
AdhocBasedTriggerContext
Name | 형식 | Description |
---|---|---|
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
taggingCriteria |
AdhocBasedTaggingCriteria |
AzureBackupParams
AzureBackupParams
Name | 형식 | Description |
---|---|---|
backupType |
string |
BackupType; 전체/증분 등 |
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
AzureBackupRule
AzureBackupRule
Name | 형식 | Description |
---|---|---|
backupParameters | BackupParameters: |
BackupParameters |
dataStore |
DataStoreInfoBase |
|
name |
string |
|
objectType | string: | |
trigger | TriggerContext: |
TriggerContext |
AzureRetentionRule
AzureRetentionRule
Name | 형식 | Description |
---|---|---|
isDefault |
boolean |
|
lifecycles |
SourceLifeCycle |
|
name |
string |
|
objectType | string: |
BackupPolicy
BackupPolicy
Name | 형식 | Description |
---|---|---|
datasourceTypes |
string[] |
백업 관리를 위한 데이터 원본 유형 |
objectType | string: | |
policyRules | BasePolicyRule[]: |
각 backuptype에 대한 규칙(예: 전체/증분/로그 등)을 포함하는 정책 규칙 사전 |
BackupSchedule
BackupSchedule
Name | 형식 | Description |
---|---|---|
repeatingTimeIntervals |
string[] |
ISO 8601 반복 시간 간격 형식 |
timeZone |
string |
일정에 대한 표준 시간대입니다. 예: 태평양 표준시 |
BaseBackupPolicyResource
BaseBackupPolicyResource
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID는 리소스에 대한 전체 경로를 나타냅니다. |
name |
string |
리소스와 연결된 리소스 이름입니다. |
properties | BaseBackupPolicy: |
BaseBackupPolicy |
systemData |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
|
type |
string |
리소스 종류는 네임스페이스/ResourceType/ResourceType/... 양식의 전체 경로를 나타냅니다. |
CloudError
CloudError
Name | 형식 | Description |
---|---|---|
error |
리소스 관리 오류 응답입니다. |
CopyOnExpiryOption
CopyOnExpiryOption
Name | 형식 | Description |
---|---|---|
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
createdByType
리소스를 만든 ID의 형식입니다.
값 | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
CustomCopyOption
CustomCopyOption
Name | 형식 | Description |
---|---|---|
duration |
string |
지정된 시간 범위 후에 복사된 데이터 |
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
DataStoreInfoBase
DataStoreInfoBase
Name | 형식 | Description |
---|---|---|
dataStoreType |
데이터 저장소의 형식; 운영/자격 증명 모음/보관 |
|
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 |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
Error[] |
오류 세부 정보입니다. |
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ImmediateCopyOption
ImmediateCopyOption
Name | 형식 | Description |
---|---|---|
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
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 |
"AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth"와 같은 절대 값을 포함하며 AbsoluteMarker 열거형의 일부여야 합니다. |
|
daysOfMonth |
Day[] |
이 날짜는 월의 마지막 1에서 28까지의 다른 현명한 날입니다. |
daysOfTheWeek |
일요일/월요일/T..../토요일이어야 합니다. |
|
monthsOfYear |
Month[] |
1월/2월/....../12월이어야 합니다. |
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
scheduleTimes |
string[] (date-time) |
백업 일정 시간 목록 |
weeksOfTheMonth |
첫 번째/초/세 번째/네 번째/마지막이어야 합니다. |
ScheduleBasedTriggerContext
ScheduleBasedTriggerContext
Name | 형식 | Description |
---|---|---|
objectType | string: |
역직렬화에 사용되는 특정 개체의 형식 |
schedule |
BackupSchedule |
|
taggingCriteria |
지정된 일정에 적용할 수 있는 태그 목록입니다. |
SourceLifeCycle
SourceLifeCycle
Name | 형식 | Description |
---|---|---|
deleteAfter | DeleteOption: |
DeleteOption |
sourceDataStore |
DataStoreInfoBase |
|
targetDataStoreCopySettings |
TargetCopySetting |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |
TaggingCriteria
TaggingCriteria
Name | 형식 | Description |
---|---|---|
criteria | BackupCriteria[]: |
태그를 트리거된 백업에 적용할 수 있는지 여부를 결정하는 조건입니다. |
isDefault |
boolean |
태그가 기본값인지를 지정합니다. |
tagInfo |
RetentionTag |
|
taggingPriority |
integer (int64) |
보존 태그 우선 순위입니다. |
TargetCopySetting
TargetCopySetting
Name | 형식 | Description |
---|---|---|
copyAfter | CopyOption: |
CopyOption |
dataStore |
DataStoreInfoBase |
WeekNumber
첫 번째/초/세 번째/네 번째/마지막이어야 합니다.
값 | Description |
---|---|
First | |
Fourth | |
Last | |
Second | |
Third |