Long Term Retention Backups - Update By Resource Group

기존 장기 보존 백업을 업데이트합니다.

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

URI 매개 변수

Name In Required Type Description
backupName
path True
  • string

백업 이름입니다.

locationName
path True
  • string

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

longTermRetentionDatabaseName
path True
  • string

데이터베이스의 이름

longTermRetentionServerName
path True
  • string

서버 이름

resourceGroupName
path True
  • string

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

subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True
  • string

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

요청 본문

Name Type Description
properties.requestedBackupStorageRedundancy

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

응답

Name Type Description
200 OK

백업을 성공적으로 업데이트했습니다.

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 - 지정된 백업 Storage 중복성은 대상 지역에서 지원되지 않습니다.

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

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

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

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

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

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

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

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

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

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

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

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

예제

Update the long term retention backup.

Sample Request

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

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

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japanEast/longTermRetentionServers/testserver/longterRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
    "operationType": "UpdateBackup",
    "status": "Succeeded",
    "targetBackupStorageRedundancy": "Geo"
  }
}

정의

BackupStorageRedundancy

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

LongTermRetentionBackupOperationResult

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

RequestedBackupStorageRedundancy

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

UpdateLongTermRetentionBackupParameters

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

BackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

LongTermRetentionBackupOperationResult

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

Name Type 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

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

properties.toBackupResourceId
  • string

대상 백업 리소스 ID

type
  • string

리소스 종류.

RequestedBackupStorageRedundancy

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

Name Type Description
Geo
  • string
Local
  • string
Zone
  • string

UpdateLongTermRetentionBackupParameters

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

Name Type Description
properties.requestedBackupStorageRedundancy

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