Long Term Retention Backups - Update By Resource Group

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

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

Paramètres URI

Name In Required Type Description
backupName
path True
  • string

Nom de 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

resourceGroupName
path True
  • string

Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.

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

Name Type Description
properties.requestedBackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

Réponses

Name Type Description
200 OK

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 dans l’autre entrée

  • 400 LongTermRetentionMismatchingResourceGroupName - Le nom du groupe de ressources fourni ne correspondait pas au nom dans l’autre entrée

  • 400 LongTermRetentionMismatchingServerName - Le nom du serveur fourni ne correspondait pas au nom dans l’autre entrée

  • 400 LongTermRetentionMigrationRequestNotSupported - L’abonnement n’est pas autorisé.

  • 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 les sauvegardes LTR au sein du 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 - Target Database n’existe pas sur le serveur.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - La sauvegarde spécifiée Stockage redondance 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 l’instance managée et Azure SQL sauvegardes DB LTR.

  • 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 n’a pas pu être trouvé.

  • 404 SubscriptionDoesNotHaveServer - Le serveur demandé n’a pas été trouvé

  • 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 n’a pas été trouvée.

  • 404 LongTermRetentionMigrationBackupNotFound - La sauvegarde LTR spécifiée 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.

  • 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 les tentatives maximales ont été atteintes.

  • 500 LongTermRetentionMigrationRestoreVerFailed - Échec de la vérification de restauration.

Exemples

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=2021-08-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"
  }
}

Définitions

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 à long terme.

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

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

LongTermRetentionBackupOperationResult

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

Name 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 requête.

properties.status
  • string

État de l’opération

properties.targetBackupStorageRedundancy

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 à long terme.

Name Type Description
properties.requestedBackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée