Long Term Retention Managed Instance Backups - List By Instance
列出指定受控實例的長期保留備份。
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 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
location
|
path | True |
string |
資料庫的位置 |
|
managed
|
path | True |
string |
受控實例的名稱。 |
|
subscription
|
path | True |
string (uuid) |
目標訂用帳戶的標識碼。 此值必須是 UUID。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
|
database
|
query |
是否只針對即時資料庫、剛刪除的資料庫或所有資料庫進行查詢。 |
||
|
only
|
query |
boolean |
是否只取得每個資料庫的最新備份。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
要求已成功。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
Get all long term retention backups under the managed instance.
範例要求
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
範例回覆
{
"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"
}
}
]
}
定義
| 名稱 | Description |
|---|---|
|
Backup |
LTR 備份的BackupStorageAccessTier |
|
Backup |
用來儲存此資料庫的備份的記憶體帳戶類型。 |
|
created |
建立資源的身分識別類型。 |
|
Database |
是否只針對即時資料庫、剛刪除的資料庫或所有資料庫進行查詢。 |
|
Error |
資源管理錯誤附加資訊。 |
|
Error |
錯誤詳細資料。 |
|
Error |
錯誤回應 |
|
Managed |
受控資料庫的長期保留備份。 |
|
Managed |
ManagedInstanceLongTermRetentionBackup 清單操作的回應。 |
|
system |
與建立和上次修改資源相關的元數據。 |
BackupStorageAccessTier
LTR 備份的BackupStorageAccessTier
| 值 | Description |
|---|---|
| Hot |
熱的 |
| Archive |
檔案館 |
BackupStorageRedundancy
用來儲存此資料庫的備份的記憶體帳戶類型。
| 值 | Description |
|---|---|
| Geo |
地理位置 |
| Local |
本地 |
| Zone |
區域 |
| GeoZone |
地理區域 |
createdByType
建立資源的身分識別類型。
| 值 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseState
是否只針對即時資料庫、剛刪除的資料庫或所有資料庫進行查詢。
| 值 | Description |
|---|---|
| All |
全部 |
| Live |
直播中 |
| Deleted |
已刪除 |
ErrorAdditionalInfo
資源管理錯誤附加資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
附加資訊。 |
| type |
string |
其他資訊類型。 |
ErrorDetail
錯誤詳細資料。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤附加資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳情 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
錯誤物件。 |
ManagedInstanceLongTermRetentionBackup
受控資料庫的長期保留備份。
| 名稱 | 類型 | Description |
|---|---|---|
| id |
string (arm-id) |
資源的完整資源標識碼。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| name |
string |
資源的名稱 |
| properties.backupExpirationTime |
string (date-time) |
長期保留備份到期的時間。 |
| properties.backupStorageAccessTier |
LTR 備份的BackupStorageAccessTier |
|
| properties.backupStorageRedundancy |
備份的記憶體備援類型 |
|
| properties.backupTime |
string (date-time) |
備份的建立時間 |
| properties.databaseDeletionTime |
string (date-time) |
資料庫的刪除時間 |
| properties.databaseName |
string |
備份所屬的資料庫名稱 |
| properties.managedInstanceCreateTime |
string (date-time) |
實例的建立時間。 |
| properties.managedInstanceName |
string |
備份資料庫所屬的受控實例。 |
| systemData |
Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。 |
|
| type |
string |
資源的類型。 例如:「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」 |
ManagedInstanceLongTermRetentionBackupListResult
ManagedInstanceLongTermRetentionBackup 清單操作的回應。
| 名稱 | 類型 | Description |
|---|---|---|
| nextLink |
string (uri) |
專案下一頁的連結 |
| value |
本頁的 ManagedInstanceLongTermRetentionBackup 項目 |
systemData
與建立和上次修改資源相關的元數據。
| 名稱 | 類型 | Description |
|---|---|---|
| createdAt |
string (date-time) |
資源建立的時間戳(UTC)。 |
| createdBy |
string |
建立資源的身分識別。 |
| createdByType |
建立資源的身分識別類型。 |
|
| lastModifiedAt |
string (date-time) |
資源上次修改的時間戳記 (UTC) |
| lastModifiedBy |
string |
上次修改資源的身分識別。 |
| lastModifiedByType |
上次修改資源的身分識別類型。 |