Long Term Retention Backups - List By Server

Service:

SQL Database

API Version:

2021-11-01

지정된 서버에 대한 장기 보존 백업을 Lists.

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

With optional parameters:

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 매개 변수

Name	In(다음 안에)	필수	형식	Description
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	각 데이터베이스에 대한 최신 백업만 가져올지 여부입니다.

응답

Name	형식	Description
200 OK	LongTermRetentionBackupListResult	백업 목록을 성공적으로 검색했습니다.
Other Status Codes		오류 응답: *** 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

예제

Get all long term retention backups under the server.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** 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, 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

Sample Response

Status code:

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"
      }
    }
  ]
}

정의

Name	Description
BackupStorageRedundancy	복사된 백업의 스토리지 중복성 유형
databaseState	라이브 데이터베이스, 삭제된 데이터베이스 또는 모든 데이터베이스에 대해 쿼리할지 여부입니다.
LongTermRetentionBackup	장기 보존 백업.
LongTermRetentionBackupListResult	장기 보존 백업 목록입니다.

BackupStorageRedundancy

복사된 백업의 스토리지 중복성 유형

Name	형식	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

라이브 데이터베이스, 삭제된 데이터베이스 또는 모든 데이터베이스에 대해 쿼리할지 여부입니다.

Name	형식	Description
All	string
Deleted	string
Live	string

LongTermRetentionBackup

장기 보존 백업.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.backupExpirationTime	string	장기 보존 백업이 만료되는 시간입니다.
properties.backupStorageRedundancy	BackupStorageRedundancy	백업의 스토리지 중복성 유형
properties.backupTime	string	백업이 수행된 시간
properties.databaseDeletionTime	string	데이터베이스 삭제 시간
properties.databaseName	string	백업이 속한 데이터베이스의 이름
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	백업의 스토리지 중복성 유형
properties.serverCreateTime	string	서버의 만들기 시간입니다.
properties.serverName	string	백업 데이터베이스가 속한 서버 이름입니다.
type	string	리소스 종류.

LongTermRetentionBackupListResult

장기 보존 백업 목록입니다.

Name	형식	Description
nextLink	string	연결하여 결과의 다음 페이지를 검색합니다.
value	LongTermRetentionBackup[]	결과 배열입니다.