Long Term Retention Policies - List By Database

Service:

SQL Database

API Version:

2021-11-01

데이터베이스의 장기 보존 정책을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupLongTermRetentionPolicies?api-version=2021-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	데이터베이스의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	LongTermRetentionPolicyListResult	정책을 성공적으로 가져옵니다.
Other Status Codes		오류 응답: *** 400 LTRNotSupportedForPerDBCMK - 데이터베이스 수준 CMK가 미리 보기로 구성된 경우 장기 백업 보존이 지원되지 않습니다. 400 LongTermRetentionPolicyNotSupported - 장기 보존은 이 데이터베이스에서 지원되지 않습니다. 400 LongTermRetentionPolicyInvalid - 장기 보존 정책이 잘못되었습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

예제

Get the long term retention policy for the database.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for LongTermRetentionPolicies ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyListByDatabase
     * .json
     */
    /**
     * Sample code: Get the long term retention policy for the database.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionPolicies().listByDatabase("resourceGroup",
            "testserver", "testDatabase", 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/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
      "name": "default",
      "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
      "properties": {
        "weeklyRetention": "P1M",
        "monthlyRetention": "P1Y",
        "yearlyRetention": "P5Y",
        "weekOfYear": 5
      }
    }
  ]
}

정의

Name	Description
LongTermRetentionPolicy	장기 보존 정책.
LongTermRetentionPolicyListResult	장기 보존 정책 목록입니다.

LongTermRetentionPolicy

장기 보존 정책.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.monthlyRetention	string	ISO 8601 형식의 LTR 백업에 대한 월별 보존 정책입니다.
properties.weekOfYear	integer	ISO 8601 형식으로 연간 백업을 수행하는 연도의 주입니다.
properties.weeklyRetention	string	ISO 8601 형식의 LTR 백업에 대한 주간 보존 정책입니다.
properties.yearlyRetention	string	ISO 8601 형식의 LTR 백업에 대한 연간 보존 정책입니다.
type	string	리소스 종류.

LongTermRetentionPolicyListResult

장기 보존 정책 목록입니다.

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