Managed Instance Long Term Retention Policies - Get

Služba:

SQL Database

Verze rozhraní API:

2025-01-01

Získá zásady dlouhodobého uchovávání spravované databáze.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze.
managedInstanceName	path	True	string	Název spravované instance.
policyName	path	True	ManagedInstanceLongTermRetentionPolicyName	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.
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.

Odpovědi

Name	Typ	Description
200 OK	ManagedInstanceLongTermRetentionPolicy	Pro spravovanou databázi se úspěšně zobrazily zásady LTR.
Other Status Codes	ErrorResponse	Chybové odpovědi: *** 400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu 400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance 400 LtrConfigPolicyUnsupportedIfAutoPauseEnabled – Povolení dlouhodobého uchovávání záloh pro bezserverovou databázi se nepodporuje, pokud je povolené automatické pozastavení. 400 LtrConfigPolicyDuringVldbMigration – Povolení dlouhodobého uchovávání záloh pro databázi během migrace na úroveň služby Hyperscale se nepodporuje. 400 LtrConfigPolicyDuringVldbReverseMigration – Povolení dlouhodobého uchovávání záloh pro databázi během zpětné migrace z Hyperscale se nepodporuje. 400 DatabaseNamedReplicaBackupRetentionConfigurationNotSupported – Uživatel se pokusil konfigurovat zásady uchovávání záloh na pojmenovanou repliku. 400 LTRNotSupportedForPerDBCMK – Dlouhodobé uchovávání záloh se nepodporuje, pokud je klíč CMK na úrovni databáze nakonfigurovaný ve verzi Preview. 400 LTRHyperscaleSetPolicyError – Při povolování dlouhodobého uchovávání záloh pro tuto databázi došlo k chybě. Pokud chcete povolit dlouhodobé uchovávání záloh, obraťte se na podporu Microsoftu. 400 LTRArchiveStorageDisabledOnHyperscaleEdition – Archivace dlouhodobých záloh uchovávání v databázích Hyperscale není povolená. 400 InvalidLTRImmutabilityWithImmutabilityNotSet – Nelze nastavit režim zásad neměnnosti, pokud není povolená neměnnost zálohy. 400 LTRArchiveStorageFailedOnZoneRedundantBackupStorage – Nastavení zásad dlouhodobého uchovávání s úrovní přístupu úložiště zálohování nastavenou na archiv není podporováno v zónově redundantním úložišti zálohování. Použijte místně redundantní nebo geograficky redundantní typy úložiště. 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 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen. 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen. 409 ConflictingServerOperation – Server{0}je zaneprázdněn jinou operací. Zkuste operaci provést později.

Příklady

Get the long term retention policy for the managed database.

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
BackupStorageAccessTier	BackupStorageAccessTier pro zálohy LTR
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ManagedInstanceLongTermRetentionPolicy	Zásady dlouhodobého uchovávání informací.
ManagedInstanceLongTermRetentionPolicyName	Název zásady. Měla by být vždy výchozí.

BackupStorageAccessTier

Výčet

BackupStorageAccessTier pro zálohy LTR

Hodnota	Description
Hot
Archive

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ManagedInstanceLongTermRetentionPolicy

Objekt

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

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku
properties.backupStorageAccessTier	BackupStorageAccessTier	BackupStorageAccessTier pro zálohy LTR
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.

ManagedInstanceLongTermRetentionPolicyName

Výčet

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

Hodnota	Description
default