Long Term Retention Backups - Get By Resource Group

Service:

SQL Database

Version d'API:

2021-11-01

Obtient une sauvegarde de rétention à long terme.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}?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.

Réponses

Nom	Type	Description
200 OK	LongTermRetentionBackup	La sauvegarde a été récupérée avec succès.
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 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.

Exemples

Get the long term retention backup.

Exemple de requête

HTTP

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

Java

/**
 * Samples for LongTermRetentionBackups GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupGet.json
     */
    /**
     * Sample code: Get the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().getByResourceGroupWithResponse(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", com.azure.core.util.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

Exemple de réponse

Code d’état:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2017-09-06T08:00:00.000Z",
  "name": "2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;131637960820000000",
  "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
  "properties": {
    "serverName": "testserver",
    "serverCreateTime": "2017-03-10T08:00:00Z",
    "databaseName": "testDatabase",
    "databaseDeletionTime": null,
    "backupTime": "2017-09-06T08:00:00Z",
    "backupStorageRedundancy": "Geo"
  }
}

Définitions

Nom	Description
BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde copiée
LongTermRetentionBackup	Sauvegarde de rétention à long terme.

BackupStorageRedundancy

Enumeration

Type de redondance de stockage de la sauvegarde copiée

Valeur	Description
Geo
GeoZone
Local
Zone

LongTermRetentionBackup

Object

Sauvegarde de rétention à long terme.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.backupExpirationTime	string	Heure d’expiration de la sauvegarde de rétention à long terme.
properties.backupStorageRedundancy	BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde
properties.backupTime	string	Heure à laquelle la sauvegarde a été effectuée
properties.databaseDeletionTime	string	Heure de suppression de la base de données
properties.databaseName	string	Nom de la base de données à laquelle la sauvegarde appartient
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde
properties.serverCreateTime	string	Heure de création du serveur.
properties.serverName	string	Nom du serveur auquel appartient la base de données de sauvegarde.
type	string	Type de ressource.