Long Term Retention Backups - Get By Resource Group

Service:

SQL Database

API-versie:

2021-11-01

Hiermee wordt een back-up voor langetermijnretentie gemaakt.

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

URI-parameters

Name	In	Vereist	Type	Description
backupName	path	True	string	De naam van de back-up.
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
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.

Antwoorden

Name	Type	Description
200 OK	LongTermRetentionBackup	De back-up is opgehaald.
Other Status Codes		Foutreacties: *** 400 InvalidLongTermRetentionBackupId - Ongeldige back-up-id voor langetermijnretentie voor SQL DB's. 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter. 400 LongTermRetentionMismatchingSubscriptionId - De opgegeven abonnements-id kwam niet overeen met de id in de andere invoer 400 LongTermRetentionMismatchingResourceGroupName - De opgegeven resourcegroepnaam komt niet overeen met de naam in de andere invoer 400 LongTermRetentionMismatchingServerName - De opgegeven servernaam komt niet overeen met de naam in de andere invoer 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ResourceNotFound - De aangevraagde resource is niet gevonden.

Voorbeelden

Get the long term retention backup.

Voorbeeldaanvraag

HTTP

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

Java

/**
 * Samples for LongTermRetentionBackups GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupGet.json
     */
    /**
     * Sample code: Get the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().getByResourceGroupWithResponse(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", 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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2017-09-06T08:00:00.000Z",
  "name": "2017-03-10T08:00:00.000Z;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-09-06T08:00:00Z",
    "backupStorageRedundancy": "Geo"
  }
}

Definities

Name	Description
BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
LongTermRetentionBackup	Een back-up voor langetermijnretentie.

BackupStorageRedundancy

Enumeration

Het type opslagredundantie van de gekopieerde back-up

Waarde	Description
Geo
GeoZone
Local
Zone

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.