Microsoft.Sql managedInstances
- 최신
- 2024-05-01-preview
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Bicep 리소스 정의
managedInstances 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/managedInstances 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Sql/managedInstances@2024-05-01-preview' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'string'
azureADOnlyAuthentication: bool
login: 'string'
principalType: 'string'
sid: 'string'
tenantId: 'string'
}
authenticationMetadata: 'string'
collation: 'string'
databaseFormat: 'string'
dnsZonePartner: 'string'
hybridSecondaryUsage: 'string'
instancePoolId: 'string'
isGeneralPurposeV2: bool
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
totalMemoryMB: int
vCores: int
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
ManagedInstanceExternalAdministrator
이름 | 묘사 | 값 |
---|---|---|
administratorType | 심각도 관리자의 유형입니다. | 'ActiveDirectory' |
azureADOnlyAuthentication | Azure Active Directory만 인증을 사용하도록 설정했습니다. | bool |
로그인 | 서버 관리자의 로그인 이름입니다. | 문자열 |
principalType | 서버 관리자의 보안 주체 유형입니다. | '애플리케이션' 'Group' 'User' |
sid | 서버 관리자의 SID(개체 ID)입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
tenantId | 관리자의 테넌트 ID입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
이름 | 묘사 | 값 |
---|---|---|
administratorLogin | 관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). | 문자열 |
administratorLoginPassword | 관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). | 문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
관리자 | 인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. | ManagedInstanceExternalAdministrator |
authenticationMetadata | 관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. | 'AzureAD' '페어링됨' 'Windows' |
조교 | 관리되는 인스턴스의 데이터 정렬입니다. | 문자열 |
databaseFormat | SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. | 'AlwaysUpToDate' 'SQLServer2022' |
dnsZonePartner | 이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. | 문자열 |
hybridSecondaryUsage | 하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). | '활성' '수동' |
instancePoolId | 이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. | 문자열 |
isGeneralPurposeV2 | 범용 버전의 GPv2 변형인지 여부입니다. | bool |
keyId | 암호화에 사용할 키의 CMK URI입니다. | 문자열 |
licenseType | 라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. | 'BasePrice' 'LicenseIncluded' |
maintenanceConfigurationId | 이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. | 문자열 |
managedInstanceCreateMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
'기본값' 'PointInTimeRestore' |
minimalTlsVersion | 최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' | 문자열 |
pricingModel | Managed Instance의 가격 책정 모델입니다. | '프리미움' 'Regular' |
primaryUserAssignedIdentityId | 기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. | 문자열 |
proxyOverride | 인스턴스에 연결하는 데 사용되는 연결 유형입니다. | '기본값' 'Proxy' '리디렉션' |
publicDataEndpointEnabled | 공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. | bool |
requestedBackupStorageRedundancy | 이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
servicePrincipal | 관리되는 인스턴스의 서비스 주체입니다. | ServicePrincipal |
sourceManagedInstanceId | 이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. | 문자열 |
storageIOps | 스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageSizeInGB | 스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageThroughputMBps | 스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. | int |
subnetId | 관리되는 인스턴스에 대한 서브넷 리소스 ID입니다. | 문자열 |
timezoneId | 표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 아래의 레지스트리에서 ID를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 유지합니다. KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\표준 시간대. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server를 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "Pacific Standard Time" 또는 "W입니다. 유럽 표준시". |
문자열 |
totalMemoryMB | 총 메모리(MB)입니다. 최소값: 7168. 최대값: 891328. 1MB 단위로만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
vCore | vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | 다중 az를 사용할 수 있는지 여부입니다. | bool |
Microsoft.Sql/managedInstances
이름 | 묘사 | 값 |
---|---|---|
신원 | 관리되는 인스턴스의 Azure Active Directory ID입니다. | ResourceIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
속성 | 리소스 속성입니다. | managedInstanceProperties |
sku | 관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
ResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | resourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
ServicePrincipal
이름 | 묘사 | 값 |
---|---|---|
형 | 서비스 주체 유형입니다. | 'None' 'SystemAssigned' |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|
UserIdentity
이름 | 묘사 | 값 |
---|
빠른 시작 샘플
다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.
Bicep 파일 | 묘사 |
---|---|
새 가상 네트워크 내에 SQL MI 만들기 | 새 Virtual Network 내에 Azure SQL MI(Sql Database Managed Instance)를 배포합니다. |
ARM 템플릿 리소스 정의
managedInstances 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/managedInstances 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2024-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "string",
"azureADOnlyAuthentication": "bool",
"login": "string",
"principalType": "string",
"sid": "string",
"tenantId": "string"
},
"authenticationMetadata": "string",
"collation": "string",
"databaseFormat": "string",
"dnsZonePartner": "string",
"hybridSecondaryUsage": "string",
"instancePoolId": "string",
"isGeneralPurposeV2": "bool",
"keyId": "string",
"licenseType": "string",
"maintenanceConfigurationId": "string",
"managedInstanceCreateMode": "string",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"totalMemoryMB": "int",
"vCores": "int",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
ManagedInstanceExternalAdministrator
이름 | 묘사 | 값 |
---|---|---|
administratorType | 심각도 관리자의 유형입니다. | 'ActiveDirectory' |
azureADOnlyAuthentication | Azure Active Directory만 인증을 사용하도록 설정했습니다. | bool |
로그인 | 서버 관리자의 로그인 이름입니다. | 문자열 |
principalType | 서버 관리자의 보안 주체 유형입니다. | '애플리케이션' 'Group' 'User' |
sid | 서버 관리자의 SID(개체 ID)입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
tenantId | 관리자의 테넌트 ID입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
이름 | 묘사 | 값 |
---|---|---|
administratorLogin | 관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). | 문자열 |
administratorLoginPassword | 관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). | 문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
관리자 | 인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. | ManagedInstanceExternalAdministrator |
authenticationMetadata | 관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. | 'AzureAD' '페어링됨' 'Windows' |
조교 | 관리되는 인스턴스의 데이터 정렬입니다. | 문자열 |
databaseFormat | SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. | 'AlwaysUpToDate' 'SQLServer2022' |
dnsZonePartner | 이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. | 문자열 |
hybridSecondaryUsage | 하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). | '활성' '수동' |
instancePoolId | 이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. | 문자열 |
isGeneralPurposeV2 | 범용 버전의 GPv2 변형인지 여부입니다. | bool |
keyId | 암호화에 사용할 키의 CMK URI입니다. | 문자열 |
licenseType | 라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. | 'BasePrice' 'LicenseIncluded' |
maintenanceConfigurationId | 이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. | 문자열 |
managedInstanceCreateMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
'기본값' 'PointInTimeRestore' |
minimalTlsVersion | 최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' | 문자열 |
pricingModel | Managed Instance의 가격 책정 모델입니다. | '프리미움' 'Regular' |
primaryUserAssignedIdentityId | 기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. | 문자열 |
proxyOverride | 인스턴스에 연결하는 데 사용되는 연결 유형입니다. | '기본값' 'Proxy' '리디렉션' |
publicDataEndpointEnabled | 공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. | bool |
requestedBackupStorageRedundancy | 이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
servicePrincipal | 관리되는 인스턴스의 서비스 주체입니다. | ServicePrincipal |
sourceManagedInstanceId | 이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. | 문자열 |
storageIOps | 스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageSizeInGB | 스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageThroughputMBps | 스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. | int |
subnetId | 관리되는 인스턴스에 대한 서브넷 리소스 ID입니다. | 문자열 |
timezoneId | 표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 아래의 레지스트리에서 ID를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 유지합니다. KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\표준 시간대. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server를 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "Pacific Standard Time" 또는 "W입니다. 유럽 표준시". |
문자열 |
totalMemoryMB | 총 메모리(MB)입니다. 최소값: 7168. 최대값: 891328. 1MB 단위로만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
vCore | vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | 다중 az를 사용할 수 있는지 여부입니다. | bool |
Microsoft.Sql/managedInstances
이름 | 묘사 | 값 |
---|---|---|
apiVersion | api 버전 | '2024-05-01-preview' |
신원 | 관리되는 인스턴스의 Azure Active Directory ID입니다. | ResourceIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
속성 | 리소스 속성입니다. | managedInstanceProperties |
sku | 관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
형 | 리소스 종류 | 'Microsoft.Sql/managedInstances' |
ResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | resourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
ServicePrincipal
이름 | 묘사 | 값 |
---|---|---|
형 | 서비스 주체 유형입니다. | 'None' 'SystemAssigned' |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|
UserIdentity
이름 | 묘사 | 값 |
---|
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플렛 | 묘사 |
---|---|
새 가상 네트워크 내에 SQL MI 만들기 Azure 배포 |
새 Virtual Network 내에 Azure SQL MI(Sql Database Managed Instance)를 배포합니다. |
로그 및 메트릭 구성된 전송을 사용하여 SQL MI 만들기 Azure 배포 |
이 템플릿을 사용하면 로그 및 메트릭(진단 작업 영역, 스토리지 계정, 이벤트 허브)을 저장하는 데 사용되는 SQL MI 및 추가 리소스를 배포할 수 있습니다. |
새 가상 네트워크 내에서 jumpbox를 사용하여 SQL MI 만들기 Azure 배포 |
새 Virtual Network 내에 SSMS를 사용하여 Azure SQL MI(Sql Database Managed Instance) 및 JumpBox를 배포합니다. |
지점 및 사이트 연결이 구성된 SQL MI 만들기 Azure 배포 |
새 가상 네트워크 내에서 지점 및 사이트 간의 연결을 위해 구성된 Azure SQL MI(Sql Database Managed Instance) 및 가상 네트워크 게이트웨이를 배포합니다. |
네트워킹 사용하여 SQL Managed Instance 배포 Azure |
UDR 및 NSG를 배포하여 Azure SQL Managed Instance를 지원하고 Managed Instance 배포 |
Terraform(AzAPI 공급자) 리소스 정의
managedInstances 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/managedInstances 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2024-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "string"
azureADOnlyAuthentication = bool
login = "string"
principalType = "string"
sid = "string"
tenantId = "string"
}
authenticationMetadata = "string"
collation = "string"
databaseFormat = "string"
dnsZonePartner = "string"
hybridSecondaryUsage = "string"
instancePoolId = "string"
isGeneralPurposeV2 = bool
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageIOps = int
storageSizeInGB = int
storageThroughputMBps = int
subnetId = "string"
timezoneId = "string"
totalMemoryMB = int
vCores = int
zoneRedundant = bool
}
})
}
속성 값
ManagedInstanceExternalAdministrator
이름 | 묘사 | 값 |
---|---|---|
administratorType | 심각도 관리자의 유형입니다. | 'ActiveDirectory' |
azureADOnlyAuthentication | Azure Active Directory만 인증을 사용하도록 설정했습니다. | bool |
로그인 | 서버 관리자의 로그인 이름입니다. | 문자열 |
principalType | 서버 관리자의 보안 주체 유형입니다. | '애플리케이션' 'Group' 'User' |
sid | 서버 관리자의 SID(개체 ID)입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
tenantId | 관리자의 테넌트 ID입니다. | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
이름 | 묘사 | 값 |
---|---|---|
administratorLogin | 관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). | 문자열 |
administratorLoginPassword | 관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). | 문자열 제약 조건: 중요한 값입니다. 보안 매개 변수로 전달합니다. |
관리자 | 인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. | ManagedInstanceExternalAdministrator |
authenticationMetadata | 관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. | 'AzureAD' '페어링됨' 'Windows' |
조교 | 관리되는 인스턴스의 데이터 정렬입니다. | 문자열 |
databaseFormat | SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. | 'AlwaysUpToDate' 'SQLServer2022' |
dnsZonePartner | 이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. | 문자열 |
hybridSecondaryUsage | 하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). | '활성' '수동' |
instancePoolId | 이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. | 문자열 |
isGeneralPurposeV2 | 범용 버전의 GPv2 변형인지 여부입니다. | bool |
keyId | 암호화에 사용할 키의 CMK URI입니다. | 문자열 |
licenseType | 라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. | 'BasePrice' 'LicenseIncluded' |
maintenanceConfigurationId | 이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. | 문자열 |
managedInstanceCreateMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
'기본값' 'PointInTimeRestore' |
minimalTlsVersion | 최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' | 문자열 |
pricingModel | Managed Instance의 가격 책정 모델입니다. | '프리미움' 'Regular' |
primaryUserAssignedIdentityId | 기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. | 문자열 |
proxyOverride | 인스턴스에 연결하는 데 사용되는 연결 유형입니다. | '기본값' 'Proxy' '리디렉션' |
publicDataEndpointEnabled | 공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. | bool |
requestedBackupStorageRedundancy | 이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
servicePrincipal | 관리되는 인스턴스의 서비스 주체입니다. | ServicePrincipal |
sourceManagedInstanceId | 이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. | 문자열 |
storageIOps | 스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageSizeInGB | 스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
storageThroughputMBps | 스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. | int |
subnetId | 관리되는 인스턴스에 대한 서브넷 리소스 ID입니다. | 문자열 |
timezoneId | 표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 아래의 레지스트리에서 ID를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 유지합니다. KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\표준 시간대. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server를 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "Pacific Standard Time" 또는 "W입니다. 유럽 표준시". |
문자열 |
totalMemoryMB | 총 메모리(MB)입니다. 최소값: 7168. 최대값: 891328. 1MB 단위로만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. | int |
vCore | vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80. | int |
zoneRedundant | 다중 az를 사용할 수 있는지 여부입니다. | bool |
Microsoft.Sql/managedInstances
이름 | 묘사 | 값 |
---|---|---|
신원 | 관리되는 인스턴스의 Azure Active Directory ID입니다. | ResourceIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
속성 | 리소스 속성입니다. | managedInstanceProperties |
sku | 관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH | Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
형 | 리소스 종류 | "Microsoft.Sql/managedInstances@2024-05-01-preview" |
ResourceIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | resourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
ServicePrincipal
이름 | 묘사 | 값 |
---|---|---|
형 | 서비스 주체 유형입니다. | 'None' 'SystemAssigned' |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|
UserIdentity
이름 | 묘사 | 값 |
---|