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 |
|---|---|---|---|---|
|
location
|
path | True |
string |
Platsen för databasen |
|
managed
|
path | True |
string |
Namnet på den hanterade instansen. |
|
subscription
|
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. |
|
database
|
query |
Om du bara vill köra frågor mot livedatabaser, bara borttagna databaser eller alla databaser. |
||
|
only
|
query |
boolean |
Om du bara vill få den senaste säkerhetskopian för varje databas eller inte. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Begäran har slutförts. |
|
| Other Status Codes |
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 |
|---|---|
|
Backup |
BackupStorageAccessTier för LTR-säkerhetskopieringen |
|
Backup |
Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen. |
|
created |
Den typ av identitet som skapade resursen. |
|
Database |
Om du bara vill köra frågor mot livedatabaser, bara borttagna databaser eller alla databaser. |
|
Error |
Resurshanteringsfelet ytterligare information. |
|
Error |
Detaljerna om felet. |
|
Error |
Felsvar |
|
Managed |
En långsiktig kvarhållningssäkerhetskopia för en hanterad databas. |
|
Managed |
Svaret från en ManagedInstanceLongTermRetentionBackup-listoperation. |
|
system |
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 |
Felet ytterligare information. |
|
| code |
string |
Felkoden. |
| details |
Felinformationen. |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Felmålet. |
ErrorResponse
Felsvar
| Name | Typ | Description |
|---|---|---|
| error |
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 för LTR-säkerhetskopieringen |
|
| properties.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 |
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-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 |
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 |
Den typ av identitet som senast ändrade resursen. |