Databases - Create Or Update

  • 참조
Service:
SQL Database
API Version:
2021-11-01

새 데이터베이스를 만들거나 기존 데이터베이스를 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?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
location True

string

리소스 위치.
identity

DatabaseIdentity

데이터베이스의 Azure Active Directory ID입니다.
properties.autoPauseDelay

integer

데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다.
properties.catalogCollation

CatalogCollationType

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

string

데이터베이스의 데이터 정렬입니다.
properties.createMode

CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
properties.elasticPoolId

string

이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다.
properties.federatedClientId

string

데이터베이스별 테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.highAvailabilityReplicaCount

integer

고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
properties.isLedgerOn

boolean

이 데이터베이스가 원장 데이터베이스인지 여부입니다. 즉, 데이터베이스의 모든 테이블은 원장 테이블입니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.licenseType

DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.
properties.longTermRetentionBackupResourceId

string

이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다.
properties.maintenanceConfigurationId

string

데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.
properties.maxSizeBytes

integer

바이트로 표현된 데이터베이스의 최대 크기입니다.
properties.minCapacity

number

일시 중지되지 않은 경우 데이터베이스가 항상 할당한 최소 용량
properties.readScale

DatabaseReadScale

읽기 전용 라우팅 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
properties.recoverableDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.recoveryServicesRecoveryPointId

string

이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다.
properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다.
properties.restorableDroppedDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다.
properties.restorePointInTime

string

새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.sampleName

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.
properties.secondaryType

SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다.
properties.sourceDatabaseDeletionDate

string

데이터베이스가 삭제된 시간을 지정합니다.
properties.sourceDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.sourceResourceId

string

이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다.

이 속성은 DataWarehouse 버전에 대해서만 지원되며 구독 간에 복원할 수 있습니다.

sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, Restore 또는 Recovery여야 합니다.

createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다.

createMode가 Restore인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다.

createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다.

원본 구독이 대상 구독과 다른 테넌트에 속하는 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트용 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.zoneRedundant

boolean

이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다.
sku

Sku

데이터베이스 SKU입니다.

SKU 목록은 지역 및 지원 제안에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함하려면 REST API 또는 다음 명령 중 하나를 사용합니다 Capabilities_ListByLocation .

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

Database

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

Database

데이터베이스를 만들었습니다.
202 Accepted

데이터베이스 만들기 또는 업데이트가 진행 중입니다.
Other Status Codes

