Managed Instance Long Term Retention Policies - Get

Usługa:

SQL Database

Wersja interfejsu API:

2025-01-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupLongTermRetentionPolicies/default?api-version=2025-01-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 być wartością domyślną.
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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedInstanceLongTermRetentionPolicy	Pomyślnie włączono zasady LTR dla zarządzanej bazy danych.
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym 400 LtrConfigPolicyUnsupportedIfAutoPauseEnabled — włączanie długoterminowego przechowywania kopii zapasowych dla bezserwerowej bazy danych nie jest obsługiwane, jeśli włączono automatyczne wstrzymanie. 400 LtrConfigPolicyDuringVldbMigration — włączanie długoterminowego przechowywania kopii zapasowych bazy danych podczas migracji do warstwy usługi Hiperskala nie jest obsługiwane. 400 LtrConfigPolicyDuringVldbReverseMigration — włączanie długoterminowego przechowywania kopii zapasowych dla bazy danych podczas odwrotnej migracji z warstwy Hiperskala nie jest obsługiwane. 400 DatabaseNamedReplicaBackupRetentionConfigurationNotSupported — użytkownik próbował skonfigurować zasady przechowywania kopii zapasowych w nazwanej replice. 400 LTRNotSupportedForPerDBCMK — długoterminowe przechowywanie kopii zapasowych nie jest obsługiwane, gdy klucz zarządzania na poziomie bazy danych jest skonfigurowany w wersji zapoznawczej. 400 LTRHyperscaleSetPolicyError — wystąpił błąd podczas włączania długoterminowego przechowywania kopii zapasowych dla tej bazy danych. Skontaktuj się z pomocą techniczną firmy Microsoft, aby włączyć długoterminowe przechowywanie kopii zapasowych. 400 LTRArchiveStorageDisabledOnHyperscaleEdition — archiwizowanie kopii zapasowych długoterminowego przechowywania w bazach danych hiperskala nie jest włączone. 400 InvalidLTRImmutabilityWithImmutabilityNotSet — nie można ustawić trybu zasad niezmienności, gdy niezmienność kopii zapasowej nie jest włączona. 400 LTRArchiveStorageFailedOnZoneRedundantBackupStorage — ustawienie zasad przechowywania długoterminowego przy użyciu warstwy dostępu magazynu kopii zapasowej ustawionej na "archiwum" nie jest obsługiwane w magazynie kopii zapasowych strefowo nadmiarowych. Użyj lokalnie nadmiarowych lub geograficznie nadmiarowych typów magazynu. 400 LongTermRetentionPolicyNotSupported — długoterminowe przechowywanie nie jest obsługiwane w tej bazie danych. 400 LongTermRetentionPolicyInvalid — zasady długoterminowego przechowywania są nieprawidłowe. 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ResourceNotFound — żądany zasób nie został znaleziony. 409 ConflictingServerOperation — serwer "{0}" jest zajęty inną operacją. Spróbuj wykonać operację później.

Przykłady

Get the long term retention policy 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/default?api-version=2025-01-01

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,
    "backupStorageAccessTier": "Archive"
  }
}

Definicje

Nazwa	Opis
BackupStorageAccessTier	BackupStorageAccessTier dla kopii zapasowych LTR
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ManagedInstanceLongTermRetentionPolicy	Zasady długoterminowego przechowywania.
ManagedInstanceLongTermRetentionPolicyName	Nazwa zasad. Zawsze powinna być wartością domyślną.

BackupStorageAccessTier

Wyliczenie

BackupStorageAccessTier dla kopii zapasowych LTR

Wartość	Opis
Hot
Archive

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Błąd dodatkowe informacje.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ManagedInstanceLongTermRetentionPolicy

Objekt

Zasady długoterminowego przechowywania.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.backupStorageAccessTier	BackupStorageAccessTier	BackupStorageAccessTier dla kopii zapasowych LTR
properties.monthlyRetention	string	Zasady przechowywania miesięcznego kopii zapasowej LTR w formacie ISO 8601.
properties.weekOfYear	integer (int32)	Tydzień roku do wykonania rocznej kopii zapasowej w formacie ISO 8601.
properties.weeklyRetention	string	Zasady przechowywania tygodniowego dla 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

Wyliczenie

Nazwa zasad. Zawsze powinna być wartością domyślną.

Wartość	Opis
default