Managed Instance Long Term Retention Policies - Create Or Update

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Ustawia zasady długoterminowego przechowywania zarządzanej bazy danych.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
policyName	path	True	ManagedInstanceLongTermRetentionPolicyName	Nazwa zasad. Zawsze powinna mieć wartość Domyślna.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.monthlyRetention	string	Zasady przechowywania miesięcznego kopii zapasowej LTR w formacie ISO 8601.
properties.weekOfYear	integer	Tydzień roku do wykonania rocznej kopii zapasowej w formacie ISO 8601.
properties.weeklyRetention	string	Zasady przechowywania tygodniowego kopii zapasowej LTR w formacie ISO 8601.
properties.yearlyRetention	string	Roczne zasady przechowywania kopii zapasowej LTR w formacie ISO 8601.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedInstanceLongTermRetentionPolicy	Pomyślnie ustawiono zasady LTR dla zarządzanej bazy danych.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe. 400 InvalidParameterValue — podano nieprawidłową wartość dla parametru. 400 LongTermRetentionMissingWeekOfYear — WeekOfYear jest wymagany do ustawienia między 1 a 52, aby ustawić przechowywanie roczne. 400 LTRNotSupportedForPerDBCMK — długoterminowe przechowywanie kopii zapasowych nie jest obsługiwane w przypadku skonfigurowania klucza zarządzanego na poziomie bazy danych w wersji zapoznawczej. 400 LongTermRetentionPolicyNotSupported — długoterminowe przechowywanie nie jest obsługiwane w tej bazie danych. 400 LongTermRetentionPolicyInvalid — zasady przechowywania długoterminowego są nieprawidłowe. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Create or update the LTR policy for the managed database.

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/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.ManagedInstanceLongTermRetentionPolicyInner;
import com.azure.resourcemanager.sql.models.ManagedInstanceLongTermRetentionPolicyName;

/**
 * Samples for ManagedInstanceLongTermRetentionPolicies CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionPolicyCreateOrUpdate.json
     */
    /**
     * Sample code: Create or update the LTR policy for the managed database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateTheLTRPolicyForTheManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceLongTermRetentionPolicies().createOrUpdate(
            "testResourceGroup", "testInstance", "testDatabase", ManagedInstanceLongTermRetentionPolicyName.DEFAULT,
            new ManagedInstanceLongTermRetentionPolicyInner().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

Przykładowa odpowiedź

Kod stanu:

200

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

Kod stanu:

202

Definicje

Nazwa	Opis
ManagedInstanceLongTermRetentionPolicy	Zasady przechowywania długoterminowego.
ManagedInstanceLongTermRetentionPolicyName	Nazwa zasad. Zawsze powinna mieć wartość Domyślna.

ManagedInstanceLongTermRetentionPolicy

Zasady przechowywania długoterminowego.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.monthlyRetention	string	Zasady przechowywania miesięcznego kopii zapasowej LTR w formacie ISO 8601.
properties.weekOfYear	integer	Tydzień roku do wykonania rocznej kopii zapasowej w formacie ISO 8601.
properties.weeklyRetention	string	Zasady przechowywania tygodniowego kopii zapasowej LTR w formacie ISO 8601.
properties.yearlyRetention	string	Roczne zasady przechowywania kopii zapasowej LTR w formacie ISO 8601.
type	string	Typ zasobu.

ManagedInstanceLongTermRetentionPolicyName

Nazwa zasad. Zawsze powinna mieć wartość Domyślna.

Nazwa	Typ	Opis
default	string