Long Term Retention Backups - List By Server

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Lijsten de langetermijnretentieback-ups voor een bepaalde server.

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

Met optionele parameters:

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

URI-parameters

Name	In	Vereist	Type	Description
locationName	path	True	string	De locatie van de database
longTermRetentionServerName	path	True	string	De naam van de server
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.
databaseState	query		databaseState	Of u nu query's wilt uitvoeren op alleen livedatabases, alleen verwijderde databases of alle databases.
onlyLatestPerDatabase	query		boolean	Of u alleen de meest recente back-up voor elke database wilt ophalen.

Antwoorden

Name	Type	Description
200 OK	LongTermRetentionBackupListResult	De lijst met back-ups is opgehaald.
Other Status Codes		Foutreacties: *** 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

Name

Type

Description

200 OK

LongTermRetentionBackupListResult

De lijst met back-ups is opgehaald.

Other Status Codes

Foutreacties: ***

404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden
404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement.

Voorbeelden

Get all long term retention backups under the server.

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


/**
 * Samples for LongTermRetentionBackups ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByServer.
     * json
     */
    /**
     * Sample code: Get all long term retention backups under the server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().listByServer("japaneast",
            "testserver", 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

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase1/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": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase2/longTermRetentionBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "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/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase3/longTermRetentionBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definities

Name	Description
BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
databaseState	Of u nu query's wilt uitvoeren op alleen livedatabases, alleen verwijderde databases of alle databases.
LongTermRetentionBackup	Een back-up voor langetermijnretentie.
LongTermRetentionBackupListResult	Een lijst met back-ups voor langetermijnretentie.

BackupStorageRedundancy

Enumeration

Het type opslagredundantie van de gekopieerde back-up

Waarde	Description
Geo
GeoZone
Local
Zone

databaseState

Enumeration

Of u nu query's wilt uitvoeren op alleen livedatabases, alleen verwijderde databases of alle databases.

Waarde	Description
All
Deleted
Live

LongTermRetentionBackup

Object

Een back-up voor langetermijnretentie.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.backupExpirationTime	string	De tijd waarop de back-up voor langetermijnretentie verloopt.
properties.backupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de back-up
properties.backupTime	string	Het tijdstip waarop de back-up is gemaakt
properties.databaseDeletionTime	string	De verwijdertijd van de database
properties.databaseName	string	De naam van de database waartoe de back-up behoort
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de back-up
properties.serverCreateTime	string	De aan te maken tijd van de server.
properties.serverName	string	De servernaam waartoe de back-updatabase behoort.
type	string	Resourcetype.

LongTermRetentionBackupListResult

Object

Een lijst met back-ups voor langetermijnretentie.

Name	Type	Description
nextLink	string	Koppeling om de volgende pagina met resultaten op te halen.
value	LongTermRetentionBackup[]	Matrix met resultaten.

Delen via

Long Term Retention Backups - List By Server

URI-parameters

Antwoorden

Voorbeelden

Get all long term retention backups under the server.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BackupStorageRedundancy

databaseState

LongTermRetentionBackup

LongTermRetentionBackupListResult

Aanvullende resources