Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Novedades 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=2021-11-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	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

Nombre	Tipo	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada

Respuestas

Nombre	Tipo	Description
200 OK	LongTermRetentionBackupOperationResult	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 bases de datos SQL. 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 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 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 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 DB LTR y de instancia administrada Azure SQL. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed: no se permite cambiar la redundancia del almacenamiento de copia de seguridad para las operaciones de copia ltr. 400 LongTermRetentionMigrationSubscriptionNotFound: no se encontró la suscripción. 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. 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 OperationCancelled: el usuario canceló la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SuscripciónTooManyCreateUpdateRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 429 SubscriptionTooManyRequests: solicitudes más allá del número máximo de solicitudes que pueden procesar los recursos disponibles. 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 para blobs de copia de seguridad LTR. 500 LongTermRetentionMigrationRestoreVerExceeded: 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. 500 OperationTimedOut: se agota el tiempo de espera de la operación y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá del número máximo de solicitudes que se pueden procesar mediante recursos disponibles.

Ejemplos

Update the long term retention backup.

Sample Request

HTTP

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=2021-11-01

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

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/** Samples for LongTermRetentionBackups UpdateByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().updateByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
            Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

{
  "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"
  }
}

Status code:

202

Definiciones

Nombre	Description
BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
LongTermRetentionBackupOperationResult	Un recurso de resultado de la operación LongTermRetentionBackup.
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

Nombre	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Un recurso de resultado de la operación LongTermRetentionBackup.

Nombre	Tipo	Description
id	string	Identificador del 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	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	Identificador de recurso de copia de seguridad de destino
type	string	Tipo de recurso.

UpdateLongTermRetentionBackupParameters

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

Nombre	Tipo	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada