Backup Short Term Retention Policies - Create Or Update

Service:

SQL Database

API-versie:

2021-11-01

Hiermee werkt u het bewaarbeleid voor de korte termijn van een database bij.

PUT 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 (int32)	Het differentiële back-upinterval in uren. Dit is het aantal intervaluren tussen elke differentiële back-up. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.
properties.retentionDays	integer (int32)	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 aan een parameter gegeven. 400 InvalidBackupRetentionPeriod: de retentiedagen van {0} is geen geldige configuratie. Geldige back-upretentie in dagen moet tussen {1} en {2} 400 InvalidDiffBackupIntervalHours - De differentiële back-upintervaluren van {0} is geen geldige configuratie. Geldig differentiële back-upinterval moet {1} uur zijn. 400 FeatureDisabledOnSelectedEdition - Gebruiker heeft geprobeerd een functie te gebruiken die is uitgeschakeld voor de huidige database-editie. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup - 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 u beschikt niet over machtigingen 409 ConflictingDatabaseOperation: er is al een bewerking in 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 buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen buiten het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 503 TooManyRequests : aanvragen die buiten het maximum aantal aanvragen kunnen 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

PUT 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 CreateOrUpdate.
 */
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().createOrUpdate(
            "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 bewaarbeleid voor korte termijn.
DiffBackupIntervalInHours	Het differentiële back-upinterval in uren. Dit is het aantal intervaluren tussen elke differentiële back-up. Dit is alleen van toepassing op livedatabases, maar niet op verwijderde databases.
ShortTermRetentionPolicyName	De naam van het beleid. Moet altijd 'standaard' zijn.

BackupShortTermRetentionPolicy

Object

Een bewaarbeleid voor korte termijn.

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

DiffBackupIntervalInHours

Inventarisatie

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

Waarde	Description
12
24

ShortTermRetentionPolicyName

Inventarisatie

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

Waarde	Description
default