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

Novedades 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

El 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 en la API del Administrador de recursos o el portal de Azure.
serverName
 path True

string

El nombre del servidor.
subscriptionId
 path True

string

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

string

La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre Tipo Description
properties.diffBackupIntervalInHours

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.
properties.retentionDays

integer

Período de retención de la copia de seguridad, en días. Esta es la cantidad 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 dado 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 es necesario esperar hasta que se complete.

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

  • 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 los recursos disponibles pueden procesar.

  • 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

Una directiva de retención a corto plazo.

Nombre Tipo Description
id

string

Identificador del recurso.
name

string

Nombre del recurso.
properties.diffBackupIntervalInHours

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.
properties.retentionDays

integer

Período de retención de la copia de seguridad, en días. Esta es la cantidad de días que se admitirá la restauración a un momento dado.
type

string

Tipo de recurso.

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.

Nombre Tipo Description
12

string

24

string

ShortTermRetentionPolicyName

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

Nombre Tipo Description
default

string