Long Term Retention Managed Instance Backups - List By Instance

Visar en lista över säkerhetskopior av långsiktig kvarhållning för en viss hanterad instans.

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-parametrar

Name I Obligatorisk Typ Description
locationName
path True

string

Platsen för databasen

managedInstanceName
path True

string

Namnet på den hanterade instansen.

subscriptionId
path True

string (uuid)

ID för målprenumerationen. Värdet måste vara ett UUID.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

databaseState
query

DatabaseState

Om du bara vill köra frågor mot livedatabaser, bara borttagna databaser eller alla databaser.

onlyLatestPerDatabase
query

boolean

Om du bara vill få den senaste säkerhetskopian för varje databas eller inte.

Svar

Name Typ Description
200 OK

ManagedInstanceLongTermRetentionBackupListResult

Begäran har slutförts.

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Get all long term retention backups under the managed instance.

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
BackupStorageAccessTier

BackupStorageAccessTier för LTR-säkerhetskopieringen

BackupStorageRedundancy

Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.

createdByType

Den typ av identitet som skapade resursen.

DatabaseState

Om du bara vill köra frågor mot livedatabaser, bara borttagna databaser eller alla databaser.

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

ErrorDetail

Detaljerna om felet.

ErrorResponse

Felsvar

ManagedInstanceLongTermRetentionBackup

En långsiktig kvarhållningssäkerhetskopia för en hanterad databas.

ManagedInstanceLongTermRetentionBackupListResult

Svaret från en ManagedInstanceLongTermRetentionBackup-listoperation.

systemData

Metadata som rör skapande och senaste ändring av resursen.

BackupStorageAccessTier

BackupStorageAccessTier för LTR-säkerhetskopieringen

Värde Description
Hot

Populär

Archive

Arkiv

BackupStorageRedundancy

Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.

Värde Description
Geo

Geo

Local

Lokal

Zone

Zon

GeoZone

GeoZon

createdByType

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

DatabaseState

Om du bara vill köra frågor mot livedatabaser, bara borttagna databaser eller alla databaser.

Värde Description
All

Allt

Live

Direktsändning

Deleted

Borttagen

ErrorAdditionalInfo

Resurshanteringsfelet ytterligare information.

Name Typ Description
info

object

Den ytterligare informationen.

type

string

Typen av ytterligare information.

ErrorDetail

Detaljerna om felet.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Felet ytterligare information.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felet objektet.

ManagedInstanceLongTermRetentionBackup

En långsiktig kvarhållningssäkerhetskopia för en hanterad databas.

Name Typ Description
id

string (arm-id)

Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties.backupExpirationTime

string (date-time)

Den tid som den långsiktiga kvarhållningssäkerhetskopian upphör att gälla.

properties.backupStorageAccessTier

BackupStorageAccessTier

BackupStorageAccessTier för LTR-säkerhetskopieringen

properties.backupStorageRedundancy

BackupStorageRedundancy

Lagringsredundanstypen för säkerhetskopian

properties.backupTime

string (date-time)

Den tid då säkerhetskopieringen togs

properties.databaseDeletionTime

string (date-time)

Borttagningstiden för databasen

properties.databaseName

string

Namnet på databasen som säkerhetskopian tillhör

properties.managedInstanceCreateTime

string (date-time)

Instansens skapandetid.

properties.managedInstanceName

string

Den hanterade instans som säkerhetskopieringsdatabasen tillhör.

systemData

systemData

Azure Resource Manager-metadata som innehåller creationBy och modifiedBy-information.

type

string

Resurstypen. T.ex. "Microsoft. Compute/virtualMachines" eller "Microsoft. Storage/storageAccounts"

ManagedInstanceLongTermRetentionBackupListResult

Svaret från en ManagedInstanceLongTermRetentionBackup-listoperation.

Name Typ Description
nextLink

string (uri)

Länken till nästa sida med objekt

value

ManagedInstanceLongTermRetentionBackup[]

ManagedInstanceLongTermRetentionBackup-elementen på denna sida

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för senaste ändring av resurs (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.