Long Term Retention Policies - Create Or Update

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Nastaví zásady dlouhodobého uchovávání dat databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
policyName	path	True	LongTermRetentionPolicyName	Název zásady. Měla by být vždy výchozí.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Typ	Description
properties.monthlyRetention	string	Zásady měsíčního uchovávání záloh LTR ve formátu ISO 8601.
properties.weekOfYear	integer (int32)	Týden roku pro roční zálohování ve formátu ISO 8601.
properties.weeklyRetention	string	Týdenní zásady uchovávání informací pro zálohování LTR ve formátu ISO 8601.
properties.yearlyRetention	string	Roční zásady uchovávání informací pro zálohování LTR ve formátu ISO 8601.

Odpovědi

Name	Typ	Description
200 OK	LongTermRetentionPolicy	Zásady se úspěšně nastavily.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidResourceRequestBody – vlastnost prostředku nebo prostředku v textu požadavku je prázdná nebo neplatná. 400 InvalidParameterValue – Parametr dostal neplatnou hodnotu. 400 LongTermRetentionMissingWeekOfYear - WeekOfYear je nutné nastavit mezi 1 a 52, aby bylo možné nastavit roční uchovávání. 400 LTRNotSupportedForPerDBCMK – Dlouhodobé uchovávání záloh se nepodporuje, pokud je klíč CMK na úrovni databáze nakonfigurovaný ve verzi Preview. 400 LongTermRetentionPolicyNotSupported – U této databáze není podporováno dlouhodobé uchovávání. 400 LongTermRetentionPolicyInvalid – Zásady dlouhodobého uchovávání jsou neplatné. 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled - Operace byla zrušena uživatelem. 409 OperationInterrupted – operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací na stejném prostředku. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat. 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Ukázkový požadavek

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.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),
            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

Ukázková odpověď

Stavový kód:

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
  }
}

Stavový kód:

202

Definice

Name	Description
LongTermRetentionPolicy	Zásady dlouhodobého uchovávání informací.
LongTermRetentionPolicyName	Název zásady. Měla by být vždy výchozí.

LongTermRetentionPolicy

Objekt

Zásady dlouhodobého uchovávání informací.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku
properties.monthlyRetention	string	Zásady měsíčního uchovávání záloh LTR ve formátu ISO 8601.
properties.weekOfYear	integer (int32)	Týden roku pro roční zálohování ve formátu ISO 8601.
properties.weeklyRetention	string	Týdenní zásady uchovávání informací pro zálohování LTR ve formátu ISO 8601.
properties.yearlyRetention	string	Roční zásady uchovávání informací pro zálohování LTR ve formátu ISO 8601.
type	string	Typ zdroje.

LongTermRetentionPolicyName

Výčet

Název zásady. Měla by být vždy výchozí.

Hodnota	Description
default