Long Term Retention Backups - List By Database

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Lijsten alle langetermijnretentieback-ups voor een database.

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

Met optionele parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/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
longTermRetentionDatabaseName	path	True	string	De naam 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 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 database.

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


/**
 * Samples for LongTermRetentionBackups ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByDatabase
     * .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().listByDatabase("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

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/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/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/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"
      }
    }
  ]
}

Definities

Name	Description
BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
databaseState	Of u 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 van langetermijnretentie.

BackupStorageRedundancy

Enumeration

Het type opslagredundantie van de gekopieerde back-up

Waarde	Description
Geo
GeoZone
Local
Zone

databaseState

Enumeration

Of u 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 langetermijnretentieback-up 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 verwijderingstijd 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 tijd waarop de server wordt gemaakt.
properties.serverName	string	De servernaam waartoe de back-updatabase behoort.
type	string	Resourcetype.

LongTermRetentionBackupListResult

Object

Een lijst met back-ups van 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 Database

URI-parameters

Antwoorden

Voorbeelden

Get all long term retention backups under the database.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BackupStorageRedundancy

databaseState

LongTermRetentionBackup

LongTermRetentionBackupListResult

Aanvullende resources