Long Term Retention Managed Instance Backups - List By Instance
Elenca i backup di conservazione a lungo termine per una determinata istanza gestita.
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}
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
location
|
path | True |
string |
Posizione del database |
|
managed
|
path | True |
string |
Nome dell'istanza gestita. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
|
database
|
query |
Se eseguire query solo su database in tempo reale, solo su database eliminati o su tutti i database. |
||
|
only
|
query |
boolean |
Indica se ottenere o meno solo il backup più recente per ogni database. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta ha avuto esito positivo. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Get all long term retention backups under the managed instance.
Esempio di richiesta
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
Risposta di esempio
{
"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"
}
}
]
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Backup |
BackupStorageAccessTier per il backup con conservazione a lungo termine |
|
Backup |
Tipo di account di archiviazione usato per archiviare i backup per questo database. |
|
created |
Tipo di identità che ha creato la risorsa. |
|
Database |
Se eseguire query solo su database in tempo reale, solo su database eliminati o su tutti i database. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Managed |
Backup di conservazione a lungo termine per un database gestito. |
|
Managed |
La risposta di un'operazione di lista di backup Managed InstanceLongTermRetention. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
BackupStorageAccessTier
BackupStorageAccessTier per il backup con conservazione a lungo termine
| Valore | Descrizione |
|---|---|
| Hot |
Hot |
| Archive |
Archivio |
BackupStorageRedundancy
Tipo di account di archiviazione usato per archiviare i backup per questo database.
| Valore | Descrizione |
|---|---|
| Geo |
Geo |
| Local |
Locale |
| Zone |
Zona |
| GeoZone |
GeoZone |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseState
Se eseguire query solo su database in tempo reale, solo su database eliminati o su tutti i database.
| Valore | Descrizione |
|---|---|
| All |
Tutti |
| Live |
In diretta |
| Deleted |
Eliminato |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
ManagedInstanceLongTermRetentionBackup
Backup di conservazione a lungo termine per un database gestito.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.backupExpirationTime |
string (date-time) |
Il periodo di scadenza del backup di conservazione a lungo termine. |
| properties.backupStorageAccessTier |
BackupStorageAccessTier per il backup con conservazione a lungo termine |
|
| properties.backupStorageRedundancy |
Tipo di ridondanza dell'archiviazione del backup |
|
| properties.backupTime |
string (date-time) |
Ora in cui è stato eseguito il backup |
| properties.databaseDeletionTime |
string (date-time) |
Ora di eliminazione del database |
| properties.databaseName |
string |
Nome del database a cui appartiene il backup |
| properties.managedInstanceCreateTime |
string (date-time) |
Ora di creazione dell'istanza. |
| properties.managedInstanceName |
string |
Istanza gestita a cui appartiene il database di backup. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
ManagedInstanceLongTermRetentionBackupListResult
La risposta di un'operazione di lista di backup Managed InstanceLongTermRetention.
| Nome | Tipo | Descrizione |
|---|---|---|
| nextLink |
string (uri) |
Il link alla pagina successiva degli elementi |
| value |
Gli elementi di Managed InstanceLongTermRetentionBackup in questa pagina |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Il timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |