다음을 통해 공유

Long Term Retention Policies - Create Or Update

  • 참조
서비스:
SQL Database
API 버전:
2021-11-01

데이터베이스의 장기 보존 정책을 설정합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
databaseName
 path True

string

데이터베이스의 이름입니다.
policyName
 path True

LongTermRetentionPolicyName

정책 이름입니다. 항상 기본값이어야 합니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName
 path True

string

서버의 이름입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
properties.monthlyRetention

string

ISO 8601 형식의 LTR 백업에 대한 월별 보존 정책입니다.
properties.weekOfYear

integer

ISO 8601 형식으로 연간 백업을 수행하는 연도의 주입니다.
properties.weeklyRetention

string

ISO 8601 형식의 LTR 백업에 대한 주간 보존 정책입니다.
properties.yearlyRetention

string

ISO 8601 형식의 LTR 백업에 대한 연간 보존 정책입니다.

응답

Name 형식 Description
200 OK

LongTermRetentionPolicy

정책을 설정했습니다.
202 Accepted

수락됨
Other Status Codes

오류 응답: ***

  • 400 InvalidResourceRequestBody - 요청 본문의 리소스 또는 리소스 속성이 비어 있거나 잘못되었습니다.

  • 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.

  • 400 LongTermRetentionMissingWeekOfYear - WeekOfYear는 연간 보존을 설정하려면 1에서 52 사이를 설정해야 합니다.

  • 400 LTRNotSupportedForPerDBCMK - 데이터베이스 수준 CMK가 미리 보기로 구성된 경우 장기 백업 보존이 지원되지 않습니다.

  • 400 LongTermRetentionPolicyNotSupported - 장기 보존은 이 데이터베이스에서 지원되지 않습니다.

  • 400 LongTermRetentionPolicyInvalid - 장기 보존 정책이 잘못되었습니다.

  • 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create or update the long term retention policy for the database.

샘플 요청

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

{
  "properties": {
    "weeklyRetention": "P1M",
    "monthlyRetention": "P1Y",
    "yearlyRetention": "P5Y",
    "weekOfYear": 5
  }
}

샘플 응답

상태 코드:
200 
{
  "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
  }
}
상태 코드:
202

정의

Name Description
LongTermRetentionPolicy

장기 보존 정책입니다.
LongTermRetentionPolicyName

정책 이름입니다. 항상 기본값이어야 합니다.

LongTermRetentionPolicy

Object

장기 보존 정책입니다.

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

리소스 종류.

LongTermRetentionPolicyName

Enumeration

정책 이름입니다. 항상 기본값이어야 합니다.

값 Description
default