다음을 통해 공유

Long Term Retention Backups - Update

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

기존 장기 보존 백업을 업데이트.

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

URI 매개 변수

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

string

백업 이름입니다.
locationName
 path True

string

데이터베이스의 위치입니다.
longTermRetentionDatabaseName
 path True

string

데이터베이스의 이름
longTermRetentionServerName
 path True

string

서버 이름
subscriptionId
 path True

string

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

string

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

요청 본문

Name 형식 Description
properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

응답

Name 형식 Description
200 OK

LongTermRetentionBackupOperationResult

백업을 업데이트했습니다.
202 Accepted

백업 업데이트가 진행 중입니다.
Other Status Codes

오류 응답: ***

  • 400 InvalidLongTermRetentionBackupId - SQL DB에 대한 잘못된 장기 보존 백업 식별자입니다.

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

  • 400 LongTermRetentionMismatchingSubscriptionId - 제공된 구독 ID가 다른 입력의 ID와 일치하지 않음

  • 400 LongTermRetentionMismatchingResourceGroupName - 제공된 리소스 그룹 이름이 다른 입력의 이름과 일치하지 않음

  • 400 LongTermRetentionMismatchingServerName - 제공된 서버 이름이 다른 입력의 이름과 일치하지 않음

  • 400 LongTermRetentionMigrationRequestNotSupported - 구독은 LTR 백업 마이그레이션 기능을 사용할 수 없습니다.

  • 400 LongTermRetentionMigrationCrossClusterRequestNotSupported - 원본 및 대상 구독은 LTR 백업 복사 기능에 대해 통신할 수 없습니다.

  • 400 LongTermRetentionMigrationParameterMissing - 작업에 필요한 매개 변수가 없습니다.

  • 400 LongTermRetentionMigrationSameServerNotSupported - LTR 복사 기능은 동일한 서버 내에서 LTR 백업을 복사하는 데 지원되지 않습니다.

  • 400 LongTermRetentionMigrationTargetServerNotFound - 대상 서버가 없거나 LTR 백업 복사 작업을 수행할 준비가 되지 않았습니다.

  • 400 LongTermRetentionMigrationTargetDatabaseNotFound - 대상 데이터베이스가 서버에 없습니다.

  • 400 LongTermRetentionMigrationStorageTypeNotSupported - 지정된 백업 스토리지 중복성은 대상 지역에서 지원되지 않습니다.

  • 400 LongTermRetentionMigrationStorageMismatch - 데이터베이스의 활성 백업 중복성이 고객이 요청한 백업 중복성과 일치하지 않습니다.

  • 400 LongTermRetentionMigrationDatabaseTypeNotSupported - LTR 마이그레이션은 관리되는 instance 및 Azure SQL DB LTR 백업에 대해서만 지원됩니다.

  • 400 LongTermRetentionMigrationBackupStorageRedundancyNotAllowed - LTR 복사 작업에 백업 스토리지 중복성 변경은 허용되지 않습니다.

  • 400 LongTermRetentionMigrationSubscriptionNotFound - 구독을 찾을 수 없습니다.

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

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

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

  • 404 LongTermRetentionMigrationBackupNotFound - 지정된 LTR 백업이 없습니다.

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

  • 409 LongTermRetentionMigrationRequestConflict - 이 LTR 백업에 대한 충돌 작업이 아직 진행 중입니다.

  • 409 LongTermRetentionMigrationBackupConflict - 대상 데이터베이스에 대해 동일한 백업 시간을 가진 또 다른 LTR 백업이 있습니다.

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

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

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

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

  • 500 LongTermRetentionMigrationRequestFailedToStartOnTarget - 대상 지역에서 LTR 백업 복사 요청을 시작하지 못했습니다.

  • 500 LongTermRetentionMigrationRequestCopyFailed - LTR 백업 Blob에 대해 복사 작업이 실패했습니다.

  • 500 LongTermRetentionMigrationRestoreVerExceeded - 최대 시도에 도달한 후 복원 확인에 실패했습니다.

  • 500 LongTermRetentionMigrationRestoreVerFailed - 복원 확인에 실패했습니다.

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

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

예제

Update the long term retention backup.

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000/update?api-version=2021-11-01

{
  "properties": {
    "requestedBackupStorageRedundancy": "Geo"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionBackupOperationResults/a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "name": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
  "type": "Microsoft.Sql/locations/longTermRetentionBackupOperationResults",
  "properties": {
    "requestId": "a1aa7c77-961b-4fbb-bcd6-aa9acfcd1706",
    "fromBackupResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}
상태 코드:
202

정의

Name Description
BackupStorageRedundancy

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

LongTermRetentionBackup 작업 결과 리소스입니다.
UpdateLongTermRetentionBackupParameters

장기 보존 백업 업데이트 작업을 수행하는 데 필요한 정보를 포함합니다.

BackupStorageRedundancy

Enumeration

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

값 Description
Geo
GeoZone
Local
Zone

LongTermRetentionBackupOperationResult

Object

LongTermRetentionBackup 작업 결과 리소스입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.fromBackupResourceId

string

원본 백업 리소스 ID
properties.message

string

진행률 메시지
properties.operationType

string

작업 유형입니다.
properties.requestId

string

요청 ID입니다.
properties.status

string

작업 상태
properties.targetBackupStorageRedundancy

BackupStorageRedundancy

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

string

대상 백업 리소스 ID
type

string

리소스 종류.

UpdateLongTermRetentionBackupParameters

Object

장기 보존 백업 업데이트 작업을 수행하는 데 필요한 정보를 포함합니다.

Name 형식 Description
properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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