Long Term Retention Backups - Copy

Servicio:

SQL Database

Versión de la API:

2025-01-01

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

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/copy?api-version=2025-01-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	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	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.targetBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
properties.targetDatabaseName	string	El nombre de la base de datos posee la copia de seguridad copiada.
properties.targetResourceGroup	string	El grupo de recursos que posee el servidor de destino
properties.targetServerFullyQualifiedDomainName	string	Nombre de dominio completo del servidor de destino
properties.targetServerResourceId	string	Identificador de recurso del servidor de destino que posee la base de datos
properties.targetSubscriptionId	string	La suscripción que posee el servidor de destino

Respuestas

Nombre	Tipo	Description
200 OK	LongTermRetentionBackupOperationResult	Copió correctamente la copia de seguridad.
202 Accepted		La copia de seguridad está en curso. Encabezados Location: string
Other Status Codes	ErrorResponse	Respuestas de error: *** 400 ManagedInstanceStoppingOrStopped: operación en conflicto enviada mientras la instancia está en estado de detención o detención 400 ManagedInstanceStarting: operación en conflicto enviada mientras la instancia está en estado de inicio 400 InvalidLongTermRetentionBackupId: identificador de copia de seguridad de retención a largo plazo no válido para bases de datos SQL. 400 InvalidParameterValue: se ha proporcionado un valor no válido a un parámetro. 400 LongTermRetentionMismatchingSubscriptionId: el identificador de suscripción proporcionado no coincide con el identificador de 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 en la otra entrada. 400 DeleteLtrSubscriptionMissing: el identificador de suscripción es necesario para eliminar una copia de seguridad de retención a largo plazo. 400 DeleteLtrServerMissing: el nombre del servidor es necesario para eliminar una copia de seguridad de retención a largo plazo. 400 DeleteLtrDatabaseMissing: el nombre de la base de datos es necesario para eliminar una copia de seguridad de retención a largo plazo. 400 LtrBackupResourceIdIncorrect: el identificador de recurso de copia de seguridad de retención a largo plazo proporcionado o el nombre de copia de seguridad son incorrectos. 400 UpdateBackupStorageAccessTierLTRFailedOnZoneRedundantBackupStorage: no se admite el archivado de copias de seguridad de retención a largo plazo en el almacenamiento de copia de seguridad con redundancia de zona. En su lugar, use tipos de almacenamiento con redundancia local o con redundancia geográfica. 400 UpdateBackupStorageAccessTierLtrSubscriptionMissing: el identificador de suscripción es necesario para actualizar la copia de seguridad de retención a largo plazo. 400 UpdateBackupStorageAccessTierLtrServerMissing: el nombre del servidor es necesario para actualizar la copia de seguridad de retención a largo plazo. 400 UpdateBackupStorageAccessTierLtrDatabaseMissing: el nombre de la base de datos es necesario para actualizar la copia de seguridad de retención a largo plazo. 400 UpdateBackupStorageAccessTierLtrBackupResourceIdIncorrect: el identificador de recurso de copia de seguridad de retención a largo plazo proporcionado o el nombre de copia de seguridad son incorrectos. 400 LTRBackupNotExists: no se pudo completar la operación porque la copia de seguridad no existe. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed: no se permite cambiar la redundancia de almacenamiento de copia de seguridad para las operaciones de copia de LTR. 400 LtrRestoreFailedArchiveStorageTier: no se admite la restauración de la copia de seguridad de retención a largo plazo archivada. La restauración solo se puede realizar en copias de seguridad de retención rehidratadas o periódicas a largo plazo. 400 LtrArchiveStorageTierNotEnabled: las copias de seguridad de retención a largo plazo de archivado no están habilitadas. 400 LtrArchiveWrongParameters: ChangeLongTermRetentionBackupAccessTier no se admite para la combinación deseada (backupStorageAccessTier, operationMode). Solo se permiten (Archivar, Mover) y (Frecuente, Copiar). 400 LTRArchiveRedundancyChangeFailed: no se admite la actualización del tipo de redundancia de almacenamiento de copia de seguridad al almacenamiento con redundancia de zona cuando se establece una directiva de retención a largo plazo con el nivel de acceso de almacenamiento de copia de seguridad "archivo". 400 LongTermRetentionMigrationSubscriptionNotFound: no se encontró la suscripción. 400 LtrOperationFailedBackupImmutable: se produjo un error al eliminar la copia de seguridad de retención a largo plazo porque la copia de seguridad es inmutable. 400 DeleteLtrBackupWithLegalHold: la copia de seguridad no se puede eliminar porque hay una retención legal colocada en ella. Quita la retención legal y vuelve a intentarlo. 400 LTRBackupImmutableNotSet: la operación no se pudo completar porque la copia de seguridad no está configurada para la inmutabilidad. 400 LTRBackupImmutabilityLocked: la operación no se pudo completar porque la copia de seguridad es inmutable y está bloqueada. 400 LongTermRetentionMigrationRequestNotSupported: no se permite la característica de migración de copia de seguridad de LTR. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported: las suscripciones de origen y destino no pueden comunicarse con la característica de copia de seguridad de LTR. 400 LongTermRetentionMigrationParameterMissing: falta el parámetro requerido para la operación. 400 LongTermRetentionMigrationSameServerNotSupported: la característica de copia LTR no se admite 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 de LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound: la base de datos de destino no existe en el servidor. 400 LongTermRetentionMigrationStorageTypeNotSupported: la redundancia de almacenamiento de copia de seguridad especificada 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 las copias de seguridad de LTR de Azure SQL DB y instancia administrada. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 ResourceNotFound: no se encontró el recurso solicitado. 404 LongTermRetentionMigrationBackupNotFound: la copia de seguridad de LTR especificada no existe. 404 OperationIdNotFound: la operación con id. 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 el mismo tiempo de copia de seguridad para la base de datos de destino. 409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar. 409 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso. 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. 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 en la comprobación de la restauración. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget: no se pudo iniciar la solicitud de copia de seguridad ltR en la región de destino. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación. 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

