Managed Databases - Update

서비스:: SQL Database

API 버전:: 2023-08-01

기존 데이터베이스를 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}?api-version=2023-08-01

URI 매개 변수

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

요청 본문

Name	형식	Description
properties.autoCompleteRestore	boolean	이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다.
properties.catalogCollation	CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
properties.collation	string	관리되는 데이터베이스의 데이터 정렬입니다.
properties.createMode	ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
properties.crossSubscriptionRestorableDroppedDatabaseId	string	복원 가능한 구독 간 리소스 ID가 삭제되어 이 데이터베이스를 만들 때 복원할 수 있습니다.
properties.crossSubscriptionSourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 구독 간 원본 데이터베이스의 리소스 식별자입니다.
properties.crossSubscriptionTargetManagedInstanceId	string	구독 간 복원에 사용되는 대상 관리되는 인스턴스 ID입니다.
properties.isLedgerOn	boolean	이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.lastBackupName	string	이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다.
properties.longTermRetentionBackupResourceId	string	이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다.
properties.recoverableDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.restorableDroppedDatabaseId	string	이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다.
properties.restorePointInTime	string (date-time)	조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.storageContainerIdentity	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 사용됩니다. 스토리지 컨테이너 인증에 사용되는 ID를 지정합니다. 'SharedAccessSignature' 또는 'ManagedIdentity'일 수 있습니다. 지정하지 않으면 'SharedAccessSignature'가 가정됩니다.
properties.storageContainerSasToken	string	조건부. createMode가 RestoreExternalBackup이고 storageContainerIdentity가 ManagedIdentity가 아닌 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다.
properties.storageContainerUri	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	ManagedDatabase	데이터베이스를 업데이트했습니다.
202 Accepted		관리되는 데이터베이스 업데이트가 진행 중입니다. 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 AkvEndpointNotReachableFromNode - AKV 엔드포인트 '{0}'은 서버 '{1}'의 SQL에서 연결할 수 없습니다. 400 CurrentDatabaseSizeExceedsMaxSize - 사용자가 데이터베이스의 최대 크기를 현재 사용량보다 작은 크기로 줄이려고 했습니다. 400 PasswordNotComplex - 제공된 암호가 충분히 복잡하지 않습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 CannotUpdateIsLedgerDatabase - 기존 데이터베이스의 원장 속성을 업데이트할 수 없습니다. 400 UnsupportedServiceName - 지원되지 않는 유니코드 문자가 하나 이상 포함되어 있으므로 지정된 이름이 잘못된 이름입니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다. 400 ManagedDatabaseNameInUse - 데이터베이스 '{0}'이 이미 있습니다. 다른 데이터베이스 이름을 선택합니다. 400 PitrPointInTimeInvalid - {0} 지정 시간이 잘못되었습니다. 유효한 시점 범위는 원본 서버 생성 시간이 아니라 {1} 일에서 지금까지입니다. 400 NoMoreSpaceInManagedInstance - 관리되는 인스턴스가 스토리지 한도에 도달했습니다. 관리되는 인스턴스의 스토리지 사용량은 (%d) MB를 초과할 수 없습니다. 400 CurrentDatabaseLogSizeExceedsMaxSize - 사용자가 현재 사용량보다 최대 로그 크기가 낮은 sku로 데이터베이스를 변경하려고 했습니다. 400 CannotUseTrailingWhitespacesInDatabaseName - 데이터베이스 이름 유효성 검사에 실패했습니다. 400 StorageAccountFull - Managed Instance가 기본 Azure Storage 계정의 총 용량에 도달했습니다. Azure Premium Storage 계정은 할당된 공간의 35TB로 제한됩니다. 400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에는 주 서버의 암호화 보호기의 키 자료가 없습니다. 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다. 400 SourceServerNotFound - CreateDatabaseAsCopy API 호출에 제공된 원본 데이터베이스 ID의 서버 부분이 기존 서버에 매핑되지 않습니다. 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 InvalidBackupRetentionPeriod - {0} 보존 기간이 유효한 구성이 아닙니다. 유효한 백업 보존 기간(일)은 {1} 및 {2} 사이여야 합니다. 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 SourceDatabaseNotFound - 원본 데이터베이스가 없습니다. 400 DatabaseNumberLimitReached - SQL Database Managed Instance에 대한 최대 데이터베이스 수에 도달했습니다. 400 InvalidCollation - 데이터 정렬이 서버에서 인식되지 않습니다. 400 ManagedInstanceUpdateSloInProgress - "관리되는 인스턴스 '{0}.'에 대한 서비스 계층 변경이 진행 중이므로 작업을 완료할 수 없습니다. 진행 중인 작업이 완료되기를 기다렸다가 다시 시도하세요." 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다. 400 AkvHostNotResolvingFromNode - AKV 호스트 '{0}'은 서버 '{1}'의 SQL에서 확인할 수 없습니다. 400 InvalidDatabaseCreateOrUpdateRequest - 데이터베이스 만들기 또는 업데이트 작업에 대한 요청 본문이 잘못되었습니다. 400 InvalidResourceId - 잘못된 리소스 식별자입니다. 400 InvalidSourceDatabaseId - 잘못된 원본 데이터베이스 식별자입니다. 400 InvalidRestorableDroppedDatabaseId - 복원 가능한 삭제된 데이터베이스 식별자가 잘못되었습니다. 400 InvalidCrossSubscriptionTargetManagedInstanceId - 잘못된 교차 구독 대상 관리되는 인스턴스 식별자입니다. 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다. 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다. 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다. 400 MissingCollation - 데이터 정렬이 필요합니다. 400 MissingSourceDatabaseId - 원본 데이터베이스 식별자가 없습니다. 400 MissingRestorePointInTime - 복원 시점 누락 400 MissingStorageContainerSasToken - 누락된 스토리지 컨테이너 SAS 토큰 400 MissingStorageContainerUri - 스토리지 컨테이너 URI 누락 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - sourceDatabaseId가 복원 만들기 모드로 이미 제공된 경우 restoreableDroppedDatabaseId를 지정할 수 없습니다. 400 CrossSubscriptionRestorableDroppedDatabaseIdGivenForRestoreWithCrossSubscriptionSourceDatabaseId - crossSubscriptionSourceDatabaseId가 이미 제공된 경우 crossSubscriptionRestorableDroppedDatabaseId를 지정할 수 없습니다. 400 MissmatchingCrossSubscriptionTargetManagedInstanceIdWithUrl - 제공된 crossSubscriptionTargetManagedInstanceId는 URL의 인스턴스와 일치해야 합니다. 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 CannotFindServerCertificateWithThumbprint - 지문 '{0}'가 있는 서버 인증서를 찾을 수 없습니다. PowerShell Cmdlet 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate'를 사용하여 인증서를 만듭니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다. 404 RestoreSourceDatabaseNotFound - 복원할 수 있는 '{0}'{1}' 데이터베이스를 찾을 수 없습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 CannotFindObject - 개체가 없거나 사용 권한이 없으므로 개체를 찾을 수 없습니다. 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 SubscriptionDisabled - 구독을 사용할 수 없습니다. 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다. 409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다. 409 ConflictingDatabaseOperation - 데이터베이스에 대한 일부 작업이 이미 있으며 현재 작업이 완료될 때까지 기다려야 합니다. 409 ManagementServiceDatabaseBusy - 데이터베이스 '{0}'이(가) 다른 작업으로 사용 중입니다. 나중에 작업을 시도하세요. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 ActivateOrDeactivateWorkflowThrottling - 동시 워크플로가 너무 많기 때문에 활성화 또는 비활성화 워크플로가 실패했습니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다.

