Compartir a través de

Backup Short Term Retention Policies - Create Or Update

  • Referencia
Servicio:
SQL Database
Versión de la API:
2021-11-01

Actualiza la directiva de retención a corto plazo de una base de datos.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

Nombre de la base de datos.
policyName
 path True

ShortTermRetentionPolicyName

Nombre de la directiva. Siempre debe ser "predeterminado".
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
serverName
 path True

string

Nombre del servidor.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

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

Cuerpo de la solicitud

Nombre Tipo Description
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours (int32)

Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo es aplicable a las bases de datos activas, pero no a las bases de datos eliminadas.
properties.retentionDays

integer (int32)

Período de retención de copia de seguridad en días. Este es el número de días que se admitirá la restauración a un momento dado.

Respuestas

Nombre Tipo Description
200 OK

BackupShortTermRetentionPolicy

Se actualizó correctamente la directiva.
202 Accepted

Aceptado
Other Status Codes

Respuestas de error: ***

  • 400 InvalidParameterValue: se ha proporcionado un valor no válido a un parámetro.

  • 400 InvalidBackupRetentionPeriod: los días de retención de {0} no son una configuración válida. La retención de copia de seguridad válida en días debe estar entre {1} y {2}

  • 400 InvalidDiffBackupIntervalHours: las horas diferenciales del intervalo de copia de seguridad de {0} no son una configuración válida. El intervalo de copia de seguridad diferencial válido debe ser {1} horas.

  • 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos.

  • 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado.

  • 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados.

  • 404 ResourceNotFound: no se encontró el recurso solicitado.

  • 404 SourceDatabaseNotFound: la base de datos de origen no existe.

  • 404 CannotFindObject: no se encuentra el objeto porque no existe o no tiene permisos

  • 409 ConflictingDatabaseOperation: ya hay alguna operación en la base de datos y la operación actual debe esperar hasta que se realice.

  • 409 ConflictingSystemOperationInProgress: una operación de mantenimiento del sistema está en curso en la base de datos y las operaciones adicionales deben esperar hasta que se complete.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 504 RequestTimeout: la solicitud de servicio superó el tiempo de espera permitido.

Ejemplos

Update the short term retention policy for the database.

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}
status code:
202

Definiciones

Nombre Description
BackupShortTermRetentionPolicy

Una directiva de retención a corto plazo.
DiffBackupIntervalInHours

Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo es aplicable a las bases de datos activas, pero no a las bases de datos eliminadas.
ShortTermRetentionPolicyName

Nombre de la directiva. Siempre debe ser "predeterminado".

BackupShortTermRetentionPolicy

Object

Una directiva de retención a corto plazo.

Nombre Tipo Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties.diffBackupIntervalInHours

DiffBackupIntervalInHours (int32)

Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo es aplicable a las bases de datos activas, pero no a las bases de datos eliminadas.
properties.retentionDays

integer (int32)

Período de retención de copia de seguridad en días. Este es el número de días que se admitirá la restauración a un momento dado.
type

string

Tipo de recurso.

DiffBackupIntervalInHours

Enumeración

Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo es aplicable a las bases de datos activas, pero no a las bases de datos eliminadas.

Valor Description
12
24

ShortTermRetentionPolicyName

Enumeración

Nombre de la directiva. Siempre debe ser "predeterminado".

Valor Description
default