Long Term Retention Backups - Update By Resource Group

Service:

SQL Database

API-versie:

2021-11-01

Updates een bestaande langetermijnretentieback-up.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}/update?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.

Aanvraagbody

Name	Type	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up

Antwoorden

Name	Type	Description
200 OK	LongTermRetentionBackupOperationResult	De back-up is bijgewerkt.
202 Accepted		De back-up wordt bijgewerkt.
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 400 LongTermRetentionMigrationRequestNotSupported - Abonnement is niet toegestaan LTR-back-upmigratiefunctie. 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - Bron- en doelabonnementen mogen niet communiceren voor de LTR-back-upkopiefunctie. 400 LongTermRetentionMigrationParameterMissing - Vereiste parameter ontbreekt voor de bewerking. 400 LongTermRetentionMigrationSameServerNotSupported - LTR Copy-functie wordt niet ondersteund voor het kopiëren van LTR-back-ups binnen dezelfde server. 400 LongTermRetentionMigrationTargetServerNotFound - Doelserver bestaat niet of is niet gereed voor LTR-back-upkopiebewerking. 400 LongTermRetentionMigrationTargetDatabaseNotFound - Doeldatabase bestaat niet op de server. 400 LongTermRetentionMigrationStorageTypeNotSupported - Opgegeven redundantie voor back-upopslag wordt niet ondersteund in de doelregio. 400 LongTermRetentionMigrationStorageMismatch - Actieve back-upredundantie van database komt niet overeen met back-upredundantie die door de klant is aangevraagd. 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR-migratie wordt alleen ondersteund voor beheerde exemplaren en Azure SQL DB LTR-back-ups. 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - Het wijzigen van de redundantie van back-upopslag is niet toegestaan voor LTR-kopieerbewerkingen. 400 LongTermRetentionMigrationSubscriptionNotFound : het abonnement kan niet worden gevonden. 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. 404 LongTermRetentionMigrationBackupNotFound - OPGEGEVEN LTR-back-up bestaat niet. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 LongTermRetentionMigrationRequestConflict - Er wordt nog steeds een conflictbewerking uitgevoerd op deze LTR-back-up. 409 LongTermRetentionMigrationBackupConflict : er bestaat nog een LTR-back-up met dezelfde back-uptijd voor de doeldatabase. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - Kan de LTR-back-upkopieaanvraag niet starten in de doelregio. 500 LongTermRetentionMigrationRequestCopyFailed - Kopieerbewerking is mislukt voor LTR-back-upblobs. 500 LongTermRetentionMigrationRestoreVerExceeded - Herstelverificatie is mislukt nadat het maximum aantal pogingen is bereikt. 500 LongTermRetentionMigrationRestoreVerFailed - Herstelverificatie is mislukt. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Update the long term retention backup.

Voorbeeldaanvraag

HTTP

POST 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/update?api-version=2021-11-01

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

Java

import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.UpdateLongTermRetentionBackupParameters;

/**
 * Samples for LongTermRetentionBackups UpdateByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupUpdate.json
     */
    /**
     * Sample code: Update the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void updateTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups()
            .updateByResourceGroup("testResourceGroup", "japaneast", "testserver", "testDatabase",
                "55555555-6666-7777-8888-999999999999;131637960820000000", new UpdateLongTermRetentionBackupParameters()
                    .withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO),
                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/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

Statuscode:

202

Definities

Name	Description
BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
LongTermRetentionBackupOperationResult	Een longtermRetentionBackup-bewerking resultaatresource.
UpdateLongTermRetentionBackupParameters	Bevat de informatie die nodig is om een back-upbewerking voor langetermijnretentie uit te voeren.

BackupStorageRedundancy

Enumeration

Het type opslagredundantie van de gekopieerde back-up

Waarde	Description
Geo
GeoZone
Local
Zone

LongTermRetentionBackupOperationResult

Object

Een longtermRetentionBackup-bewerking resultaatresource.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.fromBackupResourceId	string	Resource-id van bronback-up
properties.message	string	Voortgangsbericht
properties.operationType	string	Bewerkingstype.
properties.requestId	string	Aanvraag-id.
properties.status	string	Bewerkingsstatus
properties.targetBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up
properties.toBackupResourceId	string	Resource-id van doelback-up
type	string	Resourcetype.

UpdateLongTermRetentionBackupParameters

Object

Bevat de informatie die nodig is om een back-upbewerking voor langetermijnretentie uit te voeren.

Name	Type	Description
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Het type opslagredundantie van de gekopieerde back-up