Long Term Retention Backups - List By Resource Group Database

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Wyświetla listę wszystkich kopii zapasowych przechowywania długoterminowego dla bazy danych.

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

Z parametrami opcjonalnymi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/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
longTermRetentionDatabaseName	path	True	string	Nazwa bazy danych
longTermRetentionServerName	path	True	string	Nazwa serwera
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
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 należy wykonywać zapytania dotyczące tylko dynamicznych baz danych, po prostu usuniętych baz danych, czy wszystkich baz danych.
onlyLatestPerDatabase	query		boolean	Niezależnie od tego, czy pobrać najnowszą kopię zapasową 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 database.

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


/**
 * Samples for LongTermRetentionBackups ListByResourceGroupDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupListByDatabase.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().getLongTermRetentionBackups().listByResourceGroupDatabase(
            "testResourceGroup", "japaneast", "testserver", "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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131657960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131677960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131677960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": "2017-09-07T08:00:00Z",
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definicje

Nazwa	Opis
BackupStorageRedundancy	Typ nadmiarowości magazynu skopiowanej kopii zapasowej
databaseState	Niezależnie od tego, czy należy wykonywać zapytania dotyczące tylko dynamicznych baz danych, po prostu usuniętych baz danych, czy wszystkich baz danych.
LongTermRetentionBackup	Długoterminowe przechowywanie kopii zapasowej.
LongTermRetentionBackupListResult	Lista kopii zapasowych przechowywania długoterminowego.

BackupStorageRedundancy

Wyliczanie

Typ nadmiarowości magazynu skopiowanej kopii zapasowej

Wartość	Opis
Geo
GeoZone
Local
Zone

databaseState

Wyliczanie

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

Wartość	Opis
All
Deleted
Live