Name

형식

Description

200 OK

ManagedDatabase

데이터베이스를 업데이트했습니다.

202 Accepted

관리되는 데이터베이스 업데이트가 진행 중입니다.

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업
400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업
400 AkvEndpointNotReachableFromNode - AKV 엔드포인트 '{0}'은 서버 '{1}'의 SQL에서 연결할 수 없습니다.
400 CurrentDatabaseSizeExceedsMaxSize - 사용자가 데이터베이스의 최대 크기를 현재 사용량보다 작은 크기로 줄이려고 했습니다.
400 PasswordNotComplex - 제공된 암호가 충분히 복잡하지 않습니다.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 CannotUpdateIsLedgerDatabase - 기존 데이터베이스의 원장 속성을 업데이트할 수 없습니다.
400 UnsupportedServiceName - 지원되지 않는 유니코드 문자가 하나 이상 포함되어 있으므로 지정된 이름이 잘못된 이름입니다.
400 TokenTooLong - 제공된 토큰이 너무 깁니다.
400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다.
400 ManagedDatabaseNameInUse - 데이터베이스 '{0}'이 이미 있습니다. 다른 데이터베이스 이름을 선택합니다.
400 PitrPointInTimeInvalid - {0} 지정 시간이 잘못되었습니다. 유효한 시점 범위는 원본 서버 생성 시간이 아니라 {1} 일에서 지금까지입니다.
400 NoMoreSpaceInManagedInstance - 관리되는 인스턴스가 스토리지 한도에 도달했습니다. 관리되는 인스턴스의 스토리지 사용량은 (%d) MB를 초과할 수 없습니다.
400 CurrentDatabaseLogSizeExceedsMaxSize - 사용자가 현재 사용량보다 최대 로그 크기가 낮은 sku로 데이터베이스를 변경하려고 했습니다.
400 CannotUseTrailingWhitespacesInDatabaseName - 데이터베이스 이름 유효성 검사에 실패했습니다.
400 StorageAccountFull - Managed Instance가 기본 Azure Storage 계정의 총 용량에 도달했습니다. Azure Premium Storage 계정은 할당된 공간의 35TB로 제한됩니다.
400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에는 주 서버의 암호화 보호기의 키 자료가 없습니다.
400 ServerNotFound - 요청된 서버를 찾을 수 없습니다.
400 SourceServerNotFound - CreateDatabaseAsCopy API 호출에 제공된 원본 데이터베이스 ID의 서버 부분이 기존 서버에 매핑되지 않습니다.
400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업
400 InvalidBackupRetentionPeriod - {0} 보존 기간이 유효한 구성이 아닙니다. 유효한 백업 보존 기간(일)은 {1} 및 {2} 사이여야 합니다.
400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업
400 SourceDatabaseNotFound - 원본 데이터베이스가 없습니다.
400 DatabaseNumberLimitReached - SQL Database Managed Instance에 대한 최대 데이터베이스 수에 도달했습니다.
400 InvalidCollation - 데이터 정렬이 서버에서 인식되지 않습니다.
400 ManagedInstanceUpdateSloInProgress - "관리되는 인스턴스 '{0}.'에 대한 서비스 계층 변경이 진행 중이므로 작업을 완료할 수 없습니다. 진행 중인 작업이 완료되기를 기다렸다가 다시 시도하세요."
400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.
400 AkvHostNotResolvingFromNode - AKV 호스트 '{0}'은 서버 '{1}'의 SQL에서 확인할 수 없습니다.
400 InvalidDatabaseCreateOrUpdateRequest - 데이터베이스 만들기 또는 업데이트 작업에 대한 요청 본문이 잘못되었습니다.
400 InvalidResourceId - 잘못된 리소스 식별자입니다.
400 InvalidSourceDatabaseId - 잘못된 원본 데이터베이스 식별자입니다.
400 InvalidRestorableDroppedDatabaseId - 복원 가능한 삭제된 데이터베이스 식별자가 잘못되었습니다.
400 InvalidCrossSubscriptionTargetManagedInstanceId - 잘못된 교차 구독 대상 관리되는 인스턴스 식별자입니다.
400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.
400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다.
400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.
400 MissingCollation - 데이터 정렬이 필요합니다.
400 MissingSourceDatabaseId - 원본 데이터베이스 식별자가 없습니다.
400 MissingRestorePointInTime - 복원 시점 누락
400 MissingStorageContainerSasToken - 누락된 스토리지 컨테이너 SAS 토큰
400 MissingStorageContainerUri - 스토리지 컨테이너 URI 누락
400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - sourceDatabaseId가 복원 만들기 모드로 이미 제공된 경우 restoreableDroppedDatabaseId를 지정할 수 없습니다.
400 CrossSubscriptionRestorableDroppedDatabaseIdGivenForRestoreWithCrossSubscriptionSourceDatabaseId - crossSubscriptionSourceDatabaseId가 이미 제공된 경우 crossSubscriptionRestorableDroppedDatabaseId를 지정할 수 없습니다.
400 MissmatchingCrossSubscriptionTargetManagedInstanceIdWithUrl - 제공된 crossSubscriptionTargetManagedInstanceId는 URL의 인스턴스와 일치해야 합니다.
400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 CannotFindServerCertificateWithThumbprint - 지문 '{0}'가 있는 서버 인증서를 찾을 수 없습니다. PowerShell Cmdlet 'Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate'를 사용하여 인증서를 만듭니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다.
404 RestoreSourceDatabaseNotFound - 복원할 수 있는 '{0}'{1}' 데이터베이스를 찾을 수 없습니다.
404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다.
404 CannotFindObject - 개체가 없거나 사용 권한이 없으므로 개체를 찾을 수 없습니다.
404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 SubscriptionDisabled - 구독을 사용할 수 없습니다.
409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다.
409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다.
409 ConflictingDatabaseOperation - 데이터베이스에 대한 일부 작업이 이미 있으며 현재 작업이 완료될 때까지 기다려야 합니다.
409 ManagementServiceDatabaseBusy - 데이터베이스 '{0}'이(가) 다른 작업으로 사용 중입니다. 나중에 작업을 시도하세요.
409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 ActivateOrDeactivateWorkflowThrottling - 동시 워크플로가 너무 많기 때문에 활성화 또는 비활성화 워크플로가 실패했습니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다.

