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
locationName
path True

string

資料庫的位置

managedInstanceName
path True

string

受控實例的名稱。

subscriptionId
path True

string (uuid)

目標訂用帳戶的標識碼。 此值必須是 UUID。

api-version
query True

string

minLength: 1

用於此作業的 API 版本。

databaseState
query

DatabaseState

是否只針對即時資料庫、剛刪除的資料庫或所有資料庫進行查詢。

onlyLatestPerDatabase
query

boolean

是否只取得每個資料庫的最新備份。

回應

名稱 類型 Description
200 OK

ManagedInstanceLongTermRetentionBackupListResult

要求已成功。

Other Status Codes

ErrorResponse

未預期的錯誤回應。

安全性

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
BackupStorageAccessTier

LTR 備份的BackupStorageAccessTier

BackupStorageRedundancy

用來儲存此資料庫的備份的記憶體帳戶類型。

createdByType

建立資源的身分識別類型。

DatabaseState

是否只針對即時資料庫、剛刪除的資料庫或所有資料庫進行查詢。

ErrorAdditionalInfo

資源管理錯誤附加資訊。

ErrorDetail

錯誤詳細資料。

ErrorResponse

錯誤回應

ManagedInstanceLongTermRetentionBackup

受控資料庫的長期保留備份。

ManagedInstanceLongTermRetentionBackupListResult

ManagedInstanceLongTermRetentionBackup 清單操作的回應。

systemData

與建立和上次修改資源相關的元數據。

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

ErrorAdditionalInfo[]

錯誤附加資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳情

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

ManagedInstanceLongTermRetentionBackup

受控資料庫的長期保留備份。

名稱 類型 Description
id

string (arm-id)

資源的完整資源標識碼。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”

name

string

資源的名稱

properties.backupExpirationTime

string (date-time)

長期保留備份到期的時間。

properties.backupStorageAccessTier

BackupStorageAccessTier

LTR 備份的BackupStorageAccessTier

properties.backupStorageRedundancy

BackupStorageRedundancy

備份的記憶體備援類型

properties.backupTime

string (date-time)

備份的建立時間

properties.databaseDeletionTime

string (date-time)

資料庫的刪除時間

properties.databaseName

string

備份所屬的資料庫名稱

properties.managedInstanceCreateTime

string (date-time)

實例的建立時間。

properties.managedInstanceName

string

備份資料庫所屬的受控實例。

systemData

systemData

Azure Resource Manager 包含 createdBy 與 modifiedBy 資訊的元資料。

type

string

資源的類型。 例如:「Microsoft。運算/虛擬機器」或「Microsoft」。儲存/儲存帳號」

ManagedInstanceLongTermRetentionBackupListResult

ManagedInstanceLongTermRetentionBackup 清單操作的回應。

名稱 類型 Description
nextLink

string (uri)

專案下一頁的連結

value

ManagedInstanceLongTermRetentionBackup[]

本頁的 ManagedInstanceLongTermRetentionBackup 項目

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string (date-time)

資源建立的時間戳(UTC)。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string (date-time)

資源上次修改的時間戳記 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。