Long Term Retention Managed Instance Backups - List By Resource Group Database
Lists all long term retention backups for a managed database.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionDatabases/{databaseName}/longTermRetentionManagedInstanceBackups?api-version=2023-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionDatabases/{databaseName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2023-08-01
URI Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
|
database
|
path | True |
string |
The name of the managed database. |
|
location
|
path | True |
string |
The location of the database |
|
managed
|
path | True |
string |
The name of the managed instance. |
|
resource
|
path | True |
string |
The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal. |
|
subscription
|
path | True |
string |
The subscription ID that identifies an Azure subscription. |
|
api-version
|
query | True |
string |
The API version to use for the request. |
|
database
|
query |
Whether to query against just live databases, just deleted databases, or all databases. |
||
|
only
|
query |
boolean |
Whether or not to only get the latest backup for each database. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK |
Successfully retrieved the list of backups. |
|
| Other Status Codes |
*** Error Responses: ***
|
Examples
Get all long term retention backups under the database.
Sample request
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups?api-version=2023-08-01
Sample response
{
"value": [
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z;Archive",
"name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z;Archive",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"properties": {
"managedInstanceName": "testInstance",
"managedInstanceCreateTime": "2017-03-10T08:00:00Z",
"databaseName": "testDatabase",
"databaseDeletionTime": null,
"backupTime": "2018-08-23T08:00:00Z",
"backupStorageRedundancy": "Geo",
"backupStorageAccessTier": "Archive"
}
},
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z;Hot",
"name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z;Hot",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"properties": {
"managedInstanceName": "testInstance",
"managedInstanceCreateTime": "2017-03-10T08:00:00Z",
"databaseName": "testDatabase",
"databaseDeletionTime": null,
"backupTime": "2018-08-30T08:00:00Z",
"backupStorageRedundancy": "Geo",
"backupStorageAccessTier": "Hot"
}
},
{
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z;Archive",
"name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z;Archive",
"type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
"properties": {
"managedInstanceName": "testInstance",
"managedInstanceCreateTime": "2018-03-10T08:00:00Z",
"databaseName": "testDatabase",
"databaseDeletionTime": "2018-09-07T08:00:00Z",
"backupTime": "2018-09-06T08:00:00Z",
"backupStorageRedundancy": "Geo",
"backupStorageAccessTier": "Archive"
}
}
]
}
Definitions
| Name | Description |
|---|---|
|
Backup |
The BackupStorageAccessTier for the LTR backup |
|
Backup |
The storage redundancy type of the backup |
|
database |
Whether to query against just live databases, just deleted databases, or all databases. |
|
Error |
The resource management error additional info. |
|
Error |
The error detail. |
|
Error |
Error response |
|
Managed |
A long term retention backup for a managed database. |
|
Managed |
A list of long term retention backups for managed database(s). |
BackupStorageAccessTier
The BackupStorageAccessTier for the LTR backup
| Value | Description |
|---|---|
| Hot | |
| Archive |
BackupStorageRedundancy
The storage redundancy type of the backup
| Value | Description |
|---|---|
| Geo | |
| Local | |
| Zone | |
| GeoZone |
databaseState
Whether to query against just live databases, just deleted databases, or all databases.
| Value | Description |
|---|---|
| All | |
| Live | |
| Deleted |
ErrorAdditionalInfo
The resource management error additional info.
| Name | Type | Description |
|---|---|---|
| info |
object |
The additional info. |
| type |
string |
The additional info type. |
ErrorDetail
The error detail.
| Name | Type | Description |
|---|---|---|
| additionalInfo |
The error additional info. |
|
| code |
string |
The error code. |
| details |
The error details. |
|
| message |
string |
The error message. |
| target |
string |
The error target. |
ErrorResponse
Error response
| Name | Type | Description |
|---|---|---|
| error |
The error object. |
ManagedInstanceLongTermRetentionBackup
A long term retention backup for a managed database.
| Name | Type | Description |
|---|---|---|
| id |
string |
Resource ID. |
| name |
string |
Resource name. |
| properties.backupExpirationTime |
string (date-time) |
The time the long term retention backup will expire. |
| properties.backupStorageAccessTier |
The BackupStorageAccessTier for the LTR backup |
|
| properties.backupStorageRedundancy |
The storage redundancy type of the backup |
|
| properties.backupTime |
string (date-time) |
The time the backup was taken |
| properties.databaseDeletionTime |
string (date-time) |
The delete time of the database |
| properties.databaseName |
string |
The name of the database the backup belong to |
| properties.managedInstanceCreateTime |
string (date-time) |
The create time of the instance. |
| properties.managedInstanceName |
string |
The managed instance that the backup database belongs to. |
| type |
string |
Resource type. |
ManagedInstanceLongTermRetentionBackupListResult
A list of long term retention backups for managed database(s).
| Name | Type | Description |
|---|---|---|
| nextLink |
string |
Link to retrieve next page of results. |
| value |
Array of results. |