Backup Short Term Retention Policies - Update

Service:

SQL Database

API-versie:

2021-11-01

Updates het kortetermijnretentiebeleid van een database.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
policyName	path	True	ShortTermRetentionPolicyName	De naam van het beleid. Moet altijd 'standaard' zijn.
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.
serverName	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.

Aanvraagbody

Name	Type	Description
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Het differentiële back-upinterval in uren. Dit is hoeveel intervaluren tussen elke differentiële back-up worden ondersteund. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.
properties.retentionDays	integer	De bewaarperiode voor back-ups in dagen. Dit is het aantal dagen dat herstel naar een bepaald tijdstip wordt ondersteund.

Antwoorden

Name	Type	Description
200 OK	BackupShortTermRetentionPolicy	Het beleid is bijgewerkt.
202 Accepted		Geaccepteerd
Other Status Codes		Foutreacties: *** 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter. 400 InvalidBackupRetentionPeriod - De retentiedagen van {0} is geen geldige configuratie. Geldige back-upretentie in dagen moet tussen {1} en {2} 400 InvalidDiffBackupIntervalHours - Het differentiële back-upintervaluren van {0} is geen geldige configuratie. Het geldige interval voor differentiële back-ups moet uren zijn {1} . 400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld in de huidige database-editie. 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 SourceDatabaseNotFound - De brondatabase bestaat niet. 404 CannotFindObject - Kan het object niet vinden omdat het niet bestaat of omdat u geen machtigingen hebt 409 ConflictingDatabaseOperation - Er is al een bewerking op de database en de huidige bewerking moet wachten totdat deze is voltooid. 409 ConflictingSystemOperationInProgress - Er wordt een systeemonderhoudsbewerking uitgevoerd op de database en verdere bewerkingen moeten wachten totdat deze is voltooid. 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. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

Update the short term retention policy for the database.

Voorbeeldaanvraag

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.BackupShortTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.DiffBackupIntervalInHours;
import com.azure.resourcemanager.sql.models.ShortTermRetentionPolicyName;

/**
 * Samples for BackupShortTermRetentionPolicies Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/UpdateShortTermRetentionPolicy.json
     */
    /**
     * Sample code: Update the short term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updateTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getBackupShortTermRetentionPolicies().update("resourceGroup",
            "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT, new BackupShortTermRetentionPolicyInner()
                .withRetentionDays(7).withDiffBackupIntervalInHours(DiffBackupIntervalInHours.TWO_FOUR),
            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/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Statuscode:

202

Definities

Name	Description
BackupShortTermRetentionPolicy	Een kortetermijnretentiebeleid.
DiffBackupIntervalInHours	Het differentiële back-upinterval in uren. Dit is hoeveel intervaluren tussen elke differentiële back-up worden ondersteund. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.
ShortTermRetentionPolicyName	De naam van het beleid. Moet altijd 'standaard' zijn.

BackupShortTermRetentionPolicy

Een kortetermijnretentiebeleid.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Het differentiële back-upinterval in uren. Dit is hoeveel intervaluren tussen elke differentiële back-up worden ondersteund. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.
properties.retentionDays	integer	De bewaarperiode voor back-ups in dagen. Dit is het aantal dagen dat herstel naar een bepaald tijdstip wordt ondersteund.
type	string	Resourcetype.

DiffBackupIntervalInHours

Het differentiële back-upinterval in uren. Dit is hoeveel intervaluren tussen elke differentiële back-up worden ondersteund. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.

Name	Type	Description
12	string
24	string

ShortTermRetentionPolicyName

De naam van het beleid. Moet altijd 'standaard' zijn.

Name	Type	Description
default	string