Partager via


Long Term Retention Backups - Copy

Copiez 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}/copy?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.targetBackupStorageRedundancy

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

properties.targetDatabaseName

string

Le nom de la base de données est propriétaire de la sauvegarde copiée.

properties.targetResourceGroup

string

Groupe de ressources propriétaire du serveur cible

properties.targetServerFullyQualifiedDomainName

string

Nom de domaine complet du serveur cible

properties.targetServerResourceId

string

ID de ressource du serveur cible propriétaire de la base de données

properties.targetSubscriptionId

string

Abonnement propriétaire du serveur cible

Réponses

Nom Type Description
200 OK

LongTermRetentionBackupOperationResult

Copie réussie de la sauvegarde.

202 Accepted

La copie 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

Copy the long term retention backup.

Exemple de requête

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

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

Exemple de réponse

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

Définitions

Nom Description
BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

CopyLongTermRetentionBackupParameters

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

LongTermRetentionBackupOperationResult

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

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

Nom Type Description
Geo

string

GeoZone

string

Local

string

Zone

string

CopyLongTermRetentionBackupParameters

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

Nom Type Description
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde copiée

properties.targetDatabaseName

string

Le nom de la base de données est propriétaire de la sauvegarde copiée.

properties.targetResourceGroup

string

Groupe de ressources propriétaire du serveur cible

properties.targetServerFullyQualifiedDomainName

string

Nom de domaine complet du serveur cible

properties.targetServerResourceId

string

ID de ressource du serveur cible propriétaire de la base de données

properties.targetSubscriptionId

string

Abonnement propriétaire du serveur cible

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.