Managed Instances - Create Or Update

서비스:

SQL Database

API 버전:

2021-11-01

관리되는 인스턴스를 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2021-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
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
location	True	string	리소스 위치입니다.
identity		ResourceIdentity	관리되는 인스턴스의 Azure Active Directory ID입니다.
properties.administratorLogin		string	관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요).
properties.administratorLoginPassword		string	관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요).
properties.administrators		ManagedInstanceExternalAdministrator	서버의 Azure Active Directory 관리자입니다.
properties.collation		string	관리되는 인스턴스의 데이터 정렬입니다.
properties.dnsZonePartner		string (arm-id)	이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다.
properties.instancePoolId		string	이 관리되는 서버가 속한 인스턴스 풀의 ID입니다.
properties.keyId		string	암호화에 사용할 키의 CMK URI입니다.
properties.licenseType		ManagedInstanceLicenseType	라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.
properties.maintenanceConfigurationId		string	이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다.
properties.managedInstanceCreateMode		ManagedServerCreateMode	데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.
properties.minimalTlsVersion		string	최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string (arm-id)	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.proxyOverride		ManagedInstanceProxyOverride	인스턴스에 연결하는 데 사용되는 연결 유형입니다.
properties.publicDataEndpointEnabled		boolean	공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
properties.restorePointInTime		string (date-time)	새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.servicePrincipal		ServicePrincipal	관리되는 인스턴스의 서비스 주체입니다.
properties.sourceManagedInstanceId		string (arm-id)	이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다.
properties.storageSizeInGB		integer (int32)	스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다.
properties.subnetId		string (arm-id)	관리되는 인스턴스에 대한 서브넷 리소스 ID입니다.
properties.timezoneId		string	표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\표준 시간대 아래의 레지스트리에 ID를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 유지합니다. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server를 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "Pacific Standard Time" 또는 "W입니다. 유럽 표준시".
properties.vCores		integer (int32)	vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant		boolean	다중 az를 사용할 수 있는지 여부입니다.
sku		Sku	관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags		object	리소스 태그.

응답

