Managed Instance Long Term Retention Policies - List By Database

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Pobiera zasady długoterminowego przechowywania bazy danych.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupLongTermRetentionPolicies?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.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure 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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedInstanceLongTermRetentionPolicyListResult	Pomyślnie zostały wykonane zasady LTR dla zarządzanej bazy danych.
Other Status Codes		Odpowiedzi na błędy: *** 400 LTRNotSupportedForPerDBCMK — długoterminowe przechowywanie kopii zapasowych nie jest obsługiwane, gdy klucz cmK na poziomie bazy danych jest skonfigurowany w wersji zapoznawczej. 400 LongTermRetentionPolicyNotSupported — długoterminowe przechowywanie nie jest obsługiwane w tej bazie danych. 400 LongTermRetentionPolicyInvalid — zasady długoterminowego przechowywania 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.

Przykłady

Get the long term retention policies for the managed database.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/managedInstances/testInstance/databases/testDatabase/backupLongTermRetentionPolicies?api-version=2021-11-01

Java

/**
 * Samples for ManagedInstanceLongTermRetentionPolicies ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionPolicyListByDatabase.json
     */
    /**
     * Sample code: Get the long term retention policies for the managed database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPoliciesForTheManagedDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstanceLongTermRetentionPolicies()
            .listByDatabase("testResourceGroup", "testInstance", "testDatabase", 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

{
  "value": [
    {
      "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
      }
    }
  ]
}

Definicje

Nazwa	Opis
ManagedInstanceLongTermRetentionPolicy	Zasady długoterminowego przechowywania.
ManagedInstanceLongTermRetentionPolicyListResult	Lista zasad przechowywania długoterminowego.

ManagedInstanceLongTermRetentionPolicy

Zasady długoterminowego przechowywania.

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 utworzenia 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.

ManagedInstanceLongTermRetentionPolicyListResult

Lista zasad przechowywania długoterminowego.

Nazwa	Typ	Opis
nextLink	string	Link, aby pobrać następną stronę wyników.
value	ManagedInstanceLongTermRetentionPolicy[]	Tablica wyników.