Long Term Retention Backups - Update

Référence

Service:: SQL Database

API Version:: 2021-11-01

Mises à jour une sauvegarde de rétention à long terme existante.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
backupName	path	True	string	Nom de la sauvegarde.
locationName	path	True	string	Emplacement de la base de données.
longTermRetentionDatabaseName	path	True	string	Le nom de la base de données,
longTermRetentionServerName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde copiée

Réponses

Nom	Type	Description
200 OK	LongTermRetentionBackupOperationResult	Mise à jour réussie de la sauvegarde.
202 Accepted		La mise à jour de la sauvegarde est en cours.
Other Status Codes		Réponses d’erreur : *** 400 InvalidLongTermRetentionBackupId : identificateur de sauvegarde de rétention à long terme non valide pour les bases de données SQL. 400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre. 400 LongTermRetentionMismatchingSubscriptionId : l’ID d’abonnement fourni ne correspondait pas à l’ID de l’autre entrée 400 LongTermRetentionMismatchingResourceGroupName : le nom du groupe de ressources fourni ne correspond pas au nom de l’autre entrée 400 LongTermRetentionMismatchingServerName : le nom du serveur fourni ne correspond pas au nom de l’autre entrée 400 LongTermRetentionMigrationRequestNotSupported - L’abonnement n’est pas autorisé avec la fonctionnalité de migration de sauvegarde LTR. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported : les abonnements source et cible ne sont pas autorisés à communiquer pour la fonctionnalité de copie de sauvegarde LTR. 400 LongTermRetentionMigrationParameterMissing : paramètre obligatoire manquant pour l’opération. 400 LongTermRetentionMigrationSameServerNotSupported - La fonctionnalité de copie LTR n’est pas prise en charge pour copier des sauvegardes LTR sur le même serveur. 400 LongTermRetentionMigrationTargetServerNotFound : le serveur cible n’existe pas ou n’est pas prêt pour l’opération de copie de sauvegarde LTR. 400 LongTermRetentionMigrationTargetDatabaseNotFound : la base de données cible n’existe pas sur le serveur. 400 LongTermRetentionMigrationStorageTypeNotSupported : la redondance de stockage de sauvegarde spécifiée n’est pas prise en charge dans la région cible. 400 LongTermRetentionMigrationStorageMismatch : la redondance de sauvegarde active de la base de données ne correspond pas à la redondance de sauvegarde demandée par le client. 400 LongTermRetentionMigrationDatabaseTypeNotSupported : la migration LTR n’est prise en charge que pour les sauvegardes LTR instance managées et Azure SQL base de données. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed : la modification de la redondance du stockage de sauvegarde n’est pas autorisée pour les opérations de copie LTR. 400 LongTermRetentionMigrationSubscriptionNotFound : l’abonnement est introuvable. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 ResourceNotFound : la ressource demandée est introuvable. 404 LongTermRetentionMigrationBackupNotFound : la sauvegarde LTR spécifiée n’existe pas. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 409 LongTermRetentionMigrationRequestConflict : une opération de conflit sur cette sauvegarde LTR est toujours en cours. 409 LongTermRetentionMigrationBackupConflict : une autre sauvegarde LTR avec le même temps de sauvegarde pour la base de données cible existe. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget : échec du démarrage de la demande de copie de sauvegarde LTR dans la région cible. 500 LongTermRetentionMigrationRequestCopyFailed : échec de l’opération de copie pour les objets blob de sauvegarde LTR. 500 LongTermRetentionMigrationRestoreVerExceeded : la vérification de la restauration a échoué après que le nombre maximal de tentatives a été atteint. 500 LongTermRetentionMigrationRestoreVerFailed - Échec de la vérification de la restauration. 500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Nom

Type

Description

200 OK

LongTermRetentionBackupOperationResult

Mise à jour réussie de la sauvegarde.

202 Accepted

La mise à jour de la sauvegarde est en cours.

Other Status Codes

Réponses d’erreur : ***

