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 |
---|---|---|---|---|
backup
|
path | True |
string |
Nombre de la directiva |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
vault
|
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: |
BaseBackupPolicy |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
|
Other Status Codes |
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 |
---|---|
Absolute |
AbsoluteDeleteOption |
Absolute |
contiene valores absolutos como "AllBackup" / "FirstOfDay" / "FirstOfWeek" / "FirstOfMonth" y deben formar parte de la enumeración AbsoluteMarker. |
Adhoc |
AdhocBasedTaggingCriteria |
Adhoc |
AdhocBasedTriggerContext |
Azure |
AzureBackupParams |
Azure |
AzureBackupRule |
Azure |
AzureRetentionRule |
Backup |
Copia de seguridadPolítica |
Backup |
Programación de copias de seguridad |
Base |
BaseBackupPolicyResource |
Cloud |
CloudError |
Copy |
CopyOnExpiryOption |
created |
Tipo de identidad que creó el recurso. |
Custom |
CustomCopyOption |
Data |
DataStoreInfoBase |
Data |
tipo de almacén de datos; Operational/Vault/Archive |
Day |
Día |
Day |
Debe ser Domingo/Lunes/T..../Sábado |
Error |
Respuesta de error de administración de recursos. |
Error |
Información adicional sobre el error de administración de recursos. |
Immediate |
ImmediateCopyOption |
Month |
Debe ser enero/febrero/....../diciembre |
Retention |
RetentionTag |
Schedule |
ScheduleBasedBackupCriteria |
Schedule |
ScheduleBasedTriggerContext |
Source |
FuenteCiclo de vida |
system |
Metadatos relativos a la creación y última modificación del recurso. |
Tagging |
EtiquetadoCriteria |
Target |
TargetCopySetting |
Week |
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: |
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 |
AdhocBasedTriggerContext
AdhocBasedTriggerContext
Nombre | Tipo | Description |
---|---|---|
objectType | string: |
Tipo del objeto específico: se usa para deserializar |
taggingCriteria |
AdhocBasedTaggingCriteria |
AzureBackupParams
AzureBackupParams
Nombre | Tipo | Description |
---|---|---|
backupType |
string |
BackupType ; Completo o incremental, etc. |
objectType | string: |
Tipo del objeto específico: se usa para deserializar |
AzureBackupRule
AzureBackupRule
Nombre | Tipo | Description |
---|---|---|
backupParameters | BackupParameters: |
Parámetros de copia de seguridad |
dataStore |
DataStoreInfoBase |
|
name |
string |
|
objectType | string: | |
trigger | TriggerContext: |
TriggerContext |
AzureRetentionRule
AzureRetentionRule
Nombre | Tipo | Description |
---|---|---|
isDefault |
boolean |
|
lifecycles |
FuenteCiclo de vida |
|
name |
string |
|
objectType | string: |
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: | |
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: |
BaseBackupPolicy |
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 |
Respuesta de error de administración de recursos. |
CopyOnExpiryOption
CopyOnExpiryOption
Nombre | Tipo | Description |
---|---|---|
objectType | string: |
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: |
Tipo del objeto específico: se usa para deserializar |
DataStoreInfoBase
DataStoreInfoBase
Nombre | Tipo | Description |
---|---|---|
dataStoreType |
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 |
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: |
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 |
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 |
Debe ser Domingo/Lunes/T..../Sábado |
|
monthsOfYear |
Month[] |
Debe ser enero/febrero/....../diciembre |
objectType | string: |
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 |
Debe ser Primero/Segundo/Tercero/Cuarto/Último |
ScheduleBasedTriggerContext
ScheduleBasedTriggerContext
Nombre | Tipo | Description |
---|---|---|
objectType | string: |
Tipo del objeto específico: se usa para deserializar |
schedule |
Programación de copias de seguridad |
|
taggingCriteria |
Lista de etiquetas que se pueden aplicar a una programación determinada. |
SourceLifeCycle
FuenteCiclo de vida
Nombre | Tipo | Description |
---|---|---|
deleteAfter | DeleteOption: |
DeleteOption (Eliminar) |
sourceDataStore |
DataStoreInfoBase |
|
targetDataStoreCopySettings |
TargetCopySetting |
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 |
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 |
Tipo de identidad que modificó por última vez el recurso. |
TaggingCriteria
EtiquetadoCriteria
Nombre | Tipo | Description |
---|---|---|
criteria | BackupCriteria[]: |
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 |
|
taggingPriority |
integer (int64) |
Prioridad de la etiqueta de retención. |
TargetCopySetting
TargetCopySetting
Nombre | Tipo | Description |
---|---|---|
copyAfter | CopyOption: |
CopyOption |
dataStore |
DataStoreInfoBase |
WeekNumber
Debe ser Primero/Segundo/Tercero/Cuarto/Último
Valor | Description |
---|---|
First | |
Fourth | |
Last | |
Second | |
Third |