Long Term Retention Backups - Copy By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Copiez une sauvegarde de rétention à long terme existante sur un autre serveur.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/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
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

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 correspond 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 - La fonctionnalité de migration de sauvegarde LTR n’est pas autorisée. 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 du 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 est uniquement prise en charge 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 requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes 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 LongTermRetentionMigrationRestoreVerExceededed - Échec de la vérification de la restauration après l’atteinte du nombre maximal de tentatives. 500 LongTermRetentionMigrationRestoreVerFailed - Échec de la vérification de la restauration. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. 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.

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

Java

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

/** Samples for LongTermRetentionBackups CopyByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupCopy.json
     */
    /**
     * Sample code: Copy the long term retention backup.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void copyTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().copyByResourceGroup(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000",
            new CopyLongTermRetentionBackupParameters().withTargetServerResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver2")
                .withTargetDatabaseName("testDatabase2").withTargetBackupStorageRedundancy(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": "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

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.