Sdílet prostřednictvím


Backup Policies - Create Or Update

Vytvoří nebo Aktualizace zásady zálohování, které patří do trezoru záloh.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{backupPolicyName}?api-version=2023-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ů. V názvu se rozlišují 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
Vlastnosti BaseBackupPolicyResource

Odpovědi

Name Typ Description
200 OK

BaseBackupPolicyResource

OK

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu.

Příklady

CreateOrUpdate BackupPolicy

Sample Request

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

Sample Response

{
  "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á vytvořila prostředek.

CustomCopyOption

CustomCopyOption

DataStoreInfoBase

DataStoreInfoBase

DataStoreTypes

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

Day

Den

DayOfWeek

Měla by to 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í.

AbsoluteDeleteOption

AbsoluteDeleteOption

Name Typ Description
duration

string

Doba odstranění po daném časovém rozsahu

objectType string:

AbsoluteDeleteOption

Typ konkrétního objektu – slouží k deserializaci.

AbsoluteMarker

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

Name Typ Description
AllBackup

string

FirstOfDay

string

FirstOfMonth

string

FirstOfWeek

string

FirstOfYear

string

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria

Name Typ Description
tagInfo

RetentionTag

RetentionTag
Informace o značkách uchovávání informací

AdhocBasedTriggerContext

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

AzureBackupParams

Name Typ Description
backupType

string

BackupType ; Úplná/přírůstková atd.

objectType string:

AzureBackupParams

Typ konkrétního objektu – slouží k deserializaci.

AzureBackupRule

AzureBackupRule

Name Typ Description
backupParameters BackupParameters:

AzureBackupParams

BackupParameters
BackupParameters – základna

dataStore

DataStoreInfoBase

DataStoreInfoBase
DataStoreInfo – základna

name

string

objectType string:

AzureBackupRule

trigger TriggerContext:

TriggerContext
Kontext triggeru

AzureRetentionRule

AzureRetentionRule

Name Typ Description
isDefault

boolean

lifecycles

SourceLifeCycle[]

SourceLifeCycle
Životní cyklus zdroje

name

string

objectType string:

AzureRetentionRule

BackupPolicy

Zásady zálohování

Name Typ Description
datasourceTypes

string[]

Typ zdroje dat pro správu zálohování

objectType string:

BackupPolicy

policyRules BasePolicyRule[]:

Slovník pravidel zásad, který obsahuje pravidla pro každý typ zálohování, tj. úplné, přírůstkové, protokoly atd.

BackupSchedule

BackupSchedule

Name Typ Description
repeatingTimeIntervals

string[]

Formát časového intervalu opakování ISO 8601

timeZone

string

Časové pásmo pro plán. Příklad: Tichomoří (běžný čas)

BaseBackupPolicyResource

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
Vlastnosti BaseBackupPolicyResource

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

CloudError

Name Typ Description
error

Error

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

CopyOnExpiryOption

CopyOnExpiryOption

Name Typ Description
objectType string:

CopyOnExpiryOption

Typ konkrétního objektu – slouží k deserializaci.

createdByType

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

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

CustomCopyOption

CustomCopyOption

Name Typ Description
duration

string

Data zkopírovaná po daném časovém rozsahu

objectType string:

CustomCopyOption

Typ konkrétního objektu – slouží k deserializaci.

DataStoreInfoBase

DataStoreInfoBase

Name Typ Description
dataStoreType

DataStoreTypes

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

objectType

string

Typ objektu Datasource, který slouží k inicializaci pravého zděděného typu

DataStoreTypes

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

Name Typ Description
ArchiveStore

string

OperationalStore

string

VaultStore

string

Day

Den

Name Typ Description
date

integer

Datum v měsíci

isLast

boolean

Určuje, jestli je datum posledním datem v měsíci.

DayOfWeek

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

Name Typ Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

Error

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

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

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ImmediateCopyOption

ImmediateCopyOption

Name Typ Description
objectType string:

ImmediateCopyOption

Typ konkrétního objektu – slouží k deserializaci.

Month

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

Name Typ Description
April

string

August

string

December

string

February

string

January

string

July

string

June

string

March

string

May

string

November

string

October

string

September

string

RetentionTag

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í pro jeho vztah k pravidlu uchovávání informací.

ScheduleBasedBackupCriteria

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[]

Toto je den v měsíci od 1 do 28 dalších moudrých posledních měsíců.

daysOfTheWeek

DayOfWeek[]

Měla by to 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 naplánovaných časů zálohování

weeksOfTheMonth

WeekNumber[]

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

ScheduleBasedTriggerContext

ScheduleBasedTriggerContext

Name Typ Description
objectType string:

ScheduleBasedTriggerContext

Typ konkrétního objektu – slouží k deserializaci.

schedule

BackupSchedule

BackupSchedule
Plán pro toto zálohování

taggingCriteria

TaggingCriteria[]

Seznam značek, které lze použít pro daný plán

SourceLifeCycle

SourceLifeCycle

Name Typ Description
deleteAfter DeleteOption:

AbsoluteDeleteOption

DeleteOption
Odstranit možnost

sourceDataStore

DataStoreInfoBase

DataStoreInfoBase
DataStoreInfo – základna

targetDataStoreCopySettings

TargetCopySetting[]

TargetCopySetting
Nastavení cílového kopírování

systemData

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á vytvořila prostředek.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.

TaggingCriteria

TaggingCriteria

Name Typ Description
criteria BackupCriteria[]:

ScheduleBasedBackupCriteria[]

Kritéria, která rozhodují o tom, jestli je možné značku použít na aktivovanou zálohu.

isDefault

boolean

Určuje, jestli je výchozí značka.

tagInfo

RetentionTag

RetentionTag
Informace o značkách uchovávání informací

taggingPriority

integer

Priorita značky uchovávání informací.

TargetCopySetting

TargetCopySetting

Name Typ Description
copyAfter CopyOption:

CopyOption
Může to být CustomCopyOption nebo ImmediateCopyOption.

dataStore

DataStoreInfoBase

DataStoreInfoBase
Informace o cílovém úložišti dat

WeekNumber

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

Name Typ Description
First

string

Fourth

string

Last

string

Second

string

Third

string