오류 응답: ***

  • 400 InvalidDatabaseCreateOrUpdateRequest - 데이터베이스 만들기 또는 업데이트 작업에 대한 요청 본문이 잘못되었습니다.

  • 400 InvalidResourceId - 잘못된 리소스 식별자입니다.

  • 400 InvalidSourceDatabaseId - 잘못된 원본 데이터베이스 식별자입니다.

  • 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다.

  • 400 MismatchingServerNameWithUrl - 제공된 서버 이름이 URL의 이름과 일치하지 않습니다.

  • 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.

  • 400 MissingCollation - 데이터 정렬이 필요합니다.

  • MissingMaxSizeBytes 400개 - MaxSizeBytes가 필요합니다.

  • 400 MissingSkuName - Sku 이름이 필요합니다.

  • 400 MissingSourceDatabaseId - 원본 데이터베이스 식별자가 없습니다.

  • 400 InvalidLicenseType - 지정된 라이선스 유형이 잘못되었습니다.

  • 400 InvalidSkuName - 잘못된 SKU 이름입니다.

  • 400 MismatchedSkuNameAndCapacity - SKU 이름과 용량이 일치하지 않습니다.

  • 400 MismatchedSkuNameAndTier - SKU 이름과 계층이 일치하지 않습니다.

  • 400 MismatchedSkuNameAndFamily - SKU 이름과 패밀리가 일치하지 않습니다.

  • 400 LedgerNotAllowedWithSpecifiedCreateMode - IsLedgerOn은 지정된 만들기 모드에서 허용되지 않습니다.

  • 400 LedgerNotAllowedOnSampleDatabase - 샘플 데이터베이스에 대해 IsLedgerOn을 사용하여 데이터베이스를 만들 수 없습니다.

  • 400 DatabaseNameDoesNotMatchSourceDatabaseId - 지정된 데이터베이스 이름이 sourceDatabaseId의 데이터베이스 이름과 일치하지 않습니다.

  • 400 ElasticPoolNotSupportedForExternalBackupRestore - 탄력적 풀은 외부 백업 복원에 지원되지 않습니다.

  • 400 InvalidRecoverableDatabaseId - 복구 가능한 데이터베이스 식별자가 잘못되었습니다.

  • 400 InvalidRecoveryServicesRecoveryPointId - 잘못된 복구 서비스 복구 지점 식별자입니다.

  • 400 InvalidRestorableDroppedDatabaseDeletionDate - 지정된 복원 가능한 삭제된 데이터베이스 삭제 날짜가 잘못되었습니다.

  • 400 InvalidRestorableDroppedDatabaseId - 복원 가능한 삭제된 데이터베이스 식별자가 잘못되었습니다.

  • 400 MissingRecoverableDatabaseId - 복구 가능한 데이터베이스 식별자가 없습니다.

  • 400 MissingRecoveryServicesRecoveryPointId - 누락된 복구 서비스 복구 지점 ID입니다.

  • 400 MissingRestorableDroppedDatabaseId - restorableDroppedDatabaseId 누락

  • 400 MissingRestorePointInTime - 복원 시점 누락

  • 400 MissingSourceDatabaseDeletionDate - 원본 데이터베이스 삭제 날짜 누락

  • 400 MissingStorageContainerSasToken - 누락된 스토리지 컨테이너 SAS 토큰

  • 400 MissingStorageContainerUri - 스토리지 컨테이너 URI 누락

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - sourceDatabaseId가 복원 만들기 모드에서 이미 제공된 경우 restoreableDroppedDatabaseId를 지정할 수 없습니다.

  • 400 MultipleIdentitiesOnDatabase - 데이터베이스 수준에서 사용자 할당 관리 ID가 하나만 지원됩니다.

  • 400 MultipleIdentityDelegationsOnDatabase - 데이터베이스 수준에서 하나의 ID 위임만 지원됩니다.

  • 400 MissingPrimaryDelegatedIdentityClientId - 위임된 ID를 사용하려면 기본 위임 ID 클라이언트 ID를 제공하세요.

  • 400 InvalidStandbyGeoReadScale - 사용자가 지원하지 않는 대기 지역 데이터베이스에서 읽기 확장을 사용하도록 설정하려고 했습니다.

  • 400 PerDatabaseCMKKeyRotationAttemptedWhileOldThumbprintInUse - 활성 트랜잭션이 이전 키로 암호화된 로그를 보유할 때 데이터베이스 수준에서 TDE 보호기 키 회전이 차단됩니다. 이 문제를 해결할 수 있는 전략은 aka.ms/azuresqldbkeyrotation 참조하세요.

  • 400 TierChangeUnsupportedDueToMemoryOptimizedObject - 데이터베이스에 메모리 최적화 개체가 있으므로 해당 sku를 업데이트할 수 없습니다.

  • 400 PerDBCMKNotSupportedWithLTR - 데이터베이스에서 장기 백업 보존을 사용하는 경우 데이터베이스 수준 CMK가 지원되지 않습니다.

  • 400 SourceServerNotFound - CreateDatabaseAsCopy API 호출에 제공된 원본 데이터베이스 ID의 서버 부분이 기존 서버에 매핑되지 않습니다.

  • 400 ElasticPoolOverStorageUsage - 탄력적 풀의 스토리지 제한에 도달했을 때 데이터베이스에 데이터를 쓰려고 합니다.

  • 400 InvalidDatabaseCreateMode - 데이터베이스 만들기 요청이 잘못되었습니다.

  • 400 MissingAsymmetricKeyOnTargetServer - 대상 서버에 비대칭 키에 대한 액세스 권한이 없습니다.

  • 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다.

  • 400 MultipleDroppedDatabasesWithTheSameName - 서버에서 이름이 같은 삭제된 데이터베이스가 여러 대 있습니다.

  • 400 InvalidAddSecondaryPermission - 사용자에게 지정된 서버에 보조를 추가할 수 있는 충분한 권한이 없습니다.

  • 400 AzureKeyVaultClientError - Azure Key Vault 클라이언트에서 오류가 발생했습니다.

  • 400 UnsupportedServiceName - 지원되지 않는 유니코드 문자가 하나 이상 포함되어 있으므로 지정된 이름이 잘못된 이름입니다.

  • 400 AzureKeyVaultClientInfoError - Azure Key Vault 클라이언트에 대한 정보를 가져오는 동안 오류가 발생했습니다.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize - 사용자가 현재 사용량보다 최대 로그 크기가 낮은 sku로 데이터베이스를 변경하려고 했습니다.

  • 400 IsLedgerDatabaseIsNotSupportedOnResourceType - 이 리소스 종류에 대해 원장 속성 변경이 지원되지 않습니다.

  • 400 InvalidBackupStorageAccountType - 사용자가 데이터베이스를 만들거나 업데이트하는 동안 zrs/lrs를 전달했지만 고객이 허용 목록에 없거나 지정된 지역에서 zrs를 사용할 수 없기 때문에 실패했습니다.

  • 400 CannotUpdateToFreeDatabase - 무료 sku로 데이터베이스 업데이트는 지원되지 않습니다.

  • 400 DatabaseInvalidSkuPropertyCombination - 요청된 sku의 속성이 일치하지 않습니다. 유효한 조합이 지정되어 있는지 검사. 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability를 참조하세요.

  • 400 DatabaseNamedReplicaPerDatabaseLimitExceeded - 사용자가 주 데이터베이스당 허용되는 수를 초과하는 명명된 복제본(replica) 만들려고 했습니다.

  • 400 UnsupportedBackupStorageRedundancyForEdition - 요청된 백업 스토리지 중복성은 버전에서 지원되지 않습니다.

  • 400 DatabaseIsCurrentlyPinned - Microsoft에서 데이터베이스 SQL Server 엔진 버전을 고정했습니다. 데이터베이스가 프로덕션 문제에 부딪히지 않도록 하기 위해 데이터베이스가 고정되지 않을 때까지 데이터베이스의 향후 크기 조정 작업이 차단됩니다. 크기 조정에 대한 지원을 받으려면 Microsoft 지원에 문의하세요.

  • 400 RestoreTargetEditionSizeInsufficient - 사용자가 현재 할당된 원본 크기보다 작은 버전으로 데이터베이스를 복원하려고 했습니다.

  • 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.

  • 400 InvalidTierSkuCombination - 지정된 계층이 지정된 sku를 지원하지 않습니다.

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

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

  • 400 InvalidIdentityId - 제공된 하나 이상의 ID ID가 유효한 ARM 리소스 ID가 아닙니다. 유효한 ID를 입력하고 다시 시도하세요.

  • 400 LTRSterlingToVldbMigrationNotSupported - 장기 보존이 아직 하이퍼스케일에서 지원되지 않으므로 데이터베이스의 서비스 목표를 하이퍼스케일로 변경할 수 없습니다. 데이터베이스에서 장기 보존을 사용하지 않도록 설정하고 다시 시도하세요.

  • 400 TokenTooLong - 제공된 토큰이 너무 깁니다.

  • 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

  • 400 OfferDisabledOnSubscription - 구독 제품 유형은 요청된 리소스를 프로비전할 수 없습니다.

  • 400 UnableToCreateGeoChain - 원장 다이제스트의 자동 업로드가 구성되었음에도 불구하고 사용자가 보조 데이터베이스(체인)를 만들려고 했습니다.

  • 400 InvalidNumberOfIdentities - 데이터베이스 수준에서 사용자가 할당한 관리 ID가 하나만 지원됩니다.

  • 400 DatabaseNamedReplicaChainingNotAllowed - 사용자가 허용되지 않는 명명된 복제본(replica) 명명된 복제본(replica) 만들려고 했습니다.

  • 400 DatabaseNamedReplicaInvalidOperation - 사용자가 명명된 복제본(replica) 지원되지 않는 작업을 시도했습니다.

  • 400 DatabaseNamedReplicaInvalidSourceDatabase - 사용자가 원본 데이터베이스와 다른 구독 또는 지역에 명명된 복제본(replica) 만들려고 했습니다.

  • 400 InvalidTargetSubregion - 읽을 수 없는 보조 데이터베이스의 대상 서버가 DR 쌍을 이루는 Azure 지역에 있지 않습니다.

  • 400 CannotAssignIdentityToMaster - 시스템 데이터베이스에 ID를 할당할 수 없습니다. 데이터베이스 ID는 'master', 'model', 'tempdb', 'msdb' 또는 'resource' 데이터베이스에 할당할 수 없습니다.

  • 400 PerDatabaseCMKDWNotSupported - 미리 보기의 데이터베이스 수준 CMK는 Datawarehouse 버전에서 지원되지 않습니다.

  • 400 DatabaseCreationBlockedForNonActivatedCMKServer - 작업 영역이 활성화될 때까지 CMK 사용 작업 영역에 대해 SQL 풀 만들기가 차단됩니다. 먼저 제거 보호를 사용하도록 설정하고 작업 영역 관리 ID에 작업 영역 키의 Azure Key Vault 필요한 권한(가져오기, 래핑 키, 래핑 해제 키)을 부여합니다. 다음으로, 액세스 권한을 부여한 후 작업 영역을 활성화합니다.

  • 400 PartnerServerNotCompatible - 사용자가 SAWA V1 서버에서 Sterling 서버로 또는 그 반대로 데이터베이스를 복사하려고 합니다.

  • 400 IncorrectReplicationLinkState - 작업에서는 데이터베이스가 복제 링크에서 예상되는 상태일 것으로 예상합니다.

  • 400 TargetElasticPoolDoesNotExist - 탄력적 풀이 서버에 없습니다.

  • 400 ElasticPoolSkuCombinationInvalid - sku가 'ElasticPool'로 지정된 경우에만 탄력적 풀과 sku를 함께 지정할 수 있습니다.

  • 400 ElasticPoolTierCombinationInvalid - 데이터베이스 계층이 탄력적 풀 서비스 계층과 다릅니다.

  • 400 ElasticPoolNameRequired - 사용자가 탄력적 풀의 이름을 지정하지 않고 탄력적 풀 서비스 목표로 데이터베이스를 만들거나 업데이트하려고 했습니다.

  • 400 MissingThumbprintCrm - 필요한 TDE 인증서가 누락되어 CRM 데이터베이스의 복원 작업이 실패했습니다. 기존 탄력적 풀에 대한 복원 작업을 다시 시도하세요.

  • 400 ElasticPoolOverStorage - 탄력적 풀의 스토리지 제한에 도달했을 때 데이터베이스에 데이터를 쓰려고 합니다.

  • 400 ElasticPoolInconsistentDtuGuaranteeSettings - 탄력적 풀의 요청된 DTU를 초과하는 탄력적 풀의 데이터베이스에 DTU 최소를 제공하려고 합니다.

  • 400 RestoreTargetEditionSizeInsufficientV2 - 사용자가 복원된 데이터베이스의 할당된 크기보다 작은 버전으로 데이터베이스를 복원하려고 했습니다.

  • 400 TierChangeUnsupportedDueToCDCEnabledDatabase - 데이터베이스가 CDC에 대해 사용하도록 설정되어 있으므로 해당 sku를 업데이트할 수 없습니다.

  • 400 ElasticPoolDatabaseCountOverLimit - 탄력적 풀의 데이터베이스 수 제한에 도달했을 때 탄력적 풀에 데이터베이스를 만들거나 추가하려고 합니다.

  • 400 ResourcePoolStorageLimitHitDuringRestore - 풀의 나머지 스토리지 용량으로 인해 복원된 데이터베이스를 리소스 풀로 복원할 수 없습니다.

  • 400 CannotChangeToOrFromDataWarehouseTier - 사용자가 데이터베이스의 sku를 DataWarehouse 계층에서 비 DataWarehouse 계층으로 변경하거나 그 반대로 변경하려고 했습니다.

  • 400 CurrentDatabaseSizeExceedsMaxSize - 사용자가 데이터베이스의 최대 크기를 현재 사용량보다 작은 크기로 줄이려고 했습니다.

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

  • 400 PerDatabaseCMKHSNotSupported - 미리 보기의 데이터베이스 수준 CMK는 하이퍼스케일 버전에서 지원되지 않습니다.

  • 400 AzureKeyVaultKeyDisabled - Azure Key Vault 키가 비활성화되어 서버에서 작업을 완료할 수 없습니다.

  • 400 PerDatabaseCMKGeoReplicationNotSupported - 데이터베이스 수준 CMK가 미리 보기로 구성된 경우 지역 복제 및 데이터베이스 복사가 지원되지 않습니다.

  • 400 ElasticPoolDecreaseStorageLimitBelowUsage - 탄력적 풀의 스토리지 한도를 스토리지 사용량보다 낮추려고 합니다.

  • 400 AzureKeyVaultInvalidExpirationDate - Azure Key Vault 키 만료 날짜가 잘못되어 작업을 완료할 수 없습니다.

  • 400 InvalidStandbyGeoEdition - 사용자가 DTU 기반 대기 지역 만들기를 시도했습니다.

  • 400 SecurityAzureKeyVaultUrlNullOrEmpty - Azure Key Vault Uri가 null이거나 비어 있으므로 작업을 완료할 수 없습니다.

  • 400 ElasticPoolInconsistentVcoreGuaranteeSettings - 데이터베이스당 데이터베이스 수 및 VCore 최소 수는 탄력적 풀의 요청된 VCore를 초과할 수 없습니다.

  • 400 UpdateNotAllowedOnPausedDatabase - 사용자가 일시 중지된 데이터베이스에서 업데이트를 수행하려고 했습니다.

  • 400 GeoRestoreBackupStorageTypeNotSupported - 지역 중복 백업 스토리지를 사용하도록 구성되지 않은 데이터베이스에 대해 데이터베이스 복구 요청이 실행될 때 유효하지 않습니다.

  • 400 RestoreHyperscaleToNonHyperscale - 하이퍼스케일 데이터베이스 백업을 하이퍼스케일이 아닌 서비스 계층으로 복원하거나 그 반대로 복원하는 것은 지원되지 않습니다.

  • 400 SubscriptionDoesNotHaveAccessToServer - 구독에 지정된 서버에 대한 액세스 권한이 없습니다.

  • 400 RecoveryPointDoesNotExist - 지정된 복구 지점이 없거나 유효하지 않습니다.

  • 400 AzureKeyVaultNoServerIdentity - 서버 ID가 올바르게 구성되지 않았습니다.

  • 400 InvalidMaxSizeTierCombination - 지정된 계층은 지정된 데이터베이스 최대 크기를 지원하지 않습니다.

  • 400 LtrBackupNotFound - 지정된 장기 보존 백업이 없습니다.

  • 400 AzureKeyVaultInvalidUri - Azure Key Vault 잘못된 응답입니다. 유효한 Azure Key Vault URI를 사용하세요.

  • 400 InvalidPointInTime - 지정한 시점이 데이터베이스에 유효하지 않습니다.

  • 400 AzureKeyVaultMissingPermissions - 서버에 Azure Key Vault 대한 필수 권한이 없습니다.

  • 400 GeoRestoreCannotResolveTargetCluster - 서버에 대한 대상 클러스터를 resolve 수 없음

  • 400 InvalidReadScaleEdition - 사용자가 지원하지 않는 데이터베이스 형식에서 읽기 확장을 사용하도록 설정하려고 했습니다.

  • 400 CannotSpecifyEditionOrSloWhenRestoringToPool - 탄력적 풀로 복원할 때 대상 서비스 수준 목표 또는 버전을 지정하는 것은 지원되지 않습니다.

  • 400 InvalidReadScaleUnits - 사용자가 지원되지 않는 읽기 크기 조정 값을 제공하려고 했습니다.

  • 400 RestoreNotSupportedForGeoDrSecondary - 지정 시간 복원 및 데이터베이스 복구 작업은 현재 지역 보조 데이터베이스로 구성된 데이터베이스에서 지원되지 않습니다.

  • 400 SecurityAzureKeyVaultInvalidKeyName - 잘못된 서버 키 이름으로 인해 작업을 완료할 수 없습니다.

  • 400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다.

  • 400 GeoSecondaryMaxSizeUpdateFailed - 지역 보조 데이터베이스는 요청된 maxsize 값을 지원하지 않는 SLO이거나 지역 보조 데이터베이스가 지원되지 않는 지역에 있거나 지역 보조 데이터베이스에서 업데이트 작업이 이미 진행 중입니다.

  • 400 AdalGenericError - Azure Active Directory 오류가 발생하여 작업을 완료할 수 없습니다.

  • 400 AdalServicePrincipalNotFound - Azure Active Directory 라이브러리 서비스 주체를 찾을 수 없음 오류가 발생하여 작업을 완료할 수 없습니다.

  • 400 InvalidTier - 사용자가 잘못된 계층을 지정했습니다.

  • 400 AzureKeyVaultMalformedVaultUri - 제공된 Key Vault URI가 잘못되었습니다.

  • 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.

  • 400 RequestedDatabaseSizeRequiresShrink - 사용자가 데이터베이스의 MAXSIZE를 더 작은 크기로 수정한 다음 현재 크기로 수정하기 위해 ALTER DATABASE MODIFY MAXSIZE를 시도했습니다.

  • 400 CurrentDatabaseSizeExceedsDbMaxSize - 사용자가 데이터베이스의 최대 크기를 현재 사용량보다 작은 크기로 줄이려고 했습니다.

  • 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.

  • 400 CannotUseTrailingWhitespacesInDatabaseName - 데이터베이스 이름 유효성 검사에 실패했습니다.

  • 400 SourceDatabaseEditionCouldNotBeUpgraded - 원본 데이터베이스는 대상 데이터베이스보다 높은 버전을 가질 수 없습니다.

  • 400 SecurityAdalPrincipalCertExpiredError - Azure Key Vault 보안 주체 인증서가 만료되어 작업을 완료할 수 없습니다.

  • 400 TargetDatabaseEditionCouldNotBeDowngraded - 대상 데이터베이스는 원본 데이터베이스보다 낮은 버전을 가질 수 없습니다.

  • 400 UpdateNotAllowedIfGeoDrOperationInProgress - 서버 '{1}'의 데이터베이스 '{0}'에 대한 복사 또는 장애 조치(failover) 작업이 현재 진행 중이므로 작업이 허용되지 않습니다.

  • 400 InvalidCollation - 데이터 정렬이 서버에서 인식되지 않습니다.

  • 400 SecurityInvalidAzureKeyVaultRecoveryLevel - 제공된 Key Vault URI가 잘못되었습니다.

  • 400 KeyMaterialNotFoundOnRemoteServer - 원격 서버는 TDE 보호기로 사용되는 키 자료에 액세스할 수 없습니다.

  • 400 AzureKeyVaultRsaKeyNotSupported - 제공된 키 자격 증명 모음은 지원되지 않는 RSA 키 크기 또는 키 형식을 사용합니다. 지원되는 RSA 키 크기는 2048 또는 3072이고 키 유형은 RSA 또는 RSA-HSM입니다.

  • 400 SameKeyMaterialNotFoundOnRemoteServer - 보조 서버에 주 서버의 암호화 보호기의 키 자료가 없습니다.

  • 400 ElasticPoolOverFileSpace - 탄력적 풀에 파일 공간이 부족합니다.

  • 400 PartnerDBNotCompatibleForSGXEnclave - Enclave 사용 데이터베이스에 대해 GeoDR 링크를 설정하거나 SLO를 업데이트하려는 시도는 두 데이터베이스가 DC 시리즈 하드웨어에서 실행되는 경우에만 지원됩니다.

  • 400 UpdateNotAllowedInCurrentReplicationState - 현재 복제 상태의 데이터베이스에서 작업이 허용되지 않습니다.

  • 400 InvalidLicenseType - 사용자가 지원되지 않는 라이선스 유형으로 데이터베이스 또는 탄력적 풀을 만들거나 업데이트하려고 했습니다.

  • 400 GeoReplicaLimitReached - 복제본(replica)당 복제 제한에 도달했습니다.

  • 400 UnsupportedCapacity - 사용자가 지원되지 않는 용량으로 데이터베이스를 만들거나 업데이트하려고 했습니다.

  • 400 ReplicationSourceAndTargetMustHaveSameName - 복제 원본 및 대상 데이터베이스의 이름은 같아야 합니다.

  • 400 ProvisioningDisabled - 리소스 작업 권한 부여자의 오류 메시지를 변경 없이 있는 그대로 표시합니다.

  • 400 ReplicationSourceAndTargetMustBeInDifferentServers - 복제 원본 및 대상 데이터베이스는 다른 논리 서버에 있어야 합니다.

  • 400 CannotUpdateIsLedgerDatabase - 기존 데이터베이스의 원장 속성을 업데이트할 수 없습니다.

  • 400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다.

  • 400 RemoteDatabaseCopyPermission - 사용자에게 지정된 서버에 데이터베이스 복사본을 만들 수 있는 충분한 권한이 없습니다.

  • 400 CannotMoveOrDropSyncMetadataDatabase - 동기화 메타데이터 데이터베이스로 사용되는 데이터베이스를 삭제할 수 없습니다.

  • 400 SecurityAzureKeyVaultGeoChainError - BYOK(Azure Key Vault)를 사용하여 투명한 데이터 암호화를 사용하도록 설정할 때 보조 보조 데이터베이스(체인이라고 하는 프로세스)를 만드는 것은 지원되지 않습니다.

  • 400 RestoreToFreeEditionNotSupported - 복원 및 GeoRestore 대상은 무료 데이터베이스일 수 없습니다.

  • 400 CannotMoveOrDropJobAccountDatabase - 작업 계정과 연결된 데이터베이스를 삭제할 수 없습니다.

  • 400 RestoreNotSupportedForFreeEdition - 복원 및 GeoRestore는 무료 데이터베이스에 대해 지원되지 않습니다.

  • 400 JobAgentDatabaseEditionUnsupported - 지정된 데이터베이스의 서비스 수준 목표는 작업 에이전트 데이터베이스로 사용할 수 없습니다.

  • 400 InvalidDroppedDatabase - 삭제된 원본 데이터베이스가 지원되는 복구 기간 내에 서버에 존재하지 않습니다.

  • 400 InvalidLiveDatabase - 원본 데이터베이스가 지원되는 복구 기간 내에 서버에 존재하지 않습니다. 삭제된 데이터베이스를 복원하는 경우 삭제 날짜를 지정하세요.

  • 400 InvalidVldbRecoverySlo - 하이퍼스케일 버전 복구를 사용하려면 원본 데이터베이스와 대상 데이터베이스가 모두 하이퍼스케일 서비스 수준 목표를 사용해야 합니다.

  • 400 SourceDatabaseNotFound - 원본 데이터베이스가 없습니다.

  • 400 InvalidVldbRestoreSlo - 하이퍼스케일 버전 지정 시간 복원을 사용하려면 원본 데이터베이스와 대상 데이터베이스가 모두 하이퍼스케일 서비스 수준 목표를 사용해야 합니다.

  • 400 CannotSpecifyPoolOrSlo - 탄력적 풀 지정 및/또는 서비스 수준 목표 또는 버전 변경은 버전에서 지원되지 않습니다.

  • 400 InvalidPublicMaintenanceConfiguration - 사용자가 내부 ID(잘못된 형식 또는 잘못된 지역)로 변환할 수 없는 공용 유지 관리 구성을 지정하려고 했습니다.

  • 400 MaintenanceWindowNotSupportedForNamedReplica - 사용자가 지원되지 않는 기본 유지 관리 기간이 아닌 복제본(replica) 명명된 이름을 만들거나 업데이트하려고 했습니다.

  • 400 ChangeUnsupportedOnEntity - 사용자가 지정된 엔터티에서 지원되지 않는 만들기/업데이트/삭제 작업을 시도했습니다.

  • 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 OperationIdNotFound - ID가 있는 작업이 없습니다.

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

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

  • 404 DatabaseDoesNotExist - 사용자가 이 서버 instance 존재하지 않는 데이터베이스 이름을 지정했습니다.

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

  • 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다.

  • 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다.

  • 404 CannotFindObject - 개체가 존재하지 않거나 권한이 없으므로 개체를 찾을 수 없습니다.

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

  • 405 UnsupportedReplicationOperation - 데이터베이스에서 지원되지 않는 복제 작업이 시작되었습니다.

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

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

  • 409 FreeDbAlreadyExists - 지역당 구독에 대해 하나의 무료 데이터베이스만 존재할 수 있습니다.

  • 409 ConflictingServerOperation - 서버에 대한 작업이 현재 진행 중입니다.

  • 409 SubscriptionDisabled - 구독을 사용할 수 없습니다.

  • 409 ConflictingSystemOperationInProgress - 데이터베이스에서 시스템 유지 관리 작업이 진행 중이며 추가 작업이 완료될 때까지 기다려야 합니다.

  • 409 ConflictRequestToUpdateBackupRedundancy - 백업 스토리지 중복성을 변경하기 위한 충돌 요청이 아직 진행 중입니다.

  • 409 SkuAssignmentInProgress - 이전 요청이 완료되지 않았기 때문에 현재 할당 요청을 처리할 수 없습니다.

  • 409 DatabaseElasticPoolMaintenanceConflict - 사용자가 데이터베이스의 탄력적 풀과 충돌하는 지정된 유지 관리 구성으로 데이터베이스를 만들거나 업데이트하려고 했습니다.

  • 409 ServerDtuQuotaExceeded - 서버가 허용된 데이터베이스 처리량 단위 할당량을 초과하므로 작업을 수행할 수 없습니다.

  • 409 UnableToAlterDatabaseInReplication - 복제 관계의 데이터베이스에서 사용자가 버전을 변경했습니다.

  • 409 SubscriptionVcoreQuotaExceeded - 구독이 허용된 vCore 할당량을 초과하므로 작업을 수행할 수 없습니다.

  • 409 CurrentMemoryUsageExceedsSkuQuota - 사용자가 리소스 사용량이 높아서 완료할 수 없는 sku 업데이트 작업을 시도했습니다.

  • 409 ServerKeyNameAlreadyExists - 서버 키가 서버에 이미 있습니다.

  • 409 ServerKeyUriAlreadyExists - 서버 키 URI가 서버에 이미 있습니다.

  • 409 ServerKeyDoesNotExists - 서버 키가 없습니다.

  • 409 UpdateSloInProgress - 사용자가 SLO 업데이트가 진행되는 동안 호환되지 않는 작업을 시작하려고 했습니다.

  • 409 UpdateSloFailedDatabaseTooBusy - 데이터베이스가 너무 바빠서 SLO 업데이트 작업을 완료할 수 없습니다.

  • 409 ElasticPoolBusy - 사용 중인 탄력적 풀에서 관리 작업이 시도되었습니다.

  • 409 AzureKeyVaultKeyNameNotFound - Azure Key Vault 키 이름이 없으므로 작업을 완료할 수 없습니다.

  • 409 AzureKeyVaultKeyInUse - 현재 서버에서 키를 사용하고 있습니다.

  • 409 ServerDisabled - 서버를 사용할 수 없습니다.

  • 409 ConflictingDatabaseOperation - 데이터베이스에 일부 작업이 이미 있으며 현재 작업이 완료될 때까지 기다려야 합니다.

  • 409 SimultaneousSkuChangeNotAllowed - 서비스 목표 변경 작업은 복제 관계의 두 데이터베이스에서 동시에 실행할 수 없습니다.

  • 409 TargetElasticPoolBeingUpdated - 이 탄력적 풀의 데이터베이스 중 하나에 대한 복사 작업이 진행 중이므로 탄력적 풀 업데이트를 시작할 수 없습니다.

  • 409 InvalidOperationForDatabaseNotInReplicationRelationship - 복제 관계에 이미 있는 데이터베이스에서 복제 시드 작업이 수행되었습니다.

  • 409 InvalidOperationForDatabaseInReplicationRelationship - 복제 관계에 이미 있는 데이터베이스에서 복제 시드 작업이 수행되었습니다.

  • 409 DuplicateGeoDrRelation - 데이터베이스가 이미 복제 관계에 있습니다. 중복된 요청입니다.

  • 409 DatabaseCopyLimitPerReplicaReached - 사용자가 동시 데이터베이스 복사본의 제한에 도달했습니다.

  • 409 RemoteDatabaseExists - 대상 데이터베이스 이름이 대상 서버에 이미 있습니다.

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

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

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

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

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

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

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

  • 500 ActivateOrDeactivateWorkflowThrottling - 동시 워크플로가 너무 많기 때문에 활성화 또는 비활성화 워크플로가 실패했습니다.

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

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

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

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

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

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

  • 503 AzureKeyVaultConnectionFailed - Azure Key Vault 연결 시도가 실패했기 때문에 서버에서 작업을 완료할 수 없습니다.

  • 503 AzureKeyVaultGenericConnectionError - Key Vault 정보를 검색하려고 할 때 오류가 발생하여 작업을 완료할 수 없습니다.

  • 503 DatabaseUnavailable - 데이터베이스를 사용할 수 없어 작업이 실패했습니다.

  • 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다.

