Long Term Retention Managed Instance Backups - List By Resource Group Instance

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

特定のマネージドインスタンスの長期保有バックアップをListsします。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2021-11-01

省略可能なパラメーターを含む:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2021-11-01

URI パラメーター

名前	/	必須	型	説明
locationName	path	True	string	データベースの場所。
managedInstanceName	path	True	string	マネージドインスタンスの名前。
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。
databaseState	query		databaseState	ライブデータベース、削除されたデータベース、またはすべてのデータベースに対してクエリを実行するかどうか。
onlyLatestPerDatabase	query		boolean	各データベースの最新のバックアップのみを取得するかどうか。

応答

名前	型	説明
200 OK	ManagedInstanceLongTermRetentionBackupListResult	バックアップの一覧が正常に取得されました。
Other Status Codes		エラー応答: *** 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。

名前

型

説明

200 OK

ManagedInstanceLongTermRetentionBackupListResult

バックアップの一覧が正常に取得されました。

Other Status Codes

エラー応答: ***

404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。

例

Get all long term retention backups under the managed instance.

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


/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByResourceGroupInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedManagedInstanceLongTermRetentionBackupListByInstance.json
     */
    /**
     * Sample code: Get all long term retention backups under the managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByResourceGroupInstance("testResourceGroup", "japaneast", "testInstance", null, null,
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

定義

名前	説明
BackupStorageRedundancy	バックアップのストレージ冗長の種類
databaseState	ライブデータベース、削除されたデータベース、またはすべてのデータベースに対してクエリを実行するかどうか。
ManagedInstanceLongTermRetentionBackup	マネージドデータベースの長期保有バックアップ。
ManagedInstanceLongTermRetentionBackupListResult	マネージドデータベースの長期保有バックアップの一覧。

BackupStorageRedundancy

バックアップのストレージ冗長の種類

名前	型	説明
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

ライブデータベース、削除されたデータベース、またはすべてのデータベースに対してクエリを実行するかどうか。

名前	型	説明
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

マネージドデータベースの長期保有バックアップ。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.backupExpirationTime	string	長期保有バックアップの有効期限が切れる時間。
properties.backupStorageRedundancy	BackupStorageRedundancy	バックアップのストレージ冗長の種類
properties.backupTime	string	バックアップが作成された時刻
properties.databaseDeletionTime	string	データベースの削除時刻
properties.databaseName	string	バックアップが属しているデータベースの名前
properties.managedInstanceCreateTime	string	インスタンスの作成時刻。
properties.managedInstanceName	string	バックアップデータベースが属しているマネージドインスタンス。
type	string	リソースの種類。

ManagedInstanceLongTermRetentionBackupListResult

マネージドデータベースの長期保有バックアップの一覧。

名前	型	説明
nextLink	string	結果の次のページを取得するためのリンク。
value	ManagedInstanceLongTermRetentionBackup[]	結果の配列。

次の方法で共有

Long Term Retention Managed Instance Backups - List By Resource Group Instance

URI パラメーター

応答

例

Get all long term retention backups under the managed instance.

要求のサンプル

応答のサンプル

定義

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

その他のリソース