Name	형식	Description
200 OK	ManagedInstance	관리되는 인스턴스를 업데이트했습니다.
201 Created	ManagedInstance	관리되는 인스턴스를 성공적으로 만들었습니다.
202 Accepted		허용
Other Status Codes		오류 응답: *** 400 NameAlreadyExists - 제공된 이름이 이미 있습니다. 400 InvalidCollation - 잘못된 데이터 정렬입니다. 400 ProvisioningDisabled - 리소스 작업 권한 부여자의 오류 메시지를 변경 없이 있는 그대로 표시합니다. 400 RegionDoesNotAllowProvisioning - 선택한 위치가 새 Windows Azure SQL Database 서버를 허용하지 않습니다. 나중에 변경 될 수 있습니다. 400 UnableToResolveRemoteServer - 잘못된 서버 이름 또는 DNS 연결 문제로 인해 원격 파트너 서버 이름을 확인할 수 없습니다. 400 HkCannotSwitchToInactive - 메모리 최적화 개체가 있으므로 데이터베이스에서 가격 책정 계층 업데이트를 진행할 수 없습니다. 이러한 개체를 삭제하고 다시 시도하세요. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 CloudLifterUnsupportedFeature - 이 기능은 현재 Managed Instance에서 사용할 수 없습니다. 400 ManagedInstanceSloUpdateFailed - SLO '{0}' 작업은 '{1}'의 메모리 사용량이 할당량을 초과하여 성공할 수 없습니다. 400 OperationCanNotStartDueToMiLink - Managed Instance 링크를 통해 만드는 프로세스에 데이터베이스가 있으므로 '{0}' 작업을 완료할 수 없습니다. 링크 만들기가 완료되기를 기다리거나 링크를 삭제하고 작업을 다시 시도하세요. 400 ManagedInstanceLocalStorageUpdateSloDisabled - 로컬 스토리지가 있는 관리되는 인스턴스에 대한 SLO 업데이트는 아직 지원되지 않습니다. 400 InvalidSubnetResourceId - 관리되는 인스턴스 만들기 또는 업데이트에 대해 제공된 서브넷 리소스 ID가 잘못되었습니다. 400 VnetInWrongRegion - 가상 네트워크가 잘못된 지역에 있습니다. 400 AlterDbDeactivatedNotSupported - 서버 '{0}', 데이터베이스 '{1}'에 대한 데이터베이스 작업이 예기치 않은 지연으로 인해 실패했습니다. 다시 시도하세요. 400 VnetAddressRangeError - 가상 네트워크 주소 범위가 잘못되었습니다. 400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다. 400 VnetConfigIsNotAllowed - 가상 네트워크 구성은 허용되지 않습니다. 400 InstanceFailoverGroupDoesNotExist - 장애 조치(failover) 그룹이 서버에 없습니다. 400 ManagedInstanceClassicVnetNotSupported - Managed Instance를 클래식 가상 네트워크에 조인할 수 없습니다. 400 VnetConfigHasNsg - 사용자가 네트워크 보안 그룹과 함께 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetConfigHasNoUdr - 사용자가 기본 사용자 정의 경로 테이블 없이 Managed Server 서브넷을 삽입하려고 했습니다. 400 VnetConfigHasInvalidUdr - 사용자가 잘못된 사용자 정의 경로 테이블을 사용하여 관리되는 서버 서브넷을 삽입하려고 했습니다. VnetConfigHasInvalidDns 400개 - 사용자가 잘못된 사용자 지정 DNS를 사용하여 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetConfigHasServiceEndpoints - 사용자가 서비스 엔드포인트를 사용하여 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetSubnetIsInUse - 사용자가 비어 있지 않은 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetSubnetIsLocked - 사용자가 잠긴 범위에 있는 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetSubnetIsGateway - 사용자가 게이트웨이 서브넷인 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetSubnetIsUnknown - 사용자가 존재하지 않는 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 VnetSubnetConflictWithIntendedPolicy - 사용자가 IntendedPolicy와 충돌하는 관리되는 서버 서브넷을 삽입하려고 했습니다. 400 ManagedInstanceInvalidEditionForSku - 지정된 버전 {0} 지정된 SKU {1}일치하지 않습니다. 400 ManagedInstanceInvalidLicenseType - {0} 지정된 라이선스 유형이 잘못되었습니다. 400 ManagedInstanceUpdateSloInProgress - "관리되는 인스턴스 '{0}.'에 대한 서비스 계층 변경이 진행 중이므로 작업을 완료할 수 없습니다. 진행 중인 작업이 완료되기를 기다렸다가 다시 시도하세요." 400 VnetResourceNotFound - 리소스를 찾을 수 없습니다. '{0}'. 400 InstanceCollationUpdateNotSupported - 사용자는 Managed Instance에서 인스턴스 데이터 정렬을 변경할 수 없습니다. 400 CreateManagedInstanceWithNonDefaultCollationNotSupported - 사용자는 데이터 정렬 'SQL_Latin1_General_CP1_CI_AS'만 사용하여 Managed Instance를 만들 수 있습니다. 400 ManagedInstanceOperationInProgress - {0} 작업이 진행 중이므로 작업을 완료할 수 없습니다. 진행 중인 작업이 완료되기를 기다렸다가 다시 시도하세요. 400 ManagedInstanceExceedMaxAzureStorage - 범용 인스턴스에 할당된 총 스토리지 크기가 {0}초과하므로 작업을 완료할 수 없습니다. 데이터베이스 파일 수를 줄이고 작업을 다시 시도하세요. 400 ManagedInstanceHasGeoReplica - 인스턴스가 지역에서 복제된 보조 인스턴스를 구성했기 때문에 작업을 완료할 수 없습니다. 400 InvalidDnsZone - 관리되는 인스턴스가 이미 있는 서브넷 {0} 지역 복제 보조 인스턴스로 배포하려고 하므로 작업이 실패했습니다. 관리되는 인스턴스가 서브넷에 배포된 첫 번째 인스턴스인 경우에만 관리되는 인스턴스를 지역 복제 보조 복제본으로 배포할 수 있습니다. 관리되는 인스턴스를 기존 관리되는 인스턴스가 없는 다른 서브넷에 지역 복제 보조 인스턴스로 배포하거나 기존 관리형 인스턴스를 사용하여 서브넷에 배포하는 경우 지역 복제 옵션을 사용하지 않도록 설정하는 것이 좋습니다. 400 ManagedInstanceInvalidStorageSizeLessThenCurrentSizeUsed - 잘못된 스토리지 크기: 스토리지 크기 제한({0} GB)이 현재 사용된 스토리지({1} GB)보다 적습니다. 더 높은 스토리지 크기 제한을 지정하세요. 400 InvalidTimezone - 잘못된 표준 시간대입니다. 400 InstanceTimezoneUpdateNotSupported - 인스턴스 표준 시간대 업데이트가 지원되지 않습니다. 400 CreateManagedInstanceWithNonDefaultTimezoneNotSupported - 기본 표준 시간대가 아닌 Managed Instance를 만들 수 없습니다. 400 ManagedInstanceIpAddressRangeLimit - 작업을 수행하기 위해 서브넷에 사용 가능한 IP 주소가 충분하지 않으므로 관리되는 인스턴스의 만들기/크기 조정을 수행할 수 없습니다. 400 VnetDelegationNotAllowed - 사용자가 위임된 서브넷에 Managed Server를 삽입하려고 했습니다. 400 SubnetHasResourcesOfDifferentType - 사용자가 다른 유형의 리소스가 있는 서브넷에서 MI를 만들려고 했습니다. 400 UpdateManagedServerWithMaintenanceWindowNotAllowed - 유지 관리 기간 설정을 사용하여 Managed Instance의 업데이트는 허용되지 않습니다. 400 VnetPrepareNIPFailed - 사용자가 NetworkIntentPolicy와 충돌하는 서브넷을 준비하려고 했습니다. 400 ManagedInstanceDeprecatedHardwareFamily - 하드웨어 생성을 사용되지 않는 {0} 생성으로 변경할 수 없습니다. 400 ManagedInstanceBackupStorageTypeNotSupported - 백업 스토리지 유형 매개 변수는 인스턴스 업데이트 작업에서 허용되지 않습니다. 400 EmptyPDCInvalidDnsZone - DNS 영역이 서브넷 {0}의도한 가상 클러스터의 DNS 접두사와 일치하지 않으므로 이 관리되는 인스턴스를 배포할 수 없습니다. 이 가상 클러스터는 비어 있지만 DNS 접두사는 변경할 수 없습니다. 빈 가상 클러스터는 몇 시간 후에 자동으로 제거됩니다. 이 가상 클러스터가 만료되거나 수동으로 이 가상 클러스터를 삭제한 다음 관리되는 인스턴스를 만들 때까지 기다리는 것이 좋습니다. 400 MissingIdentityId - ID 유형이 UserAssigned로 설정된 경우 사용자 할당 ID가 제공되지 않습니다. 400 InvalidPrimaryIdentityId - 사용자가 PrimaryUserIdentityId에 대한 값을 제공하지만 IdentityId 매개 변수에 동일한 값이 나열되지 않습니다. 400 ManagedInstanceZoneRedudantFeatureNotSupported - ZoneRedundant 기능은 선택한 서비스 계층에 대해 지원되지 않습니다. 자세한 내용은 aka.ms/sqlmi-service-tier-characteristics 방문하세요. 400 ManagedInstanceZoneRedudantFeatureCantBeEnabled - 관리되는 인스턴스를 만든 후에는 zoneRedundant 기능을 사용할 수 없습니다. 자세한 내용은 aka.ms/sqlmi-high-availability 방문하세요. 400 ManagedInstanceZoneRedudantFeatureCantBeDisabled - 관리되는 인스턴스를 만든 후에는 zoneRedundant 기능을 사용하지 않도록 설정하는 것이 불가능합니다. 자세한 내용은 aka.ms/sqlmi-high-availability 방문하세요. 400 UmiMissingAkvPermissions - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음 400 MissingPrimaryIdentity - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음 400 SubnetIdCantBeUpdated - 관리되는 인스턴스 서브넷 변경 작업은 지원되지 않습니다. 요청에서 이 매개 변수를 제거하세요. 400 MigrationToAnotherVNetNotSupported - 선택한 서브넷이 다른 Virtual Network에 있습니다. 관리형 인스턴스를 다른 Virtual Network로 이동할 수 없습니다. Virtual Network {0}서브넷을 제공하세요. 400 MigrationToSubnetWithDifferentDnsZoneNotSupported - 제공된 서브넷에 현재와 다른 DNS 영역이 있습니다. 인스턴스 DNS 영역 변경은 지원되지 않습니다. 동일한 DNS 영역이 있는 서브넷을 제공하거나, 새 서브넷을 만들거나, 빈 서브넷을 제공하세요. 400 MigrationToGen4SubnetNotSupported - 사용되지 않으므로 Gen4 하드웨어에서 실행하는 동안 서브넷을 업데이트할 수 없습니다. 대상 서브넷 및 하드웨어 생성이라는 두 매개 변수를 동시에 지정하여 변경되는 관리되는 인스턴스 서브넷 작업의 일부로 하드웨어를 Gen4에서 Gen5로 업그레이드하세요. 400 PrimaryIdentityMissingPermissionForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 PrimaryUserAssignedIdentityId는 API 호출에 제공되지 않습니다. 400 InvalidIdentityTypeForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 ID 유형이 'UserAssigned'로 설정되지 않았습니다. 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다. 400 ManagedInstanceFileExceededMaxAzureStorageFileSizeLimit - 일부 데이터베이스 파일이 최대 범용 파일 크기 제한인 {0} GB를 초과하여 작업을 완료할 수 없습니다. 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 InstancePoolNotEnoughCapacity - 인스턴스 풀에 충분한 용량이 없습니다. 400 SourceAndTargetSubnetsMustBeVnetPeered - 현재 관리되는 인스턴스에서 사용되며 제공된 대상 서브넷은 가상 네트워크 피어링과 연결되지 않았거나 피어링을 설정했지만 트래픽이 허용되지 않는 가상 네트워크의 일부입니다. 관리되는 인스턴스를 한 서브넷에서 다른 서브넷으로 이동하려면 원본 및 대상 가상 네트워크 모두에서 가상 네트워크 피어링을 설정해야 합니다. 가상 네트워크 요구 사항을 구성한 다음 작업을 다시 시도하세요. https://docs.microsoft.com/en-us/azure/virtual-network/tutorial-connect-virtual-networks-portal#peer-virtual-networks자세히 알아보세요. 400 ManagedInstanceAndSubnetAreNotOnTheSameSubscription - 관리되는 인스턴스 배포를 위해 제공되는 서브넷은 관리되는 인스턴스에 대해 제출된 구독과 다른 구독에 있습니다. 인스턴스를 배포하는 데 사용되는 관리되는 인스턴스 및 서브넷은 동일한 구독에 있어야 합니다. 다른 서브넷을 제공하거나 서브넷 구독으로 전환한 다음 작업을 다시 시도하세요. 400 CreateManagedInstanceInvalidSubnetSize - 사용자가 허용되는 최소 서브넷 크기보다 작은 서브넷에서 관리되는 인스턴스를 만들려고 했습니다. 400 AddressRangeOfTargetSubnetAndSubnetOfGeoDRReplicaCantOverlap - 관리되는 인스턴스 마이그레이션을 위해 선택한 서브넷에는 지역에서 복제된 보조 인스턴스를 보유하는 서브넷의 주소 범위와 겹치는 주소 범위가 있습니다. 서브넷이 https://aka.ms/move-managed-instance지침에 따라 구성되었는지 확인하세요. 400 TargetSubnetMustBeConfiguredToAllowGeoDRReplication - 관리되는 인스턴스 마이그레이션을 위해 선택한 서브넷이 지역에서 복제된 보조 인스턴스와의 통신을 사용하도록 구성되지 않았습니다. 필요한 모든 포트가 열려 있는지 확인하세요. 서브넷을 올바르게 구성하려면 https://aka.ms/move-managed-instance지침을 읽어 줍니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 InvalidLoginName - 제공된 로그인 이름이 잘못되었습니다. 400 InvalidUsername - 제공된 사용자 이름에 잘못된 문자가 포함되어 있습니다. 400 PasswordTooShort - 제공된 암호가 너무 짧습니다. 400 PasswordTooLong - 제공된 암호가 너무 깁니다. 400 PasswordNotComplex - 제공된 암호가 충분히 복잡하지 않습니다. 400 GatewayInvalidEdition - '{0}'은 이 버전의 SQL Server에서 유효한 데이터베이스 버전이 아닙니다. 400 InvalidLocation - 잘못된 위치가 지정되었습니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 InvalidManagedServerDnsZonePartner - 만들기 요청에 지정된 지역 주 관리형 인스턴스의 리소스 URI가 잘못되었습니다. 속성이 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/managedInstances/{managedInstanceName} 형식인지 확인하세요. 400 MiGeoRestoreWithWrongBackupStorageRedundancy - LRS/ZRS 백업 스토리지 중복성이 있는 관리되는 인스턴스에는 Geo-Restore 허용되지 않습니다. 400 UpdatingInstanceAndBackupRedundancy - 인스턴스 영역 중복성 및 백업 스토리지 중복성은 동일한 요청에서 업데이트할 수 없습니다. 400 ProvisioningDisabled - 리소스 작업 권한 부여자의 오류 메시지를 변경 없이 있는 그대로 표시합니다. 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory 전용 인증이 사용됩니다. 시스템 관리자에게 문의하세요. 400 ManagementServiceFeatureDisabled - 사용자가 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 MismatchingResourceGroupNameWithUrl - 제공된 리소스 그룹 이름이 URL의 이름과 일치하지 않습니다. 400 MismatchingSubscriptionWithUrl - 제공된 구독이 URL의 구독과 일치하지 않습니다. 400 InvalidMinimalTlsVersion - 최소 TLS 버전이 잘못되었습니다. 400 InvalidResourceId - 잘못된 리소스 식별자입니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 InvalidMaintenanceWindowSettings - 잘못된 유지 관리 기간 설정입니다. 400 InvalidMaintenanceWindowProperty - 잘못된 유지 관리 기간 속성이 지정되었습니다. 400 InvalidMaintenanceWindowPropertyNull - 필수 속성이 null인 잘못된 유지 관리 기간입니다. 400 InvalidMaintenanceWindowTypeWithPropertySpecified - 유지 관리 기간 유형에 지정된 특정 속성이 없어야 합니다. 400 UpdateOfParameterNotSupported - '{0}' 업데이트는 지원되지 않습니다. 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory 전용 인증이 사용됩니다. 시스템 관리자에게 문의하세요. 400 InvalidExternalAdministratorLogin - 잘못되었거나 외부 관리자 로그인 이름이 없습니다. 400 InvalidExternalAdministratorSid - 외부 관리자 개체 ID가 잘못되었거나 누락되었습니다. 400 InvalidExternalAdministratorTenantId - 외부 관리자 테넌트 ID가 잘못되었거나 누락되었습니다. 400 ExternalAdministratorPrincipalType - 잘못되었거나 누락된 외부 관리자 보안 주체 유형입니다. 사용자, 애플리케이션 또는 그룹에서 선택하세요. 400 MissingExternalAdministratorWithAadOnlyAuth - Azure AD 전용 인증을 사용하려면 외부 관리자의 세부 정보를 제공하세요. 400 ExternalAdministratorLoginSameAsSqlAdmin - Azure Active Directory 관리자 및 서버 관리자 계정의 이름은 달라야 합니다. 다른 값을 제공하세요. 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다. 404 ManagedInstanceNotInSubscriptionResourceGroup - 지정된 관리되는 인스턴스가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 404 ResourceDoesNotExist - 이름이 '{0}'인 리소스가 없습니다. 계속하려면 유효한 리소스 이름을 지정합니다. 404 InstancePoolNotFound - 인스턴스 풀을 찾을 수 없음 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 405 InvalidVcoreValue - {0} vCore 값이 잘못되었습니다. 유효한 vCore 값을 지정하세요. 405 InvalidHardwareGenerationValue - 하드웨어 세대 {0} 잘못되었습니다. 유효한 HardwareGeneration 값을 지정하세요. 405 InvalidStorageSizeValue - "잘못된 스토리지 크기: {0} GB. 스토리지 크기는 {1}~{2} 기가바이트({3} GB) 단위로 지정해야 합니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 409 ConflictingServerOperation - 서버에 대한 작업이 현재 진행 중입니다. 409 SubscriptionDisabled - 구독을 사용할 수 없습니다. 409 ServerOverridePreconditionFailed - '{0}' 범주에 서버 재정의를 적용하지 못했습니다. 서버 '{1}'의 실제 db 또는 인스턴스 '{2}'이 현재 '준비됨' 또는 '비활성화됨' 상태가 아니기 때문입니다. 409 ManagedInstanceIsBusy - 서버 '{0}'이(가) 현재 사용 중입니다. 다시 시도하기 전에 몇 분 정도 기다려 주세요. 409 ServerAlreadyExists - 중복 서버 이름입니다. 409 ServerDisabled - 서버를 사용할 수 없습니다. 409 ServerQuotaExceeded - 할당량을 초과하므로 서버를 구독에 추가할 수 없습니다. 409 ConflictingManagedInstanceOperation - 관리되는 인스턴스에 대한 작업이 현재 진행 중입니다. 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - 인스턴스는 다중 az이지만 백업 스토리지는 영역 중복에서 비 영역 중복으로 업데이트되고 있습니다. 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - 백업 스토리지 중복 업데이트가 진행 중이므로 인스턴스 중복을 업데이트할 수 없습니다. 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - 백업 스토리지는 영역이 아닌 중복이지만 인스턴스 중복성이 영역 중복으로 업데이트되고 있습니다. 409 BackupRedundancyUpdateConflict - 백업 스토리지 중복 업데이트가 이미 진행 중이므로 백업 스토리지 중복성을 업데이트할 수 없습니다. 409 MiDropFailedOnAuthLocks - 사용자가 리소스에 잠금이 적용된 서브넷에서 마지막 Managed Instance를 삭제하려고 했습니다. 409 MiCreateFailedNonDelegatedSubnet - 사용자가 Microsoft.Sql/managedInstances에 위임되지 않은 서브넷에 Managed Instance 또는 Managed Instance 풀을 배포하려고 했습니다. 412 InstanceNotReadyForBackupRedundancyUpdate - 인스턴스가 준비되지 않았기 때문에 백업 스토리지 중복성을 업데이트할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 500 GatewayInternalServerError - 서버에서 예기치 않은 예외가 발생했습니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다. 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다. 504 RequestTimeout - 서비스 요청이 허용된 시간 제한을 초과했습니다.

예제

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "Japan East",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "type": "SystemAssigned"
    }
  }
}

Java

import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceInner;
import com.azure.resourcemanager.sql.models.BackupStorageRedundancy;
import com.azure.resourcemanager.sql.models.ManagedInstanceExternalAdministrator;
import com.azure.resourcemanager.sql.models.ManagedInstanceLicenseType;
import com.azure.resourcemanager.sql.models.ManagedInstanceProxyOverride;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServicePrincipal;
import com.azure.resourcemanager.sql.models.ServicePrincipalType;
import com.azure.resourcemanager.sql.models.Sku;
import java.util.HashMap;
import java.util.Map;
import java.util.UUID;

/**
 * Samples for ManagedInstances CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceCreateMax.json
     */
    /**
     * Sample code: Create managed instance with all properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createManagedInstanceWithAllProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().createOrUpdate("testrg", "testinstance",
            new ManagedInstanceInner().withLocation("Japan East").withTags(mapOf("tagKey1", "fakeTokenPlaceholder"))
                .withSku(new Sku().withName("GP_Gen5").withTier("GeneralPurpose")).withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withSubnetId(
                    "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1")
                .withLicenseType(ManagedInstanceLicenseType.LICENSE_INCLUDED).withVCores(8).withStorageSizeInGB(1024)
                .withCollation("SQL_Latin1_General_CP1_CI_AS")
                .withDnsZonePartner(
                    "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance")
                .withPublicDataEndpointEnabled(false).withProxyOverride(ManagedInstanceProxyOverride.REDIRECT)
                .withTimezoneId("UTC")
                .withInstancePoolId(
                    "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1")
                .withMaintenanceConfigurationId(
                    "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1")
                .withMinimalTlsVersion("1.2").withRequestedBackupStorageRedundancy(BackupStorageRedundancy.GEO)
                .withAdministrators(new ManagedInstanceExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withServicePrincipal(new ServicePrincipal().withType(ServicePrincipalType.SYSTEM_ASSIGNED)),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:

200

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

상태 코드:

201

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "timezoneId": "UTC",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

상태 코드:

202

Create managed instance with minimal properties

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose"
  },
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded"
  },
  "location": "Japan East"
}

Java

import com.azure.resourcemanager.sql.fluent.models.ManagedInstanceInner;
import com.azure.resourcemanager.sql.models.ManagedInstanceLicenseType;
import com.azure.resourcemanager.sql.models.Sku;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedInstances CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceCreateMin.json
     */
    /**
     * Sample code: Create managed instance with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createManagedInstanceWithMinimalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().createOrUpdate("testrg", "testinstance",
            new ManagedInstanceInner().withLocation("Japan East")
                .withSku(new Sku().withName("GP_Gen4").withTier("GeneralPurpose")).withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withSubnetId(
                    "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1")
                .withLicenseType(ManagedInstanceLicenseType.LICENSE_INCLUDED).withVCores(8).withStorageSizeInGB(1024),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:

200

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "dnsZone": "1b4e2caff2530",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

상태 코드:

201

{
  "sku": {
    "name": "GP_Gen4",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "provisioningState": "Creating",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "dnsZone": "1b4e2caff2530",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo"
  },
  "location": "japaneast",
  "tags": {},
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

상태 코드:

202

정의

Name	Description
AdministratorType	심각도 관리자의 유형입니다.
BackupStorageRedundancy	이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
IdentityType	ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
ManagedInstance	Azure SQL 관리형 인스턴스입니다.
ManagedInstanceExternalAdministrator	Active Directory 관리자의 속성입니다.
ManagedInstanceLicenseType	라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.
ManagedInstancePecProperty	관리되는 인스턴스 아래의 프라이빗 엔드포인트 연결
ManagedInstancePrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결의 속성입니다.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	인스턴스에 연결하는 데 사용되는 연결 유형입니다.
ManagedServerCreateMode	데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.
PrincipalType	서버 관리자의 보안 주체 유형입니다.
ResourceIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.
ServicePrincipal	리소스에 대한 관리되는 인스턴스의 서비스 주체 구성입니다.
ServicePrincipalType	서비스 주체 유형입니다.
Sku	ARM 리소스 SKU입니다.
UserIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.

AdministratorType

열거형

심각도 관리자의 유형입니다.

값	Description
ActiveDirectory

BackupStorageRedundancy

열거형

이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.

값	Description
Geo
GeoZone
Local
Zone

IdentityType

열거형

ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.

값	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Object

Azure SQL 관리형 인스턴스입니다.

Name	형식	Description
id	string	리소스 ID입니다.
identity	ResourceIdentity	관리되는 인스턴스의 Azure Active Directory ID입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.administratorLogin	string	관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요).
properties.administratorLoginPassword	string	관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요).
properties.administrators	ManagedInstanceExternalAdministrator	서버의 Azure Active Directory 관리자입니다.
properties.collation	string	관리되는 인스턴스의 데이터 정렬입니다.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
properties.dnsZone	string	관리되는 인스턴스가 있는 Dns 영역입니다.
properties.dnsZonePartner	string (arm-id)	이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다.
properties.fullyQualifiedDomainName	string	관리되는 인스턴스의 정규화된 도메인 이름입니다.
properties.instancePoolId	string	이 관리되는 서버가 속한 인스턴스 풀의 ID입니다.
properties.keyId	string	암호화에 사용할 키의 CMK URI입니다.
properties.licenseType	ManagedInstanceLicenseType	라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.
properties.maintenanceConfigurationId	string	이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다.
properties.managedInstanceCreateMode	ManagedServerCreateMode	데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.
properties.minimalTlsVersion	string	최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string (arm-id)	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	관리되는 인스턴스의 프라이빗 엔드포인트 연결 목록입니다.
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	인스턴스에 연결하는 데 사용되는 연결 유형입니다.
properties.publicDataEndpointEnabled	boolean	공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
properties.restorePointInTime	string (date-time)	새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다.
properties.servicePrincipal	ServicePrincipal	관리되는 인스턴스의 서비스 주체입니다.
properties.sourceManagedInstanceId	string (arm-id)	이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다.
properties.state	string	관리되는 인스턴스의 상태입니다.
properties.storageSizeInGB	integer (int32)	스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다.
properties.subnetId	string (arm-id)	관리되는 인스턴스에 대한 서브넷 리소스 ID입니다.
properties.timezoneId	string	표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\표준 시간대 아래의 레지스트리에 ID를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 유지합니다. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server를 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "Pacific Standard Time" 또는 "W입니다. 유럽 표준시".
properties.vCores	integer (int32)	vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80.
properties.zoneRedundant	boolean	다중 az를 사용할 수 있는지 여부입니다.
sku	Sku	관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	리소스 태그.
type	string	리소스 종류입니다.

ManagedInstanceExternalAdministrator

Object

Active Directory 관리자의 속성입니다.

Name	형식	Description
administratorType	AdministratorType	심각도 관리자의 유형입니다.
azureADOnlyAuthentication	boolean	Azure Active Directory만 인증을 사용하도록 설정했습니다.
login	string	서버 관리자의 로그인 이름입니다.
principalType	PrincipalType	서버 관리자의 보안 주체 유형입니다.
sid	string (uuid)	서버 관리자의 SID(개체 ID)입니다.
tenantId	string (uuid)	관리자의 테넌트 ID입니다.

ManagedInstanceLicenseType

열거형

라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.

값	Description
BasePrice
LicenseIncluded

ManagedInstancePecProperty

Object

관리되는 인스턴스 아래의 프라이빗 엔드포인트 연결

Name	형식	Description
id	string	리소스 ID입니다.
properties	ManagedInstancePrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결 속성

ManagedInstancePrivateEndpointConnectionProperties

Object

프라이빗 엔드포인트 연결의 속성입니다.

Name	형식	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.
provisioningState	string	프라이빗 엔드포인트 연결의 상태입니다.

ManagedInstancePrivateEndpointProperty

Object

Name	형식	Description
id	string	프라이빗 엔드포인트의 리소스 ID입니다.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

Name	형식	Description
actionsRequired	string	프라이빗 링크 서비스 연결 설명입니다.
description	string	프라이빗 링크 서비스 연결 설명입니다.
status	string	프라이빗 링크 서비스 연결 상태입니다.

ManagedInstanceProxyOverride

열거형

인스턴스에 연결하는 데 사용되는 연결 유형입니다.

값	Description
Default
Proxy
Redirect

ManagedServerCreateMode

열거형

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

기본값: 일반 인스턴스 만들기.

복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.

값	Description
Default
PointInTimeRestore

PrincipalType

열거형

서버 관리자의 보안 주체 유형입니다.

값	Description
Application
Group
User

ResourceIdentity

Object

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

Name	형식	Description
principalId	string (uuid)	Azure Active Directory 보안 주체 ID입니다.
tenantId	string (uuid)	Azure Active Directory 테넌트 ID입니다.
type	IdentityType	ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
userAssignedIdentities	<string,  UserIdentity>	사용할 사용자 할당 ID의 리소스 ID

ServicePrincipal

Object

리소스에 대한 관리되는 인스턴스의 서비스 주체 구성입니다.

Name	형식	Description
clientId	string	Azure Active Directory 애플리케이션 클라이언트 ID입니다.
principalId	string	Azure Active Directory 애플리케이션 개체 ID입니다.
tenantId	string	Azure Active Directory 테넌트 ID입니다.
type	ServicePrincipalType	서비스 주체 유형입니다.

ServicePrincipalType

열거형

서비스 주체 유형입니다.

값	Description
None
SystemAssigned

Sku

Object

ARM 리소스 SKU입니다.

Name	형식	Description
capacity	integer (int32)	특정 SKU의 용량입니다.
family	string	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.
name	string	SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다.
size	string	특정 SKU의 크기
tier	string	특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.

UserIdentity

Object

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

Name	형식	Description
clientId	string (uuid)	Azure Active Directory 클라이언트 ID입니다.
principalId	string (uuid)	Azure Active Directory 보안 주체 ID입니다.