Long Term Retention Backups - List By Server

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Listor säkerhetskopior av långsiktig kvarhållning för en viss server.

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

Med valfria parametrar:

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-parametrar

Name	I	Obligatorisk	Typ	Description
locationName	path	True	string	Platsen för databasen
longTermRetentionServerName	path	True	string	Namnet på servern
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.
databaseState	query		databaseState	Om du bara vill fråga mot live-databaser, bara borttagna databaser eller alla databaser.
onlyLatestPerDatabase	query		boolean	Om du bara vill få den senaste säkerhetskopian för varje databas eller inte.

Svar

Name	Typ	Description
200 OK	LongTermRetentionBackupListResult	Listan över säkerhetskopior har hämtats.
Other Status Codes		Felsvar: *** 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

Name

Typ

Description

200 OK

LongTermRetentionBackupListResult

Listan över säkerhetskopior har hämtats.

Other Status Codes

Felsvar: ***

404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte
404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

Exempel

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

Exempelsvar

Statuskod:: 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"
      }
    }
  ]
}

Definitioner

Name	Description
BackupStorageRedundancy	Lagringsredundanstypen för den kopierade säkerhetskopian
databaseState	Om du bara vill fråga mot live-databaser, bara borttagna databaser eller alla databaser.
LongTermRetentionBackup	En långsiktig kvarhållningssäkerhetskopia.
LongTermRetentionBackupListResult	En lista över säkerhetskopior av långsiktig kvarhållning.

BackupStorageRedundancy

Lagringsredundanstypen för den kopierade säkerhetskopian

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Om du bara vill fråga mot live-databaser, bara borttagna databaser eller alla databaser.

Name	Typ	Description
All	string
Deleted	string
Live	string

LongTermRetentionBackup

En långsiktig kvarhållningssäkerhetskopia.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.backupExpirationTime	string	Den tid som säkerhetskopieringen av långsiktig kvarhållning upphör att gälla.
properties.backupStorageRedundancy	BackupStorageRedundancy	Lagringsredundanstypen för säkerhetskopieringen
properties.backupTime	string	Den tid då säkerhetskopieringen gjordes
properties.databaseDeletionTime	string	Borttagningstiden för databasen
properties.databaseName	string	Namnet på databasen som säkerhetskopian tillhör
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Lagringsredundanstypen för säkerhetskopieringen
properties.serverCreateTime	string	Serverns skapandetid.
properties.serverName	string	Servernamnet som säkerhetskopieringsdatabasen tillhör.
type	string	Resurstyp.

LongTermRetentionBackupListResult

En lista över säkerhetskopior av långsiktig kvarhållning.

Name	Typ	Description
nextLink	string	Länk för att hämta nästa sida med resultat.
value	LongTermRetentionBackup[]	Matris med resultat.

Dela via

Long Term Retention Backups - List By Server

URI-parametrar

Svar

Exempel

Get all long term retention backups under the server.

Exempelbegäran

Exempelsvar

Definitioner

BackupStorageRedundancy

databaseState

LongTermRetentionBackup

LongTermRetentionBackupListResult

Ytterligare resurser