Long Term Retention Backups - List By Server

リファレンス

サービス:: SQL Database

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

特定のサーバーの長期保有バックアップを一覧表示します。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionBackups?api-version=2021-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2021-11-01

URI パラメーター

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

応答

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

名前

型

説明

200 OK

LongTermRetentionBackupListResult

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

Other Status Codes

エラー応答: ***

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

例

Get all long term retention backups under the server.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionBackups?api-version=2021-11-01


/**
 * Samples for LongTermRetentionBackups ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByServer.
     * json
     */
    /**
     * Sample code: Get all long term retention backups under the server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().listByServer("japaneast",
            "testserver", 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/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase1/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase2/longTermRetentionBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase3/longTermRetentionBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

定義

名前	説明
BackupStorageRedundancy	コピーしたバックアップのストレージ冗長タイプ
databaseState	ライブデータベース、削除されたデータベース、またはすべてのデータベースに対してクエリを実行するかどうか。
LongTermRetentionBackup	長期的なリテンション期間のバックアップ。
LongTermRetentionBackupListResult	長期保有バックアップの一覧。

BackupStorageRedundancy

列挙

コピーしたバックアップのストレージ冗長タイプ

値	説明
Geo
GeoZone
Local
Zone

databaseState

列挙

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

値	説明
All
Deleted
Live

LongTermRetentionBackup

Object

長期的なリテンション期間のバックアップ。

名前	型	説明
id	string	リソース ID。
name	string	リソース名。
properties.backupExpirationTime	string (date-time)	長期保有バックアップの有効期限が切れる時間。
properties.backupStorageRedundancy	BackupStorageRedundancy	バックアップのストレージ冗長の種類
properties.backupTime	string (date-time)	バックアップが作成された時刻
properties.databaseDeletionTime	string (date-time)	データベースの削除時刻
properties.databaseName	string	バックアップが属するデータベースの名前
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	バックアップのストレージ冗長の種類
properties.serverCreateTime	string (date-time)	サーバーの作成時刻。
properties.serverName	string	バックアップデータベースが属しているサーバー名。
type	string	リソースの種類。

LongTermRetentionBackupListResult

Object

長期保有バックアップの一覧。

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

次の方法で共有

Long Term Retention Backups - List By Server

URI パラメーター

応答

例

Get all long term retention backups under the server.

要求のサンプル

応答のサンプル

定義

BackupStorageRedundancy

databaseState

LongTermRetentionBackup

LongTermRetentionBackupListResult

その他のリソース