Compartir a través de


Backup Policies - Create Or Update

Crea o actualiza una directiva de copia de seguridad que pertenece a un almacén de copia de seguridad.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
backupPolicyName
path True

string

Nombre de la directiva

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

vaultName
path True

string

Nombre del almacén de copia de seguridad.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicy
Propiedades BaseBackupPolicyResource

Respuestas

Nombre Tipo Description
200 OK

BaseBackupPolicyResource

De acuerdo

Other Status Codes

CloudError

Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario.

Ejemplos

CreateOrUpdate BackupPolicy

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
AbsoluteDeleteOption

AbsoluteDeleteOption

AbsoluteMarker

contiene valores absolutos como "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" y deben formar parte de la enumeración AbsoluteMarker.

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria

AdhocBasedTriggerContext

AdhocBasedTriggerContext

AzureBackupParams

AzureBackupParams

AzureBackupRule

AzureBackupRule

AzureRetentionRule

AzureRetentionRule

BackupPolicy

Copia de seguridadPolítica

BackupSchedule

Programación de copias de seguridad

BaseBackupPolicyResource

BaseBackupPolicyResource

CloudError

CloudError

CopyOnExpiryOption

CopyOnExpiryOption

createdByType

Tipo de identidad que creó el recurso.

CustomCopyOption

CustomCopyOption

DataStoreInfoBase

DataStoreInfoBase

DataStoreTypes

tipo de almacén de datos; Operational/Vault/Archive

Day

Día

DayOfWeek

Debe ser Domingo/Lunes/T..../Sábado

Error

Respuesta de error de administración de recursos.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ImmediateCopyOption

ImmediateCopyOption

Month

Debe ser enero/febrero/....../diciembre

RetentionTag

RetentionTag

ScheduleBasedBackupCriteria

ScheduleBasedBackupCriteria

ScheduleBasedTriggerContext

ScheduleBasedTriggerContext

SourceLifeCycle

FuenteCiclo de vida

systemData

Metadatos relativos a la creación y última modificación del recurso.

TaggingCriteria

EtiquetadoCriteria

TargetCopySetting

TargetCopySetting

WeekNumber

Debe ser Primero/Segundo/Tercero/Cuarto/Último

AbsoluteDeleteOption

AbsoluteDeleteOption

Nombre Tipo Description
duration

string

Duración de la eliminación después del intervalo de tiempo especificado

objectType string:

AbsoluteDeleteOption

Tipo del objeto específico: se usa para deserializar

AbsoluteMarker

contiene valores absolutos como "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" y deben formar parte de la enumeración AbsoluteMarker.

Valor Description
AllBackup
FirstOfDay
FirstOfMonth
FirstOfWeek
FirstOfYear

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria

Nombre Tipo Description
tagInfo

RetentionTag

RetentionTag
Información de etiquetas de retención

AdhocBasedTriggerContext

AdhocBasedTriggerContext

Nombre Tipo Description
objectType string:

AdhocBasedTriggerContext

Tipo del objeto específico: se usa para deserializar

taggingCriteria

AdhocBasedTaggingCriteria

AdhocBasedTaggingCriteria
Etiquetado de criterios que contienen la etiqueta de retención para la copia de seguridad ad hoc.

AzureBackupParams

AzureBackupParams

Nombre Tipo Description
backupType

string

BackupType ; Completo o incremental, etc.

objectType string:

AzureBackupParams

Tipo del objeto específico: se usa para deserializar

AzureBackupRule

AzureBackupRule

Nombre Tipo Description
backupParameters BackupParameters:

AzureBackupParams

Parámetros de copia de seguridad
Base BackupParameters

dataStore

DataStoreInfoBase

DataStoreInfoBase
Base DataStoreInfo

name

string

objectType string:

AzureBackupRule

trigger TriggerContext:

TriggerContext
Contexto del desencadenador

AzureRetentionRule

AzureRetentionRule

Nombre Tipo Description
isDefault

boolean

lifecycles

SourceLifeCycle[]

FuenteCiclo de vida
LifeCycle de origen

name

string

objectType string:

AzureRetentionRule

BackupPolicy

Copia de seguridadPolítica

Nombre Tipo Description
datasourceTypes

string[]

Tipo de origen de datos para la administración de copias de seguridad

objectType string:

BackupPolicy

policyRules BasePolicyRule[]:

Diccionario de reglas de directiva que contiene reglas para cada tipo de copia de seguridad, es decir, Full/Incremental/Logs, etc.

BackupSchedule

Programación de copias de seguridad

Nombre Tipo Description
repeatingTimeIntervals

string[]

Formato de intervalo de tiempo repetido ISO 8601

timeZone

string

Zona horaria para una programación. Ejemplo: Hora estándar del Pacífico

BaseBackupPolicyResource

BaseBackupPolicyResource

Nombre Tipo Description
id

string

