Managed Instance Long Term Retention Policies - List By Database

Service:

SQL Database

API Version:

2021-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupLongTermRetentionPolicies?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
managedInstanceName	path	True	string	Nom de l'instance managée.
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	ManagedInstanceLongTermRetentionPolicyListResult	La stratégie LTR pour la base de données managée a été correctement obtenue.
Other Status Codes		Réponses d’erreur : *** 400 LTRNotSupportedForPerDBCMK : la rétention des sauvegardes à long terme n’est pas prise en charge lorsque la clé CMK au niveau de la base de données est configurée en préversion. 400 LongTermRetentionPolicyNotSupported : la rétention à long terme n’est pas prise en charge sur cette base de données. 400 LongTermRetentionPolicyInvalid : la stratégie de rétention à long terme n’est pas valide. 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 policies for the managed database.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for ManagedInstanceLongTermRetentionPolicies ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionPolicyListByDatabase.json
     */
    /**
     * Sample code: Get the long term retention policies for the managed database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPoliciesForTheManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceLongTermRetentionPolicies()
            .listByDatabase("testResourceGroup", "testInstance", "testDatabase", 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

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies/default",
      "name": "default",
      "type": "Microsoft.Sql/resourceGroups/managedInstances/databases/backupLongTermRetentionPolicies",
      "properties": {
        "weeklyRetention": "P1M",
        "monthlyRetention": "P1Y",
        "yearlyRetention": "P5Y",
        "weekOfYear": 5
      }
    }
  ]
}

Définitions

Nom	Description
ManagedInstanceLongTermRetentionPolicy	Stratégie de rétention à long terme.
ManagedInstanceLongTermRetentionPolicyListResult	Liste des stratégies de rétention à long terme.

ManagedInstanceLongTermRetentionPolicy

Stratégie de rétention à long terme.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.monthlyRetention	string	Stratégie de rétention mensuelle pour une sauvegarde LTR au format ISO 8601.
properties.weekOfYear	integer	Semaine de l’année pour effectuer la sauvegarde annuelle au format ISO 8601.
properties.weeklyRetention	string	Stratégie de rétention hebdomadaire pour une sauvegarde LTR au format ISO 8601.
properties.yearlyRetention	string	Stratégie de rétention annuelle pour une sauvegarde LTR au format ISO 8601.
type	string	Type de ressource.

ManagedInstanceLongTermRetentionPolicyListResult

Liste des stratégies de rétention à long terme.

Nom	Type	Description
nextLink	string	Lien pour récupérer la page de résultats suivante.
value	ManagedInstanceLongTermRetentionPolicy[]	Tableau de résultats.