예제

Updates a managed database with maximal properties

Updates a managed database with minimal properties

Updates a managed database with maximal properties

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2023-08-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

샘플 응답

상태 코드:: 200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

상태 코드:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

Updates a managed database with minimal properties

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2023-08-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

샘플 응답

상태 코드:: 200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

상태 코드:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/locations/southeastasia/operationStatus/default/operationId/00000000-0000-0000-0000-000000000000?api-version=2017-03-01

정의

Name	Description
CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ManagedDatabase	관리되는 데이터베이스 리소스입니다.
ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
ManagedDatabaseStatus	데이터베이스의 상태입니다.
ManagedDatabaseUpdate	관리되는 데이터베이스 업데이트입니다.

CatalogCollationType

열거형

메타데이터 카탈로그의 데이터 정렬입니다.

값	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ManagedDatabase

Object

관리되는 데이터베이스 리소스입니다.

Name	형식	Description
id	string	리소스 ID입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.autoCompleteRestore	boolean	이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다.
properties.catalogCollation	CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
properties.collation	string	관리되는 데이터베이스의 데이터 정렬입니다.
properties.createMode	ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
properties.creationDate	string (date-time)	데이터베이스의 생성 날짜입니다.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	복원 가능한 구독 간 리소스 ID가 삭제되어 이 데이터베이스를 만들 때 복원할 수 있습니다.
properties.crossSubscriptionSourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 구독 간 원본 데이터베이스의 리소스 식별자입니다.
properties.crossSubscriptionTargetManagedInstanceId	string	구독 간 복원에 사용되는 대상 관리되는 인스턴스 ID입니다.
properties.defaultSecondaryLocation	string	지역 쌍을 이루는 지역입니다.
properties.earliestRestorePoint	string (date-time)	특정 시점 복원에 대한 가장 빠른 복원 시점입니다.
properties.failoverGroupId	string	이 관리되는 데이터베이스가 속한 인스턴스 장애 조치(failover) 그룹 리소스 식별자입니다.
properties.isLedgerOn	boolean	이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.lastBackupName	string	이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다.
properties.longTermRetentionBackupResourceId	string	이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다.
properties.recoverableDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.restorableDroppedDatabaseId	string	이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다.
properties.restorePointInTime	string (date-time)	조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.status	ManagedDatabaseStatus	데이터베이스의 상태입니다.
properties.storageContainerIdentity	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 사용됩니다. 스토리지 컨테이너 인증에 사용되는 ID를 지정합니다. 'SharedAccessSignature' 또는 'ManagedIdentity'일 수 있습니다. 지정하지 않으면 'SharedAccessSignature'가 가정됩니다.
properties.storageContainerSasToken	string	조건부. createMode가 RestoreExternalBackup이고 storageContainerIdentity가 ManagedIdentity가 아닌 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다.
properties.storageContainerUri	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다.
tags	object	리소스 태그.
type	string	리소스 종류입니다.