400 InvalidLongTermRetentionBackupId : identificateur de sauvegarde de rétention à long terme non valide pour les bases de données SQL.
400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre.
400 LongTermRetentionMismatchingSubscriptionId : l’ID d’abonnement fourni ne correspondait pas à l’ID de l’autre entrée
400 LongTermRetentionMismatchingResourceGroupName : le nom du groupe de ressources fourni ne correspond pas au nom de l’autre entrée
400 LongTermRetentionMismatchingServerName : le nom du serveur fourni ne correspond pas au nom de l’autre entrée
400 LongTermRetentionMigrationRequestNotSupported - L’abonnement n’est pas autorisé avec la fonctionnalité de migration de sauvegarde LTR.
400 LongTermRetentionMigrationCrossClusterRequestNotSupported : les abonnements source et cible ne sont pas autorisés à communiquer pour la fonctionnalité de copie de sauvegarde LTR.
400 LongTermRetentionMigrationParameterMissing : paramètre obligatoire manquant pour l’opération.
400 LongTermRetentionMigrationSameServerNotSupported - La fonctionnalité de copie LTR n’est pas prise en charge pour copier des sauvegardes LTR sur le même serveur.
400 LongTermRetentionMigrationTargetServerNotFound : le serveur cible n’existe pas ou n’est pas prêt pour l’opération de copie de sauvegarde LTR.
400 LongTermRetentionMigrationTargetDatabaseNotFound : la base de données cible n’existe pas sur le serveur.
400 LongTermRetentionMigrationStorageTypeNotSupported : la redondance de stockage de sauvegarde spécifiée n’est pas prise en charge dans la région cible.
400 LongTermRetentionMigrationStorageMismatch : la redondance de sauvegarde active de la base de données ne correspond pas à la redondance de sauvegarde demandée par le client.
400 LongTermRetentionMigrationDatabaseTypeNotSupported : la migration LTR n’est prise en charge que pour les sauvegardes LTR instance managées et Azure SQL base de données.
400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed : la modification de la redondance du stockage de sauvegarde n’est pas autorisée pour les opérations de copie LTR.
400 LongTermRetentionMigrationSubscriptionNotFound : l’abonnement est introuvable.
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 ResourceNotFound : la ressource demandée est introuvable.
404 LongTermRetentionMigrationBackupNotFound : la sauvegarde LTR spécifiée n’existe pas.
404 OperationIdNotFound : l’opération avec ID n’existe pas.
409 LongTermRetentionMigrationRequestConflict : une opération de conflit sur cette sauvegarde LTR est toujours en cours.
409 LongTermRetentionMigrationBackupConflict : une autre sauvegarde LTR avec le même temps de sauvegarde pour la base de données cible existe.
409 OperationCancelled : l’opération a été annulée par l’utilisateur.
409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.
500 LongTermRetentionMigrationRequestFailedToStartOnTarget : échec du démarrage de la demande de copie de sauvegarde LTR dans la région cible.
500 LongTermRetentionMigrationRequestCopyFailed : échec de l’opération de copie pour les objets blob de sauvegarde LTR.
500 LongTermRetentionMigrationRestoreVerExceeded : la vérification de la restauration a échoué après que le nombre maximal de tentatives a été atteint.
500 LongTermRetentionMigrationRestoreVerFailed - Échec de la vérification de la restauration.
500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération.
503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Update the long term retention backup.

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/update?api-version=2021-11-01

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


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

/** Samples for LongTermRetentionBackups Update. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupUpdate.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().update("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/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": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Status code:: 202

Définitions

Nom	Description
BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde copiée
LongTermRetentionBackupOperationResult	Ressource de résultat de l’opération LongTermRetentionBackup.
UpdateLongTermRetentionBackupParameters	Contient les informations nécessaires pour effectuer une opération de mise à jour de sauvegarde de rétention à long terme.

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

Nom	Type	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackupOperationResult

Ressource de résultat de l’opération LongTermRetentionBackup.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.fromBackupResourceId	string	ID de ressource de sauvegarde source
properties.message	string	Message de progression
properties.operationType	string	Type d’opération.
properties.requestId	string	ID de demande.
properties.status	string	État de l’opération
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde copiée
properties.toBackupResourceId	string	ID de ressource de sauvegarde cible
type	string	Type de ressource.

UpdateLongTermRetentionBackupParameters

Contient les informations nécessaires pour effectuer une opération de mise à jour de sauvegarde de rétention à long terme.

Nom	Type	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde copiée

Long Term Retention Backups - Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Update the long term retention backup.

Sample Request

Sample Response

Définitions

BackupStorageRedundancy

LongTermRetentionBackupOperationResult

UpdateLongTermRetentionBackupParameters

Ressources supplémentaires