El identificador de recurso representa la ruta de acceso completa al recurso.

name

string

Nombre del recurso asociado al recurso.

properties BaseBackupPolicy:

BackupPolicy

BaseBackupPolicy
Propiedades BaseBackupPolicyResource

systemData

systemData

Metadatos relativos a la creación y última modificación del recurso.

type

string

El tipo de recurso representa la ruta de acceso completa del formulario Namespace/ResourceType/ResourceType/...

CloudError

CloudError

Nombre Tipo Description
error

Error

Respuesta de error de administración de recursos.

CopyOnExpiryOption

CopyOnExpiryOption

Nombre Tipo Description
objectType string:

CopyOnExpiryOption

Tipo del objeto específico: se usa para deserializar

createdByType

Tipo de identidad que creó el recurso.

Valor Description
Application
Key
ManagedIdentity
User

CustomCopyOption

CustomCopyOption

Nombre Tipo Description
duration

string

Datos copiados después del intervalo de tiempo especificado

objectType string:

CustomCopyOption

Tipo del objeto específico: se usa para deserializar

DataStoreInfoBase

DataStoreInfoBase

Nombre Tipo Description
dataStoreType

DataStoreTypes

tipo de almacén de datos; Operational/Vault/Archive

objectType

string

Tipo de objeto Datasource, usado para inicializar el tipo heredado correcto

DataStoreTypes

tipo de almacén de datos; Operational/Vault/Archive

Valor Description
ArchiveStore
OperationalStore
VaultStore

Day

Día

Nombre Tipo Description
date

integer (int32)

Fecha del mes

isLast

boolean

Si Date es la última fecha del mes

DayOfWeek

Debe ser Domingo/Lunes/T..../Sábado

Valor Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

Error

Respuesta de error de administración de recursos.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

Error[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ImmediateCopyOption

ImmediateCopyOption

Nombre Tipo Description
objectType string:

ImmediateCopyOption

Tipo del objeto específico: se usa para deserializar

Month

Debe ser enero/febrero/....../diciembre

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

RetentionTag

RetentionTag

Nombre Tipo Description
eTag

string

Versión de la etiqueta de retención.

id

string

Versión de la etiqueta de retención.

tagName

string

Nombre de etiqueta de retención para relacionarlo con la regla de retención.

ScheduleBasedBackupCriteria

ScheduleBasedBackupCriteria

Nombre Tipo Description
absoluteCriteria

AbsoluteMarker[]

contiene valores absolutos como "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" y deben formar parte de la enumeración AbsoluteMarker.

daysOfMonth

Day[]

Este es el día del mes de 1 a 28 otros sabios últimos del mes

daysOfTheWeek

DayOfWeek[]

Debe ser Domingo/Lunes/T..../Sábado

monthsOfYear

Month[]

Debe ser enero/febrero/....../diciembre

objectType string:

ScheduleBasedBackupCriteria

Tipo del objeto específico: se usa para deserializar

scheduleTimes

string[] (date-time)

Lista de horas de programación para la copia de seguridad

weeksOfTheMonth

WeekNumber[]

Debe ser Primero/Segundo/Tercero/Cuarto/Último

ScheduleBasedTriggerContext

ScheduleBasedTriggerContext

Nombre Tipo Description
objectType string:

ScheduleBasedTriggerContext

Tipo del objeto específico: se usa para deserializar

schedule

BackupSchedule

Programación de copias de seguridad
Programación para esta copia de seguridad

taggingCriteria

TaggingCriteria[]

Lista de etiquetas que se pueden aplicar a una programación determinada.

SourceLifeCycle

FuenteCiclo de vida

Nombre Tipo Description
deleteAfter DeleteOption:

AbsoluteDeleteOption

DeleteOption (Eliminar)
Eliminar opción

sourceDataStore

DataStoreInfoBase

DataStoreInfoBase
Base DataStoreInfo

targetDataStoreCopySettings

TargetCopySetting[]

TargetCopySetting
Configuración de copia de destino

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

TaggingCriteria

EtiquetadoCriteria

Nombre Tipo Description
criteria BackupCriteria[]:

ScheduleBasedBackupCriteria[]

Criterios que deciden si la etiqueta se puede aplicar a una copia de seguridad desencadenada.

isDefault

boolean

Especifica si la etiqueta es predeterminada.

tagInfo

RetentionTag

RetentionTag
Información de etiquetas de retención

taggingPriority

integer (int64)

Prioridad de la etiqueta de retención.

TargetCopySetting

TargetCopySetting

Nombre Tipo Description
copyAfter CopyOption:

CopyOption
Puede ser CustomCopyOption o ImmediateCopyOption.

dataStore

DataStoreInfoBase

DataStoreInfoBase
Información del almacén de datos de destino

WeekNumber

Debe ser Primero/Segundo/Tercero/Cuarto/Último

Valor Description
First
Fourth
Last
Second
Third