Long Term Retention Managed Instance Backups - List By Instance
Listet die langfristigen Aufbewahrungssicherungen für eine bestimmte verwaltete Instanz auf.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2025-01-01&onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
location
|
path | True |
string |
Der Speicherort der Datenbank |
|
managed
|
path | True |
string |
Der Name der verwalteten Instanz. |
|
subscription
|
path | True |
string (uuid) |
Die ID des Zielabonnements. Der Wert muss eine UUID sein. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
database
|
query |
Gibt an, ob nur Livedatenbanken abgefragt werden sollen, nur gelöschte Datenbanken oder alle Datenbanken. |
||
|
only
|
query |
boolean |
Gibt an, ob nur die neueste Sicherung für jede Datenbank abgerufen werden soll. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung ist erfolgreich. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
Get all long term retention backups under the managed instance.
Beispielanforderung
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
Beispiel für eine Antwort
{
"value": [
{
"name": "55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
"properties": {
"backupStorageAccessTier": "Archive",
"backupStorageRedundancy": "Geo",
"backupTime": "2017-08-23T08:00:00Z",
"databaseDeletionTime": null,
"databaseName": "testDatabase1",
"managedInstanceCreateTime": "2017-03-10T08:00:00Z",
"managedInstanceName": "testInstance"
}
},
{
"name": "12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
"properties": {
"backupStorageAccessTier": "Hot",
"backupStorageRedundancy": "Geo",
"backupTime": "2017-08-30T08:00:00Z",
"databaseDeletionTime": null,
"databaseName": "testDatabase2",
"managedInstanceCreateTime": "2017-03-10T08:00:00Z",
"managedInstanceName": "testInstance"
}
},
{
"name": "43214321-4321-4321-4321-321321321321;131667960820000000",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000;Archive",
"properties": {
"backupStorageAccessTier": "Archive",
"backupStorageRedundancy": "Geo",
"backupTime": "2017-09-06T08:00:00Z",
"databaseDeletionTime": null,
"databaseName": "testDatabase3",
"managedInstanceCreateTime": "2017-03-10T08:00:00Z",
"managedInstanceName": "testInstance"
}
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Backup |
BackupStorageAccessTier für die LTR-Sicherung |
|
Backup |
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird. |
|
created |
Der Identitätstyp, der die Ressource erstellt hat. |
|
Database |
Gibt an, ob nur Livedatenbanken abgefragt werden sollen, nur gelöschte Datenbanken oder alle Datenbanken. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Managed |
Eine langfristige Aufbewahrungssicherung für eine verwaltete Datenbank. |
|
Managed |
Die Antwort einer ManagedInstanceLongTermRetentionBackup-Listenoperation. |
|
system |
Metadaten zur Erstellung und letzten Änderung der Ressource. |
BackupStorageAccessTier
BackupStorageAccessTier für die LTR-Sicherung
| Wert | Beschreibung |
|---|---|
| Hot |
Heiß |
| Archive |
Archivieren |
BackupStorageRedundancy
Der Speicherkontotyp, der zum Speichern von Sicherungen für diese Datenbank verwendet wird.
| Wert | Beschreibung |
|---|---|
| Geo |
Geo |
| Local |
Lokal |
| Zone |
Zone |
| GeoZone |
GeoZone |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
| Wert | Beschreibung |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseState
Gibt an, ob nur Livedatenbanken abgefragt werden sollen, nur gelöschte Datenbanken oder alle Datenbanken.
| Wert | Beschreibung |
|---|---|
| All |
All |
| Live |
Leben |
| Deleted |
Gelöscht |
ErrorAdditionalInfo
Der Ressourcenverwaltungsfehler zusätzliche Informationen.
| Name | Typ | Beschreibung |
|---|---|---|
| info |
object |
Die zusätzlichen Informationen. |
| type |
string |
Der zusätzliche Informationstyp. |
ErrorDetail
Das Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| additionalInfo |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Das Fehlerobjekt. |
ManagedInstanceLongTermRetentionBackup
Eine langfristige Aufbewahrungssicherung für eine verwaltete Datenbank.
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string (arm-id) |
Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Der Name der Ressource |
| properties.backupExpirationTime |
string (date-time) |
Der Zeitpunkt, zu dem die langfristige Aufbewahrungssicherung abläuft. |
| properties.backupStorageAccessTier |
BackupStorageAccessTier für die LTR-Sicherung |
|
| properties.backupStorageRedundancy |
Der Speicherredundanztyp der Sicherung |
|
| properties.backupTime |
string (date-time) |
Die Zeit, zu der die Sicherung durchgeführt wurde |
| properties.databaseDeletionTime |
string (date-time) |
Die Löschzeit der Datenbank |
| properties.databaseName |
string |
Der Name der Datenbank, zu der die Sicherung gehört |
| properties.managedInstanceCreateTime |
string (date-time) |
Die Erstellungszeit der Instanz. |
| properties.managedInstanceName |
string |
Die verwaltete Instanz, zu der die Sicherungsdatenbank gehört. |
| systemData |
Azure Resource Manager-Metadaten, die createdBy und modifiedBy-Informationen enthalten. |
|
| type |
string |
Der Typ der Ressource. Zum Beispiel "Microsoft. Compute/virtualMachines" oder "Microsoft. Speicher/Speicherkonten" |
ManagedInstanceLongTermRetentionBackupListResult
Die Antwort einer ManagedInstanceLongTermRetentionBackup-Listenoperation.
| Name | Typ | Beschreibung |
|---|---|---|
| nextLink |
string (uri) |
Der Link zur nächsten Seite der Elemente |
| value |
Die ManagedInstanceLongTermRetentionBackup-Elemente auf dieser Seite |
systemData
Metadaten zur Erstellung und letzten Änderung der Ressource.
| Name | Typ | Beschreibung |
|---|---|---|
| createdAt |
string (date-time) |
Der Zeitstempel der Ressourcenerstellung (UTC). |
| createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
| createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
| lastModifiedAt |
string (date-time) |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
| lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
| lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |