Long Term Retention Backups - List By Location

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Listy kopii zapasowych przechowywania długoterminowego dla danej lokalizacji.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
locationName	path	True	string	Lokalizacja bazy danych
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	LongTermRetentionBackupListResult	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.

Nazwa

Typ

Opis

200 OK

LongTermRetentionBackupListResult

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 location.

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


/**
 * Samples for LongTermRetentionBackups ListByLocation.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByLocation
     * .json
     */
    /**
     * Sample code: Get all long term retention backups under the location.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheLocation(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().listByLocation("japaneast", 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/longTermRetentionServers/testserver1/longTermRetentionDatabases/testDatabase1/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;2017-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver1",
        "serverCreateTime": "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/longTermRetentionServers/testserver2/longTermRetentionDatabases/testDatabase2/longTermRetentionBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;2017-08-30T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver2",
        "serverCreateTime": "2017-04-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/longTermRetentionServers/testserver3/longTermRetentionDatabases/testDatabase3/longTermRetentionBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;2017-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver3",
        "serverCreateTime": "2017-05-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definicje

Nazwa	Opis
BackupStorageRedundancy	Typ nadmiarowości magazynu kopii zapasowej 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.
LongTermRetentionBackup	Kopia zapasowa długoterminowego przechowywania.
LongTermRetentionBackupListResult	Lista kopii zapasowych przechowywania długoterminowego.

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej 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