Long Term Retention Backups - Update By Resource Group

Actualiza una copia de seguridad de retención a largo plazo existente.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?api-version=2020-11-01-preview

Parámetros de identificador URI

Name In Required Type Description
backupName
path True
  • string

Nombre de la copia de seguridad.

locationName
path True
  • string

Ubicación de la base de datos.

longTermRetentionDatabaseName
path True
  • string

Nombre de la base de datos

longTermRetentionServerName
path True
  • string

El nombre del servidor.

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.

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

Name Type Description
properties.requestedBackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

Respuestas

Name Type Description
200 OK

Se actualizó correctamente la copia de seguridad.

202 Accepted

La actualización de la copia de seguridad está en curso.

Other Status Codes

Respuestas de error: ***

  • 400 InvalidLongTermRetentionBackupId: identificador de copia de seguridad de retención a largo plazo no válido para SQL bases de datos.

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

  • 400 LongTermRetentionMismatchingSubscriptionId: el identificador de suscripción proporcionado no coincide con el identificador en la otra entrada.

  • 400 LongTermRetentionMismatchingResourceGroupName: el nombre del grupo de recursos proporcionado no coincide con el nombre de la otra entrada.

  • 400 LongTermRetentionMismatchingServerName: el nombre del servidor proporcionado no coincide con el nombre de la otra entrada.

  • 400 LongTermRetentionMigrationRequestNotSupported: no se permite la característica de migración de copia de seguridad LTR.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported: las suscripciones de origen y de destino no pueden comunicarse con la característica de copia de seguridad ltR.

  • 400 LongTermRetentionMigrationParameterMissing: falta el parámetro requerido para la operación.

  • 400 LongTermRetentionMigrationSameServerNotSupported: no se admite la característica de copia de LTR para copiar copias de seguridad de LTR en el mismo servidor.

  • 400 LongTermRetentionMigrationTargetServerNotFound: el servidor de destino no existe o no está listo para la operación de copia de seguridad LTR.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound: la base de datos de destino no existe en el servidor.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported: la redundancia de copia de seguridad especificada Storage no se admite en la región de destino.

  • 400 LongTermRetentionMigrationStorageMismatch: la redundancia de copia de seguridad activa de la base de datos no coincide con la redundancia de copia de seguridad solicitada por el cliente.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported: la migración de LTR solo se admite para la instancia administrada y Azure SQL copias de seguridad de DB LTR.

  • 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 LongTermRetentionMigrationBackupNotFound: la copia de seguridad de LTR especificada no existe.

  • 409 LongTermRetentionMigrationRequestConflict: una operación de conflicto en esta copia de seguridad ltR todavía está en curso.

  • 409 LongTermRetentionMigrationBackupConflict: existe otra copia de seguridad LTR con la misma hora de copia de seguridad para la base de datos de destino.

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget: no se pudo iniciar la solicitud de copia de seguridad ltR en la región de destino.

  • 500 LongTermRetentionMigrationRequestCopyFailed: error en la operación de copia de seguridad para blobs de copia de seguridad LTR.

  • 500 LongTermRetentionMigrationRestoreVerExceeded: se produjo un error en la comprobación de la restauración después de alcanzar los intentos máximos.

  • 500 LongTermRetentionMigrationRestoreVerFailed: error de comprobación de restauración.

Ejemplos

Update the long term retention backup.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/update?api-version=2020-11-01-preview

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Definiciones

BackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

LongTermRetentionBackupOperationResult

Recurso de resultado de la operación LongTermRetentionBackup.

RequestedBackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

UpdateLongTermRetentionBackupParameters

Contiene la información necesaria para realizar la operación de actualización de copia de seguridad de retención a largo plazo.

BackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

Recurso de resultado de la operación LongTermRetentionBackup.

Name Type Description
id
  • string

Identificador del recurso.

name
  • string

Nombre del recurso.

properties.fromBackupResourceId
  • string

Id. de recurso de copia de seguridad de origen

properties.message
  • string

Mensaje de progreso

properties.operationType
  • string

Tipo de operación.

properties.requestId
  • string

Id. de solicitud.

properties.status
  • string

Estado de la operación

properties.targetBackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

properties.toBackupResourceId
  • string

Identificador de recurso de copia de seguridad de destino

type
  • string

Tipo de recurso.

RequestedBackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

UpdateLongTermRetentionBackupParameters

Contiene la información necesaria para realizar la operación de actualización de copia de seguridad de retención a largo plazo.

Name Type Description
properties.requestedBackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada