Long Term Retention Policies - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Beállítja egy adatbázis hosszú távú adatmegőrzési szabályzatát.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
databaseName	path	True	string	Az adatbázis neve.
policyName	path	True	LongTermRetentionPolicyName	A szabályzat neve. Mindig az Alapértelmezett értéknek kell lennie.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használandó API-verzió.

Kérelem törzse

Name	Típus	Description
properties.monthlyRetention	string	Az ISO 8601 formátumú LTR biztonsági mentések havi adatmegőrzési szabályzata.
properties.weekOfYear	integer	Az éves biztonsági mentés ISO 8601 formátumban történő készítésének hetét.
properties.weeklyRetention	string	Az LTR biztonsági mentés heti adatmegőrzési szabályzata ISO 8601 formátumban.
properties.yearlyRetention	string	Az iso 8601 formátumú LTR biztonsági mentések éves adatmegőrzési szabályzata.

Válaszok

Name	Típus	Description
200 OK	LongTermRetentionPolicy	A szabályzat beállítása sikerült.
202 Accepted		Elfogadva
Other Status Codes		Hibaválaszok: *** 400 InvalidResourceRequestBody – A kérelemtörzsben lévő erőforrás- vagy erőforrástulajdonságok üresek vagy érvénytelenek. 400 InvalidParameterValue – Érvénytelen érték lett megadva egy paraméternek. A 400 LongTermRetentionMissingWeekOfYear – WeekOfYear értéket 1 és 52 között kell beállítani az éves megőrzés beállításához. 400 LTRNotSupportedForPerDBCMK – A biztonsági másolatok hosszú távú megőrzése nem támogatott, ha az adatbázisszintű CMK előzetes verzióban van konfigurálva. 400 LongTermRetentionPolicyNotSupported – A hosszú távú megőrzés nem támogatott ezen az adatbázison. 400 LongTermRetentionPolicyInvalid – A hosszú távú adatmegőrzési szabályzat érvénytelen. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és előfizetésben. 404 ResourceNotFound – A kért erőforrás nem található. 404 OperationIdNotFound – Az azonosítóval rendelkező művelet nem létezik. 409 OperationCancelled – A felhasználó megszakította a műveletet. 409 OperationInterrupted – Az erőforráson végzett művelet nem hajtható végre, mert egy másik művelet megszakította ugyanazon az erőforráson. 429 SubscriptionTooManyCreateUpdateRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 429 SubscriptionTooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések. 500 OperationTimedOut – A művelet túllépte az időkorlátot, és automatikusan visszagördült. Please retry the operation. 503 TooManyRequests – Az elérhető erőforrások által feldolgozható maximális kéréseken túli kérések.

Példák

Create or update the long term retention policy for the database.

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.LongTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.LongTermRetentionPolicyName;

/** Samples for LongTermRetentionPolicies CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyCreateOrUpdate
     * .json
     */
    /**
     * Sample code: Create or update the long term retention policy for the database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateTheLongTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionPolicies().createOrUpdate("resourceGroup",
            "testserver", "testDatabase", LongTermRetentionPolicyName.DEFAULT, new LongTermRetentionPolicyInner()
                .withWeeklyRetention("P1M").withMonthlyRetention("P1Y").withYearlyRetention("P5Y").withWeekOfYear(5),
            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

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

Status code:

202

Definíciók

Name	Description
LongTermRetentionPolicy	Hosszú távú adatmegőrzési szabályzat.
LongTermRetentionPolicyName	A szabályzat neve. Mindig az Alapértelmezett értéknek kell lennie.

LongTermRetentionPolicy

Hosszú távú adatmegőrzési szabályzat.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.monthlyRetention	string	Az ISO 8601 formátumú LTR biztonsági mentések havi adatmegőrzési szabályzata.
properties.weekOfYear	integer	Az éves biztonsági mentés ISO 8601 formátumban történő készítésének hetét.
properties.weeklyRetention	string	Az LTR biztonsági mentés heti adatmegőrzési szabályzata ISO 8601 formátumban.
properties.yearlyRetention	string	Az iso 8601 formátumú LTR biztonsági mentések éves adatmegőrzési szabályzata.
type	string	Erőforrástípus.

LongTermRetentionPolicyName

A szabályzat neve. Mindig az Alapértelmezett értéknek kell lennie.

Name	Típus	Description
default	string