Long Term Retention Managed Instance Backups - List By Database

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Listy wszystkie długoterminowe kopie zapasowe dla zarządzanej bazy danych.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa zarządzanej bazy danych.
locationName	path	True	string	Lokalizacja bazy danych.
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.
databaseState	query		databaseState	Niezależnie od tego, czy wykonywać zapytania dotyczące tylko dynamicznych baz danych, tylko usuniętych baz danych, czy wszystkich baz danych.
onlyLatestPerDatabase	query		boolean	Niezależnie od tego, czy ma być pobierana najnowsza kopia zapasowa dla każdej bazy danych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedInstanceLongTermRetentionBackupListResult	Pomyślnie pobrano listę kopii zapasowych.
Other Status Codes		Odpowiedzi na błędy: *** 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

Przykłady

Get all long term retention backups under the database.

Przykładowe żądanie

HTTP

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

Java

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

Przykładowa odpowiedź

Kod stanu:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": "2018-09-07T08:00:00Z",
        "backupTime": "2018-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definicje

Nazwa	Opis
BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej
databaseState	Niezależnie od tego, czy wykonywać zapytania dotyczące tylko dynamicznych baz danych, tylko usuniętych baz danych, czy wszystkich baz danych.
ManagedInstanceLongTermRetentionBackup	Długoterminowe przechowywanie kopii zapasowej zarządzanej bazy danych.
ManagedInstanceLongTermRetentionBackupListResult	Lista kopii zapasowych przechowywania długoterminowego dla zarządzanych baz danych.

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej

Nazwa	Typ	Opis
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Niezależnie od tego, czy wykonywać zapytania dotyczące tylko dynamicznych baz danych, tylko usuniętych baz danych, czy wszystkich baz danych.

Nazwa	Typ	Opis
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

Długoterminowe przechowywanie kopii zapasowej zarządzanej bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.backupExpirationTime	string	Czas wygaśnięcia kopii zapasowej długoterminowego przechowywania.
properties.backupStorageRedundancy	BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej
properties.backupTime	string	Czas wykonywania kopii zapasowej
properties.databaseDeletionTime	string	Czas usuwania bazy danych
properties.databaseName	string	Nazwa bazy danych, do którego należy kopia zapasowa
properties.managedInstanceCreateTime	string	Czas tworzenia wystąpienia.
properties.managedInstanceName	string	Wystąpienie zarządzane, do którego należy baza danych kopii zapasowych.
type	string	Typ zasobu.

ManagedInstanceLongTermRetentionBackupListResult

Lista kopii zapasowych przechowywania długoterminowego dla zarządzanych baz danych.

Nazwa	Typ	Opis
nextLink	string	Łącze, aby pobrać następną stronę wyników.
value	ManagedInstanceLongTermRetentionBackup[]	Tablica wyników.