예제

Creates a data warehouse database as a cross-subscription restore from a backup of a dropped database.
Creates a data warehouse database as a cross-subscription restore from a geo-backup.
Creates a data warehouse database as a cross-subscription restore from a restore point of an existing database.
Creates a database as a copy.
Creates a database as an on-line secondary.
Creates a database as named replica secondary.
Creates a database from PointInTimeRestore.
Creates a database with default mode.
Creates a database with ledger on.
Creates a database with minimum number of parameters.
Creates a database with preferred maintenance window.
Creates a database with specified backup storage redundancy.
Creates a VCore database by specifying service objective name.
Creates a VCore database by specifying sku name and capacity.

Creates a data warehouse database as a cross-subscription restore from a backup of a dropped database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "Restore",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/srcsvr/restorableDroppedDatabases/srcdw,131403269876900000"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a data warehouse database as a cross-subscription restore from a geo-backup.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2021-11-01

{
  "location": "westus",
  "properties": {
    "createMode": "Recovery",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-EastUS/providers/Microsoft.Sql/servers/srcsvr/recoverabledatabases/srcdw"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "westus",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "westus",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-WestUS/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a data warehouse database as a cross-subscription restore from a restore point of an existing database.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceResourceId": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/srcsvr/databases/srcdw",
    "restorePointInTime": "2022-01-22T05:35:31.503Z"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "DataWarehouse",
    "tier": "DataWarehouse",
    "capacity": 9000
  },
  "kind": "v12.0,user,datawarehouse,gen2",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 263882790666240,
    "status": "Online",
    "databaseId": "188784c9-d602-4684-86cf-e67b6f03551a",
    "creationDate": "2022-01-24T06:46:14.99Z",
    "currentServiceObjectiveName": "DW1000c",
    "requestedServiceObjectiveName": "DW1000c",
    "defaultSecondaryLocation": "eastus",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "currentSku": {
      "name": "DataWarehouse",
      "tier": "DataWarehouse",
      "capacity": 9000
    },
    "currentBackupStorageRedundancy": "Geo"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdw",
  "name": "testdw",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database as a copy.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Copy",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy",
  "name": "dbcopy",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbcopy",
  "name": "dbcopy",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database as an on-line secondary.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Secondary",
    "secondaryType": "Geo",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-NorthEurope/providers/Microsoft.Sql/servers/testsvr1/databases/testdb"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "secondaryType": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database as named replica secondary.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "capacity": 2
  },
  "properties": {
    "createMode": "Secondary",
    "secondaryType": "Named",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-NorthEurope/providers/Microsoft.Sql/servers/testsvr1/databases/primarydb"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore,hyperscale",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": -1,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "HS_Gen4",
      "tier": "Hyperscale",
      "family": "Gen4",
      "capacity": 2
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "HS_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "HS_Gen4_2",
    "highAvailabilityReplicaCount": 0,
    "licenseType": "LicenseIncluded",
    "secondaryType": "Named",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "HS_Gen4",
    "tier": "Hyperscale",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore,hyperscale",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": -1,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "HS_Gen4",
      "tier": "Hyperscale",
      "family": "Gen4",
      "capacity": 2
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "HS_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "HS_Gen4_2",
    "highAvailabilityReplicaCount": 0,
    "licenseType": "LicenseIncluded",
    "secondaryType": "Named",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database from PointInTimeRestore.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "createMode": "PointInTimeRestore",
    "sourceDatabaseId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
    "restorePointInTime": "2020-10-22T05:35:31.503Z"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "2463ef48-53e2-4c26-9781-2d7138080bfd",
    "creationDate": "2020-10-23T20:31:35.807Z",
    "currentServiceObjectiveName": "S0",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "SoutheastAsia",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-10-23T20:47:37Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false
  },
  "location": "SoutheastAsia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr",
  "name": "dbpitr",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "2463ef48-53e2-4c26-9781-2d7138080bfd",
    "creationDate": "2020-10-23T20:31:35.807Z",
    "currentServiceObjectiveName": "S0",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "SoutheastAsia",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-10-23T20:47:37Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false
  },
  "location": "SoutheastAsia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SoutheastAsia/providers/Microsoft.Sql/servers/testsvr/databases/dbpitr",
  "name": "dbpitr",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database with default mode.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "S0",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Default",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database with ledger on.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "isLedgerOn": true
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S0",
    "currentBackupStorageRedundancy": "Geo",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": true
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database with minimum number of parameters.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia"
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S0",
    "currentBackupStorageRedundancy": "Geo",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database with preferred maintenance window.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "properties": {
    "createMode": "Default",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-08-29T06:41:18.283Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 50
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "S2",
    "tier": "Standard"
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "S2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "earliestRestoreDate": "2020-08-29T06:41:18.283Z",
    "readScale": "Disabled",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 50
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a database with specified backup storage redundancy.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "properties": {
    "requestedBackupStorageRedundancy": "Zone"
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "Standard",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Zone",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Zone",
    "requestedServiceObjectiveName": "S0",
    "zoneRedundant": false,
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a VCore database by specifying service objective name.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "BC",
    "family": "Gen4",
    "capacity": 2
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "isLedgerOn": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

Creates a VCore database by specifying sku name and capacity.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2021-11-01

{
  "location": "southeastasia",
  "sku": {
    "name": "BC_Gen4",
    "capacity": 2
  }
}

Sample Response

Status code:
200 
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
201 
{
  "sku": {
    "name": "BC_Gen4",
    "tier": "BusinessCritical",
    "family": "Gen4",
    "capacity": 2
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen4_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "readScale": "Enabled",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "currentSku": {
      "name": "BC_Gen4",
      "tier": "BusinessCritical",
      "capacity": 2
    }
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}
Status code:
202

정의

Name Description
BackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.
CatalogCollationType

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

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
Database

데이터베이스 리소스입니다.
DatabaseIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.
DatabaseIdentityType

ID 유형
DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.
DatabaseReadScale

읽기 전용 라우팅 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
DatabaseStatus

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

리소스에 대한 Azure Active Directory ID 구성입니다.
SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.
SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다.
Sku

ARM 리소스 SKU입니다.

BackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.

Name 형식 Description
Geo

string

GeoZone

string

Local

string

Zone

string

CatalogCollationType

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

Name 형식 Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.

Name 형식 Description
Copy

string

Default

string

OnlineSecondary

string

PointInTimeRestore

string

Recovery

string

Restore

string

RestoreExternalBackup

string

RestoreExternalBackupSecondary

string

RestoreLongTermRetentionBackup

string

Secondary

string

Database

데이터베이스 리소스입니다.

Name 형식 Description
id

string

리소스 ID입니다.
identity

DatabaseIdentity

데이터베이스의 Azure Active Directory ID입니다.
kind

string

데이터베이스 종류입니다. Azure Portal 환경에 사용되는 메타데이터입니다.
location

string

리소스 위치.
managedBy

string

데이터베이스를 관리하는 리소스입니다.
name

string

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

integer

데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다.
properties.catalogCollation

CatalogCollationType

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

string

데이터베이스의 데이터 정렬입니다.
properties.createMode

CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

보조: 기존 데이터베이스의 보조 복제본(replica) 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime을 지정하여 이전 시점부터 복원할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId를 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
properties.creationDate

string

데이터베이스의 생성 날짜(ISO8601 형식)입니다.
properties.currentBackupStorageRedundancy

BackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다.
properties.currentServiceObjectiveName

string

데이터베이스의 현재 서비스 수준 목표 이름입니다.
properties.currentSku

Sku

SKU의 이름 및 계층입니다.
properties.databaseId

string

데이터베이스의 ID입니다.
properties.defaultSecondaryLocation

string

이 데이터베이스의 기본 보조 지역입니다.
properties.earliestRestoreDate

string

이 데이터베이스에 복원을 사용할 수 있는 가장 빠른 시작 날짜와 시간을 기록합니다(ISO8601 형식).
properties.elasticPoolId

string

이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다.
properties.failoverGroupId

string

이 데이터베이스가 속한 장애 조치(failover) 그룹 리소스 식별자입니다.
properties.federatedClientId

string

데이터베이스별 테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.highAvailabilityReplicaCount

integer

고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
properties.isInfraEncryptionEnabled

boolean

이 데이터베이스에 대해 인프라 암호화를 사용할 수 있습니다.
properties.isLedgerOn

boolean

이 데이터베이스가 원장 데이터베이스인지 여부입니다. 즉, 데이터베이스의 모든 테이블은 원장 테이블입니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다.
properties.licenseType

DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.
properties.longTermRetentionBackupResourceId

string

이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다.
properties.maintenanceConfigurationId

string

데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다.
properties.maxLogSizeBytes

integer

이 데이터베이스의 최대 로그 크기입니다.
properties.maxSizeBytes

integer

바이트로 표현된 데이터베이스의 최대 크기입니다.
properties.minCapacity

number

일시 중지되지 않은 경우 데이터베이스가 항상 할당할 최소 용량
properties.pausedDate

string

사용자 구성 또는 작업(ISO8601 형식)에 의해 데이터베이스가 일시 중지된 날짜입니다. 데이터베이스가 준비되면 Null입니다.
properties.readScale

DatabaseReadScale

읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.
properties.recoverableDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다.
properties.recoveryServicesRecoveryPointId

string

이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다.
properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다.
properties.requestedServiceObjectiveName

string

데이터베이스의 요청된 서비스 수준 목표 이름입니다.
properties.restorableDroppedDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다.
properties.restorePointInTime

string

새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.resumedDate

string

사용자 작업 또는 데이터베이스 로그인(ISO8601 형식)에 의해 데이터베이스가 다시 시작된 날짜입니다. 데이터베이스가 일시 중지된 경우 Null입니다.
properties.sampleName

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.
properties.secondaryType

SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다.
properties.sourceDatabaseDeletionDate

string

데이터베이스가 삭제된 시간을 지정합니다.
properties.sourceDatabaseId

string

이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다.
properties.sourceResourceId

string

이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다.

이 속성은 DataWarehouse 버전에서만 지원되며 구독 간에 복원할 수 있습니다.

sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, Restore 또는 Recovery여야 합니다.

createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다.

createMode가 복원인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다.

createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다.

원본 구독이 대상 구독과 다른 테넌트인 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트용 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status

DatabaseStatus

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

boolean

이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다.
sku

Sku

데이터베이스 SKU입니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 REST API 또는 다음 명령 중 하나를 사용합니다 Capabilities_ListByLocation .

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
tags

object

리소스 태그.
type

string

리소스 종류.

DatabaseIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

Name 형식 Description
tenantId

string

Azure Active Directory 테넌트 ID입니다.
type

DatabaseIdentityType

ID 유형
userAssignedIdentities

<string,  DatabaseUserIdentity>

사용할 사용자 할당 ID의 리소스 ID

DatabaseIdentityType

ID 유형

Name 형식 Description
None

string

UserAssigned

string

DatabaseLicenseType

이 데이터베이스에 적용할 라이선스 유형입니다. LicenseIncluded라이선스가 필요하거나 BasePrice 라이선스가 있고 Azure 하이브리드 혜택 자격이 있는 경우 입니다.

Name 형식 Description
BasePrice

string

LicenseIncluded

string

DatabaseReadScale

읽기 전용 라우팅 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 해당 연결 문자열 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본(replica) 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다.

Name 형식 Description
Disabled

string

Enabled

string

DatabaseStatus

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

Name 형식 Description
AutoClosed

string

Copying

string

Creating

string

Disabled

string

EmergencyMode

string

Inaccessible

string

Offline

string

OfflineChangingDwPerformanceTiers

string

OfflineSecondary

string

Online

string

OnlineChangingDwPerformanceTiers

string

Paused

string

Pausing

string

Recovering

string

RecoveryPending

string

Restoring

string

Resuming

string

Scaling

string

Shutdown

string

Standby

string

Starting

string

Stopped

string

Stopping

string

Suspect

string

DatabaseUserIdentity

리소스에 대한 Azure Active Directory ID 구성입니다.

Name 형식 Description
clientId

string

Azure Active Directory 클라이언트 ID입니다.
principalId

string

Azure Active Directory 보안 주체 ID입니다.

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다.

Name 형식 Description
AdventureWorksLT

string

WideWorldImportersFull

string

WideWorldImportersStd

string

SecondaryType

보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo 및 Named입니다.

Name 형식 Description
Geo

string

Named

string

Sku

ARM 리소스 SKU입니다.

Name 형식 Description
capacity

integer

특정 SKU의 용량입니다.
family

string

서비스에 동일한 SKU에 대해 서로 다른 세대의 하드웨어가 있는 경우 여기에서 캡처할 수 있습니다.
name

string

SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.
size

string

특정 SKU의 크기
tier

string

특정 SKU의 계층 또는 버전(예: 기본, 프리미엄)입니다.