Long Term Retention Managed Instance Backups - List By Instance

Référence

Service:: SQL Database

API Version:: 2021-11-01

Listes les sauvegardes de rétention à long terme pour un instance managé donné.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2021-11-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
locationName	path	True	string	Emplacement de la base de données
managedInstanceName	path	True	string	Nom de l'instance managée.
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.
databaseState	query		databaseState	Indique s’il faut interroger uniquement les bases de données actives, les bases de données supprimées ou toutes les bases de données.
onlyLatestPerDatabase	query		boolean	Indique s’il faut ou non uniquement obtenir la dernière sauvegarde pour chaque base de données.

Réponses

Nom	Type	Description
200 OK	ManagedInstanceLongTermRetentionBackupListResult	La liste des sauvegardes a été récupérée.
Other Status Codes		Réponses d’erreur : *** 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.

Nom

Type

Description

200 OK

ManagedInstanceLongTermRetentionBackupListResult

La liste des sauvegardes a été récupérée.

Other Status Codes

Réponses d’erreur : ***

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.

Exemples

Get all long term retention backups under the managed instance.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2021-11-01


import com.azure.core.util.Context;

/** Samples for LongTermRetentionManagedInstanceBackups ListByInstance. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionBackupListByInstance.json
     */
    /**
     * Sample code: Get all long term retention backups under the managed instance.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByInstance("japaneast", "testInstance", null, null, 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/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Définitions

Nom	Description
BackupStorageRedundancy	Type de redondance de stockage de la sauvegarde
databaseState	Indique s’il faut interroger uniquement les bases de données actives, les bases de données supprimées ou toutes les bases de données.
ManagedInstanceLongTermRetentionBackup	Sauvegarde de rétention à long terme pour une base de données managée.
ManagedInstanceLongTermRetentionBackupListResult	Liste des sauvegardes de rétention à long terme pour les bases de données managées.

BackupStorageRedundancy

Type de redondance de stockage de la sauvegarde

Nom	Type	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Indique s’il faut interroger uniquement les bases de données actives, les bases de données supprimées ou toutes les bases de données.

Nom	Type	Description
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

Sauvegarde de rétention à long terme pour une base de données managée.

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.managedInstanceCreateTime	string	Heure de création du instance.
properties.managedInstanceName	string	Le instance managé auquel appartient la base de données de sauvegarde.
type	string	Type de ressource.

ManagedInstanceLongTermRetentionBackupListResult

Liste des sauvegardes de rétention à long terme pour les bases de données managées.

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

Share via

Long Term Retention Managed Instance Backups - List By Instance

Paramètres URI

Réponses

Exemples

Get all long term retention backups under the managed instance.

Sample Request

Sample Response

Définitions

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

Ressources supplémentaires