Ejemplos

Copy the long term retention backup.

Solicitud de ejemplo

HTTP

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

{
  "properties": {
    "targetServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2",
    "targetDatabaseName": "testDatabase2",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Respuesta de muestra

status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/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/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "CopyBackup",
    "status": "Succeeded",
    "toBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver2/longterRetentionDatabases/testDatabase2/longTermRetentionBackups/55555555-6666-7777-8888-111111111111;131637960820000000",
    "targetBackupStorageRedundancy": "Geo"
  }
}

status code:

202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706?api-version=2021-05-01

Definiciones

Nombre	Description
BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
CopyLongTermRetentionBackupParameters	Contiene la información necesaria para realizar la operación de copia de seguridad de retención a largo plazo.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
LongTermRetentionBackupOperationResult	Un recurso de resultado de la operación LongTermRetentionBackup.

BackupStorageRedundancy

Enumeración

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

Valor	Description
Geo
Local
Zone
GeoZone

CopyLongTermRetentionBackupParameters

Objeto

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

Nombre	Tipo	Description
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
properties.targetDatabaseName	string	El nombre de la base de datos posee la copia de seguridad copiada.
properties.targetResourceGroup	string	El grupo de recursos que posee el servidor de destino
properties.targetServerFullyQualifiedDomainName	string	Nombre de dominio completo del servidor de destino
properties.targetServerResourceId	string	Identificador de recurso del servidor de destino que posee la base de datos
properties.targetSubscriptionId	string	La suscripción que posee el servidor de destino

ErrorAdditionalInfo

Objeto

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.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

LongTermRetentionBackupOperationResult

Objeto

Un recurso de resultado de la operación LongTermRetentionBackup.

Nombre	Tipo	Description
id	string	Identificador de recurso.
name	string	Nombre del recurso.
properties.fromBackupResourceId	string	Identificador de recurso de copia de seguridad de origen
properties.message	string	Mensaje de progreso
properties.operationType	string	Tipo de operación.
properties.requestId	string (uuid)	Id. de solicitud.
properties.status	string	Estado de la operación
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
properties.toBackupResourceId	string	Id. de recurso de copia de seguridad de destino
type	string	Tipo de recurso.