Backup Policies - Create Or Update

Reference

Služba:: Data Protection

Verze rozhraní API:: 2025-01-01

Vytvoří nebo aktualizuje zásady zálohování patřící do trezoru záloh.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
backupPolicyName	path	True	string	Název zásady
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string uuid	ID cílového předplatného. Hodnota musí být UUID.
vaultName	path	True	string	Název trezoru záloh.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicy BaseBackupPolicyResource – vlastnosti

Odpovědi

Name	Typ	Description
200 OK	BaseBackupPolicyResource	OK
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnit váš uživatelský účet.

Příklady

CreateOrUpdate BackupPolicy

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PrivatePreviewVault/backupPolicies/OSSDBPolicy?api-version=2025-01-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"
  }
}

Ukázková odpověď

Stavový kód:: 200

{
  "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"
  }
}

Definice

Name	Description
AbsoluteDeleteOption	AbsoluteDeleteOption
AbsoluteMarker	obsahuje absolutní hodnoty jako "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" a měl by být součástí výčtu AbsoluteMarker.
AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria
AdhocBasedTriggerContext	AdhocBasedTriggerContext
AzureBackupParams	AzureBackupParams
AzureBackupRule	AzureBackupRule
AzureRetentionRule	AzureRetentionRule
BackupPolicy	Zásady zálohování
BackupSchedule	BackupSchedule
BaseBackupPolicyResource	BaseBackupPolicyResource
CloudError	CloudError
CopyOnExpiryOption	CopyOnExpiryOption
createdByType	Typ identity, která prostředek vytvořila.
CustomCopyOption	CustomCopyOption
DataStoreInfoBase	DataStoreInfoBase
DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
Day	Den
DayOfWeek	Měla by být neděle/pondělí/T..../sobota
Error	Odpověď na chybu správy prostředků.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ImmediateCopyOption	ImmediateCopyOption
Month	Mělo by to být leden/únor/....../prosinec
RetentionTag	RetentionTag
ScheduleBasedBackupCriteria	ScheduleBasedBackupCriteria
ScheduleBasedTriggerContext	ScheduleBasedTriggerContext
SourceLifeCycle	SourceLifeCycle
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TaggingCriteria	TaggingCriteria
TargetCopySetting	TargetCopySetting
WeekNumber	Měla by být první/druhá/třetí/čtvrtá/poslední/ poslední

AbsoluteDeleteOption

Object

AbsoluteDeleteOption

Name	Typ	Description
duration	string	Doba trvání odstranění po daném časovém intervalu
objectType	string: AbsoluteDeleteOption	Typ konkrétního objektu – slouží k deserializaci

AbsoluteMarker

Enumeration

obsahuje absolutní hodnoty jako "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" a měl by být součástí výčtu AbsoluteMarker.

Hodnota	Description
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

Object

AdhocBasedTaggingCriteria

Name	Typ	Description
tagInfo	RetentionTag	RetentionTag Informace o značkách uchovávání informací

AdhocBasedTriggerContext

Object

AdhocBasedTriggerContext

Name	Typ	Description
objectType	string: AdhocBasedTriggerContext	Typ konkrétního objektu – slouží k deserializaci
taggingCriteria	AdhocBasedTaggingCriteria	AdhocBasedTaggingCriteria Kritéria označování obsahující značku uchovávání informací pro adhoc zálohování

AzureBackupParams

Object

AzureBackupParams

Name	Typ	Description
backupType	string	BackupType ; Úplné/přírůstkové atd.
objectType	string: AzureBackupParams	Typ konkrétního objektu – slouží k deserializaci

AzureBackupRule

Object

AzureBackupRule

Name	Typ	Description
backupParameters	BackupParameters: AzureBackupParams	BackupParameters Base BackupParameters
dataStore	DataStoreInfoBase	DataStoreInfoBase Základ DataStoreInfo
name	string
objectType	string: AzureBackupRule
trigger	TriggerContext: AdhocBasedTriggerContext ScheduleBasedTriggerContext	TriggerContext Kontext triggeru

AzureRetentionRule

Object

AzureRetentionRule

Name	Typ	Description
isDefault	boolean
lifecycles	SourceLifeCycle[]	SourceLifeCycle Životní cyklus zdroje
name	string
objectType	string: AzureRetentionRule

BackupPolicy

Object

Zásady zálohování

Name	Typ	Description
datasourceTypes	string[]	Typ zdroje dat pro správu zálohování
objectType	string: BackupPolicy
policyRules	BasePolicyRule[]: AzureBackupRule[] AzureRetentionRule[]	Slovník pravidel zásad, který obsahuje pravidla pro každý typ zálohování, tj. full/incremental/logs atd.

BackupSchedule

Object

BackupSchedule

Name	Typ	Description
repeatingTimeIntervals	string[]	Formát opakujícího se časového intervalu ISO 8601
timeZone	string	Časové pásmo pro plán. Příklad: Tichomoří (běžný čas)

BaseBackupPolicyResource

Object

BaseBackupPolicyResource

Name	Typ	Description
id	string	ID prostředku představuje úplnou cestu k prostředku.
name	string	Název prostředku přidružený k prostředku
properties	BaseBackupPolicy: BackupPolicy	BaseBackupPolicy BaseBackupPolicyResource – vlastnosti
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
type	string	Typ prostředku představuje úplnou cestu formuláře Namespace/ResourceType/ResourceType/...

CloudError

Object

CloudError

Name	Typ	Description
error	Error	Odpověď na chybu správy prostředků.

CopyOnExpiryOption

Object

CopyOnExpiryOption

Name	Typ	Description
objectType	string: CopyOnExpiryOption	Typ konkrétního objektu – slouží k deserializaci

createdByType

Enumeration

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

CustomCopyOption

Object

CustomCopyOption

Name	Typ	Description
duration	string	Data kopírovaná po daném časovém intervalu
objectType	string: CustomCopyOption	Typ konkrétního objektu – slouží k deserializaci

DataStoreInfoBase

Object

DataStoreInfoBase

Name	Typ	Description
dataStoreType	DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
objectType	string	Typ objektu Datasource, který se používá k inicializaci zděděného typu vpravo

DataStoreTypes

Enumeration

typ úložiště dat; Provozní/ Trezor / Archiv

Hodnota	Description
ArchiveStore
OperationalStore
VaultStore

Day

Object

Den

Name	Typ	Description
date	integer	Datum měsíce
isLast	boolean	Určuje, jestli je datum posledního data v měsíci.

DayOfWeek

Enumeration

Měla by být neděle/pondělí/T..../sobota

Hodnota	Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

Object

Odpověď na chybu správy prostředků.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	Error[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Object

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ImmediateCopyOption

Object

ImmediateCopyOption

Name	Typ	Description
objectType	string: ImmediateCopyOption	Typ konkrétního objektu – slouží k deserializaci

Month

Enumeration

Mělo by to být leden/únor/....../prosinec

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

RetentionTag

Object

RetentionTag

Name	Typ	Description
eTag	string	Verze značky uchovávání informací.
id	string	Verze značky uchovávání informací.
tagName	string	Název značky uchovávání informací, který se má spojit s pravidlem uchovávání informací.

ScheduleBasedBackupCriteria

Object

ScheduleBasedBackupCriteria

Name	Typ	Description
absoluteCriteria	AbsoluteMarker[]	obsahuje absolutní hodnoty jako "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" a měl by být součástí výčtu AbsoluteMarker.
daysOfMonth	Day[]	Tento den v měsíci od 1 do 28 dalších moudrých posledních měsíců
daysOfTheWeek	DayOfWeek[]	Měla by být neděle/pondělí/T..../sobota
monthsOfYear	Month[]	Mělo by to být leden/únor/....../prosinec
objectType	string: ScheduleBasedBackupCriteria	Typ konkrétního objektu – slouží k deserializaci
scheduleTimes	string[]	Seznam časů plánování zálohování
weeksOfTheMonth	WeekNumber[]	Měla by být první/druhá/třetí/čtvrtá/poslední/ poslední

ScheduleBasedTriggerContext

Object

ScheduleBasedTriggerContext

Name	Typ	Description
objectType	string: ScheduleBasedTriggerContext	Typ konkrétního objektu – slouží k deserializaci
schedule	BackupSchedule	BackupSchedule Naplánovat pro tuto zálohu
taggingCriteria	TaggingCriteria[]	Seznam značek, které lze použít pro daný plán

SourceLifeCycle

Object

SourceLifeCycle

Name	Typ	Description
deleteAfter	DeleteOption: AbsoluteDeleteOption	DeleteOption Možnost Odstranit
sourceDataStore	DataStoreInfoBase	DataStoreInfoBase Základ DataStoreInfo
targetDataStoreCopySettings	TargetCopySetting[]	TargetCopySetting Nastavení cílového kopírování

systemData

Object

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TaggingCriteria

Object

TaggingCriteria

Name	Typ	Description
criteria	BackupCriteria[]: ScheduleBasedBackupCriteria[]	Kritéria, která rozhodují, jestli se značka dá použít u aktivovaného zálohování.
isDefault	boolean	Určuje, jestli je značka výchozí.
tagInfo	RetentionTag	RetentionTag Informace o značkách uchovávání informací
taggingPriority	integer	Priorita značky uchovávání informací

TargetCopySetting

Object

TargetCopySetting

Name	Typ	Description
copyAfter	CopyOption: CopyOnExpiryOption CustomCopyOption ImmediateCopyOption	CopyOption Může to být CustomCopyOption nebo ImmediateCopyOption.
dataStore	DataStoreInfoBase	DataStoreInfoBase Informace o cílovém úložišti dat

WeekNumber

Enumeration

Měla by být první/druhá/třetí/čtvrtá/poslední/ poslední

Hodnota	Description
First
Fourth
Last
Second
Third

Sdílet prostřednictvím

Backup Policies - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

CreateOrUpdate BackupPolicy

Ukázkový požadavek

Ukázková odpověď

Definice

AbsoluteDeleteOption

AbsoluteMarker

AdhocBasedTaggingCriteria

AdhocBasedTriggerContext

AzureBackupParams

AzureBackupRule

AzureRetentionRule

BackupPolicy

BackupSchedule

BaseBackupPolicyResource

CloudError

CopyOnExpiryOption

createdByType

CustomCopyOption

DataStoreInfoBase

DataStoreTypes

Day

DayOfWeek

Error

ErrorAdditionalInfo

ImmediateCopyOption

Month

RetentionTag

ScheduleBasedBackupCriteria

ScheduleBasedTriggerContext

SourceLifeCycle

systemData

TaggingCriteria

TargetCopySetting

WeekNumber

Další materiály