Long Term Retention Backups - List By Resource Group 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}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionBackups?api-version=2021-11-01

Met optionele parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/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
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionBackups?api-version=2021-11-01


/**
 * Samples for LongTermRetentionBackups ListByResourceGroupServer.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupListByServer.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().listByResourceGroupServer(
            "testResourceGroup", "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/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/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 Resource Group Server

URI-parameters

Antwoorden

Voorbeelden

Get all long term retention backups under the server.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

BackupStorageRedundancy

databaseState

LongTermRetentionBackup

LongTermRetentionBackupListResult

Aanvullende resources