ManagedDatabaseCreateMode

열거형

관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).

값	Description
Default
RestoreExternalBackup
PointInTimeRestore
Recovery
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

열거형

데이터베이스의 상태입니다.

값	Description
Online
Offline
Shutdown
Creating
Inaccessible
Restoring
Updating
Stopping
Stopped
Starting
DbMoving
DbCopying

ManagedDatabaseUpdate

Object

관리되는 데이터베이스 업데이트입니다.

Name	형식	Description
properties.autoCompleteRestore	boolean	이 관리되는 데이터베이스의 자동 복원을 완료할지 여부입니다.
properties.catalogCollation	CatalogCollationType	메타데이터 카탈로그의 데이터 정렬입니다.
properties.collation	string	관리되는 데이터베이스의 데이터 정렬입니다.
properties.createMode	ManagedDatabaseCreateMode	관리되는 데이터베이스 만들기 모드입니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. SourceDatabaseName, SourceManagedInstanceName 및 PointInTime을 지정해야 합니다. RestoreExternalBackup: 외부 백업 파일에서 복원하여 데이터베이스를 만듭니다. 데이터 정렬, StorageContainerUri 및 StorageContainerSasToken을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. RecoveryableDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. RestoreLongTermRetentionBackup: 장기 보존 백업에서 복원하여 데이터베이스를 만듭니다(longTermRetentionBackupResourceId 필요).
properties.creationDate	string (date-time)	데이터베이스의 생성 날짜입니다.
properties.crossSubscriptionRestorableDroppedDatabaseId	string	복원 가능한 구독 간 리소스 ID가 삭제되어 이 데이터베이스를 만들 때 복원할 수 있습니다.
properties.crossSubscriptionSourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 구독 간 원본 데이터베이스의 리소스 식별자입니다.
properties.crossSubscriptionTargetManagedInstanceId	string	구독 간 복원에 사용되는 대상 관리되는 인스턴스 ID입니다.
properties.defaultSecondaryLocation	string	지역 쌍을 이루는 지역입니다.
properties.earliestRestorePoint	string (date-time)	특정 시점 복원에 대한 가장 빠른 복원 시점입니다.
properties.failoverGroupId	string	이 관리되는 데이터베이스가 속한 인스턴스 장애 조치(failover) 그룹 리소스 식별자입니다.
properties.isLedgerOn	boolean	이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.lastBackupName	string	이 관리되는 데이터베이스의 복원을 위한 마지막 백업 파일 이름입니다.
properties.longTermRetentionBackupResourceId	string	이 관리되는 데이터베이스의 복원에 사용할 장기 보존 백업의 이름입니다.
properties.recoverableDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.restorableDroppedDatabaseId	string	이 데이터베이스를 만들 때 복원할 복원 가능한 삭제된 데이터베이스 리소스 ID입니다.
properties.restorePointInTime	string (date-time)	조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sourceDatabaseId	string	이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.status	ManagedDatabaseStatus	데이터베이스의 상태입니다.
properties.storageContainerIdentity	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 사용됩니다. 스토리지 컨테이너 인증에 사용되는 ID를 지정합니다. 'SharedAccessSignature' 또는 'ManagedIdentity'일 수 있습니다. 지정하지 않으면 'SharedAccessSignature'가 가정됩니다.
properties.storageContainerSasToken	string	조건부. createMode가 RestoreExternalBackup이고 storageContainerIdentity가 ManagedIdentity가 아닌 경우 이 값이 필요합니다. 스토리지 컨테이너 sas 토큰을 지정합니다.
properties.storageContainerUri	string	조건부. createMode가 RestoreExternalBackup인 경우 이 값이 필요합니다. 이 복원에 대한 백업이 저장되는 스토리지 컨테이너의 URI를 지정합니다.
tags	object	리소스 태그.

다음을 통해 공유

Managed Databases - Update

URI 매개 변수

요청 본문

응답

예제

Updates a managed database with maximal properties

샘플 요청

샘플 응답

Updates a managed database with minimal properties

샘플 요청

샘플 응답

정의

CatalogCollationType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabase

ManagedDatabaseCreateMode

ManagedDatabaseStatus

ManagedDatabaseUpdate