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
locationName
path True

string

Posizione del database

managedInstanceName
path True

string

Nome dell'istanza gestita.

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

databaseState
query

DatabaseState

Se eseguire query solo su database in tempo reale, solo su database eliminati o su tutti i database.

onlyLatestPerDatabase
query

boolean

Indica se ottenere o meno solo il backup più recente per ogni database.

Risposte

Nome Tipo Descrizione
200 OK

ManagedInstanceLongTermRetentionBackupListResult

La richiesta ha avuto esito positivo.

Other Status Codes

ErrorResponse

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
BackupStorageAccessTier

BackupStorageAccessTier per il backup con conservazione a lungo termine

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

createdByType

Tipo di identità che ha creato la risorsa.

DatabaseState

Se eseguire query solo su database in tempo reale, solo su database eliminati o su tutti i database.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ManagedInstanceLongTermRetentionBackup

Backup di conservazione a lungo termine per un database gestito.

ManagedInstanceLongTermRetentionBackupListResult

La risposta di un'operazione di lista di backup Managed InstanceLongTermRetention.

systemData

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

BackupStorageAccessTier per il backup con conservazione a lungo termine

properties.backupStorageRedundancy

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

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

ManagedInstanceLongTermRetentionBackup[]

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

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

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.