Long Term Retention Managed Instance Backups - List By Instance

Wyświetla listę kopii zapasowych przechowywania długoterminowego dla danego wystąpienia zarządzanego.

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}

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
locationName
path True

string

Lokalizacja bazy danych

managedInstanceName
path True

string

Nazwa wystąpienia zarządzanego.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

databaseState
query

DatabaseState

Niezależnie od tego, czy należy wykonywać zapytania dotyczące tylko dynamicznych baz danych, po prostu usuniętych baz danych, czy wszystkich baz danych.

onlyLatestPerDatabase
query

boolean

Niezależnie od tego, czy pobrać najnowszą kopię zapasową dla każdej bazy danych.

Odpowiedzi

Nazwisko Typ Opis
200 OK

ManagedInstanceLongTermRetentionBackupListResult

Żądanie zakończyło się pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get all long term retention backups under the managed instance.

Przykładowe żądanie

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01

Przykładowa odpowiedź

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

Definicje

Nazwisko Opis
BackupStorageAccessTier

BackupStorageAccessTier dla kopii zapasowej LTR

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

createdByType

Typ tożsamości, która utworzyła zasób.

DatabaseState

Niezależnie od tego, czy należy wykonywać zapytania dotyczące tylko dynamicznych baz danych, po prostu usuniętych baz danych, czy wszystkich baz danych.

ErrorAdditionalInfo

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

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

ManagedInstanceLongTermRetentionBackup

Długoterminowa kopia zapasowa przechowywania zarządzanej bazy danych.

ManagedInstanceLongTermRetentionBackupListResult

Odpowiedź operacji listy ManagedInstanceLongTermRetentionBackup.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

BackupStorageAccessTier

BackupStorageAccessTier dla kopii zapasowej LTR

Wartość Opis
Hot

Gorący

Archive

Archiwum

BackupStorageRedundancy

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

Wartość Opis
Geo

Geo

Local

Lokalny

Zone

Strefa

GeoZone

Strefa geograficzna

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

DatabaseState

Niezależnie od tego, czy należy wykonywać zapytania dotyczące tylko dynamicznych baz danych, po prostu usuniętych baz danych, czy wszystkich baz danych.

Wartość Opis
All

Wszystko

Live

Na żywo

Deleted

Usunięto

ErrorAdditionalInfo

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

Nazwisko Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwisko 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

Odpowiedź na błąd

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

ManagedInstanceLongTermRetentionBackup

Długoterminowa kopia zapasowa przechowywania zarządzanej bazy danych.

Nazwisko Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.backupExpirationTime

string (date-time)

Czas wygaśnięcia kopii zapasowej długoterminowego przechowywania.

properties.backupStorageAccessTier

BackupStorageAccessTier

BackupStorageAccessTier dla kopii zapasowej LTR

properties.backupStorageRedundancy

BackupStorageRedundancy

Typ nadmiarowości magazynu kopii zapasowej

properties.backupTime

string (date-time)

Czas wykonywania kopii zapasowej

properties.databaseDeletionTime

string (date-time)

Czas usuwania bazy danych

properties.databaseName

string

Nazwa bazy danych, do którego należy kopia zapasowa

properties.managedInstanceCreateTime

string (date-time)

Czas tworzenia wystąpienia.

properties.managedInstanceName

string

Wystąpienie zarządzane, do którego należy baza danych kopii zapasowej.

systemData

systemData

Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

ManagedInstanceLongTermRetentionBackupListResult

Odpowiedź operacji listy ManagedInstanceLongTermRetentionBackup.

Nazwisko Typ Opis
nextLink

string (uri)

Link do następnej strony elementów

value

ManagedInstanceLongTermRetentionBackup[]

Elementy ManagedInstanceLongTermRettionBackup na tej stronie

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.