Backup Short Term Retention Policies - Get

Service:

SQL Database

Version d'API:

2021-11-01

Obtient la stratégie de rétention à court terme d’une base de données.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
policyName	path	True	ShortTermRetentionPolicyName	Nom de la stratégie. Doit toujours être « par défaut ».
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.
serverName	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.

Réponses

Nom	Type	Description
200 OK	BackupShortTermRetentionPolicy	La stratégie a été récupérée avec succès.
Other Status Codes		Réponses d’erreur : *** 400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre. 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 short term retention policy for the database.

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Java

import com.azure.resourcemanager.sql.models.ShortTermRetentionPolicyName;

/**
 * Samples for BackupShortTermRetentionPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/GetShortTermRetentionPolicy.json
     */
    /**
     * Sample code: Get the short term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getBackupShortTermRetentionPolicies().getWithResponse(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT,
            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/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Définitions

Nom	Description
BackupShortTermRetentionPolicy	Stratégie de rétention à court terme.
DiffBackupIntervalInHours	Intervalle de sauvegarde différentielle en heures. Il s’agit du nombre d’heures d’intervalle entre chaque sauvegarde différentielle qui sera pris en charge. Cela s’applique uniquement aux bases de données actives, mais pas aux bases de données supprimées.
ShortTermRetentionPolicyName	Nom de la stratégie. Doit toujours être « par défaut ».

BackupShortTermRetentionPolicy

Stratégie de rétention à court terme.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Intervalle de sauvegarde différentielle en heures. Il s’agit du nombre d’heures d’intervalle entre chaque sauvegarde différentielle qui sera pris en charge. Cela s’applique uniquement aux bases de données actives, mais pas aux bases de données supprimées.
properties.retentionDays	integer	Période de rétention de la sauvegarde, en jours. Il s’agit du nombre de jours pendant lesquels la restauration dans le temps sera prise en charge.
type	string	Type de ressource.

DiffBackupIntervalInHours

Intervalle de sauvegarde différentielle en heures. Il s’agit du nombre d’heures d’intervalle entre chaque sauvegarde différentielle qui sera pris en charge. Cela s’applique uniquement aux bases de données actives, mais pas aux bases de données supprimées.

Nom	Type	Description
12	string
24	string

ShortTermRetentionPolicyName

Nom de la stratégie. Doit toujours être « par défaut ».

Nom	Type	Description
default	string