Managed Instances - Update
관리되는 인스턴스를 업데이트합니다.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2023-08-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
managed
|
path | True |
string |
관리되는 인스턴스의 이름입니다. |
resource
|
path | True |
string |
리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다. |
subscription
|
path | True |
string |
Azure 구독을 식별하는 구독 ID입니다. |
api-version
|
query | True |
string |
요청에 사용할 API 버전입니다. |
요청 본문
Name | 형식 | Description |
---|---|---|
identity |
관리되는 인스턴스 ID |
|
properties.administratorLogin |
string |
관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). |
properties.administratorLoginPassword |
string |
관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). |
properties.administrators |
인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. |
|
properties.authenticationMetadata |
관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. |
|
properties.collation |
string |
관리되는 인스턴스의 데이터 정렬입니다. |
properties.databaseFormat |
SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. |
|
properties.dnsZonePartner |
string (arm-id) |
이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. |
properties.hybridSecondaryUsage |
하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). |
|
properties.instancePoolId |
string |
이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. |
properties.isGeneralPurposeV2 |
boolean |
범용 버전의 GPv2 변형인지 여부입니다. |
properties.keyId |
string |
암호화에 사용할 키의 CMK URI입니다. |
properties.licenseType |
라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. |
|
properties.maintenanceConfigurationId |
string |
이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. |
properties.managedInstanceCreateMode |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
|
properties.minimalTlsVersion |
string |
최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' |
properties.pricingModel |
Managed Instance의 가격 책정 모델입니다. |
|
properties.primaryUserAssignedIdentityId |
string (arm-id) |
기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. |
properties.proxyOverride |
인스턴스에 연결하는 데 사용되는 연결 유형입니다. |
|
properties.publicDataEndpointEnabled |
boolean |
공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. |
properties.requestedBackupStorageRedundancy |
이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
|
properties.restorePointInTime |
string (date-time) |
새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.servicePrincipal |
관리되는 인스턴스의 서비스 주체입니다. |
|
properties.sourceManagedInstanceId |
string (arm-id) |
이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. |
properties.storageIOps |
integer (int32) |
스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageSizeInGB |
integer (int32) |
스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageThroughputMBps |
integer (int32) |
스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. |
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 |
|
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
관리되는 인스턴스를 업데이트했습니다. |
|
202 Accepted |
허용 헤더 Location: string |
|
Other Status Codes |
오류 응답: ***
|
예제
Remove maintenance policy from managed instance (select default maintenance policy) |
Update managed instance with all properties |
Update managed instance with minimal properties |
Remove maintenance policy from managed instance (select default maintenance policy)
샘플 요청
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01
{
"properties": {
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
}
}
샘플 응답
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/japaneast/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"dnsZone": "1b4e2caff2530",
"instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
"hybridSecondaryUsage": "Passive",
"externalGovernanceStatus": "Enabled",
"authenticationMetadata": "Windows",
"databaseFormat": "SQLServer2022"
},
"location": "japaneast",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
Update managed instance with all properties
샘플 요청
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01
{
"tags": {
"tagKey1": "TagValue1"
},
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8
},
"properties": {
"administratorLogin": "dummylogin",
"administratorLoginPassword": "PLACEHOLDER",
"proxyOverride": "Redirect",
"publicDataEndpointEnabled": false,
"minimalTlsVersion": "1.2",
"licenseType": "BasePrice",
"vCores": 8,
"storageSizeInGB": 448,
"collation": "SQL_Latin1_General_CP1_CI_AS",
"requestedBackupStorageRedundancy": "Geo",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"hybridSecondaryUsage": "Passive",
"authenticationMetadata": "Windows",
"databaseFormat": "AlwaysUpToDate"
}
}
샘플 응답
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
{
"tags": {
"tagKey1": "TagValue1"
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances",
"location": "japaneast",
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "dummylogin",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"vCores": 8,
"storageSizeInGB": 448,
"licenseType": "BasePrice",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Redirect",
"minimalTlsVersion": "1.2",
"dnsZone": "1b4e2caff2530",
"instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"authenticationMetadata": "Windows",
"databaseFormat": "AlwaysUpToDate"
}
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
Update managed instance with minimal properties
샘플 요청
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01
{
"tags": {
"tagKey1": "TagValue1"
}
}
샘플 응답
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
{
"sku": {
"name": "GP_Gen5",
"tier": "GeneralPurpose",
"capacity": 8,
"family": "Gen4"
},
"properties": {
"fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
"administratorLogin": "PLACEHOLDER",
"subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"state": "Ready",
"vCores": 8,
"storageSizeInGB": 1024,
"licenseType": "LicenseIncluded",
"collation": "SQL_Latin1_General_CP1_CI_AS",
"publicDataEndpointEnabled": false,
"proxyOverride": "Default",
"dnsZone": "1b4e2caff2530",
"instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
"maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
"currentBackupStorageRedundancy": "Geo",
"requestedBackupStorageRedundancy": "Geo",
"externalGovernanceStatus": "Enabled",
"hybridSecondaryUsage": "Passive",
"authenticationMetadata": "Windows",
"databaseFormat": "SQLServer2022"
},
"location": "japaneast",
"tags": {
"tagKey1": "TagValue1"
},
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
"name": "testinstance",
"type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111
정의
Name | Description |
---|---|
Administrator |
심각도 관리자의 유형입니다. |
Auth |
관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. |
Backup |
이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
External |
외부 거버넌스의 상태입니다. |
Hybrid |
하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). |
Hybrid |
하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다. |
Identity |
ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다. |
Managed |
Azure SQL 관리형 인스턴스입니다. |
Managed |
SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. |
Managed |
Active Directory 관리자의 속성입니다. |
Managed |
라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. |
Managed |
관리되는 인스턴스 아래의 프라이빗 엔드포인트 연결 |
Managed |
프라이빗 엔드포인트 연결의 속성입니다. |
Managed |
|
Managed |
|
Managed |
인스턴스에 연결하는 데 사용되는 연결 유형입니다. |
Managed |
Azure SQL Database 관리형 인스턴스에 대한 업데이트 요청입니다. |
Managed |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
Pricing |
Managed Instance의 가격 책정 모델입니다. |
Principal |
서버 관리자의 보안 주체 유형입니다. |
Provisioning |
관리되는 인스턴스의 프로비전 상태입니다. |
Resource |
리소스에 대한 Azure Active Directory ID 구성입니다. |
Service |
리소스에 대한 관리되는 인스턴스의 서비스 주체 구성입니다. |
Service |
서비스 주체 유형입니다. |
Sku |
ARM 리소스 SKU입니다. |
User |
리소스에 대한 Azure Active Directory ID 구성입니다. |
AdministratorType
심각도 관리자의 유형입니다.
값 | Description |
---|---|
ActiveDirectory |
AuthMetadataLookupModes
관리되는 인스턴스의 인증 메타데이터 조회 모드입니다.
값 | Description |
---|---|
AzureAD | |
Paired | |
Windows |
BackupStorageRedundancy
이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다.
값 | Description |
---|---|
Geo | |
GeoZone | |
Local | |
Zone |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
ExternalGovernanceStatus
외부 거버넌스의 상태입니다.
값 | Description |
---|---|
Disabled | |
Enabled |
HybridSecondaryUsage
하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용).
값 | Description |
---|---|
Active | |
Passive |
HybridSecondaryUsageDetected
하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다.
값 | Description |
---|---|
Active | |
Passive |
IdentityType
ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
값 | Description |
---|---|
None | |
SystemAssigned | |
SystemAssigned,UserAssigned | |
UserAssigned |
ManagedInstance
Azure SQL 관리형 인스턴스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
identity |
관리되는 인스턴스의 Azure Active Directory ID입니다. |
|
location |
string |
리소스 위치입니다. |
name |
string |
리소스 이름입니다. |
properties.administratorLogin |
string |
관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). |
properties.administratorLoginPassword |
string |
관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). |
properties.administrators |
인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. |
|
properties.authenticationMetadata |
관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. |
|
properties.collation |
string |
관리되는 인스턴스의 데이터 정렬입니다. |
properties.createTime |
string (date-time) |
Managed Instance 만들기의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.currentBackupStorageRedundancy |
이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
|
properties.databaseFormat |
SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. |
|
properties.dnsZone |
string |
관리되는 인스턴스가 있는 Dns 영역입니다. |
properties.dnsZonePartner |
string (arm-id) |
이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. |
properties.externalGovernanceStatus |
외부 거버넌스의 상태입니다. |
|
properties.fullyQualifiedDomainName |
string |
관리되는 인스턴스의 정규화된 도메인 이름입니다. |
properties.hybridSecondaryUsage |
하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). |
|
properties.hybridSecondaryUsageDetected |
하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다. |
|
properties.instancePoolId |
string |
이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. |
properties.isGeneralPurposeV2 |
boolean |
범용 버전의 GPv2 변형인지 여부입니다. |
properties.keyId |
string |
암호화에 사용할 키의 CMK URI입니다. |
properties.licenseType |
라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. |
|
properties.maintenanceConfigurationId |
string |
이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. |
properties.managedInstanceCreateMode |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
|
properties.minimalTlsVersion |
string |
최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' |
properties.pricingModel |
Managed Instance의 가격 책정 모델입니다. |
|
properties.primaryUserAssignedIdentityId |
string (arm-id) |
기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. |
properties.privateEndpointConnections |
관리되는 인스턴스의 프라이빗 엔드포인트 연결 목록입니다. |
|
properties.provisioningState |
관리되는 인스턴스의 프로비전 상태입니다. |
|
properties.proxyOverride |
인스턴스에 연결하는 데 사용되는 연결 유형입니다. |
|
properties.publicDataEndpointEnabled |
boolean |
공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. |
properties.requestedBackupStorageRedundancy |
이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
|
properties.restorePointInTime |
string (date-time) |
새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.servicePrincipal |
관리되는 인스턴스의 서비스 주체입니다. |
|
properties.sourceManagedInstanceId |
string (arm-id) |
이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. |
properties.state |
string |
관리되는 인스턴스의 상태입니다. |
properties.storageIOps |
integer (int32) |
스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageSizeInGB |
integer (int32) |
스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageThroughputMBps |
integer (int32) |
스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. |
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.virtualClusterId |
string |
Managed Instance에 대한 가상 클러스터 리소스 ID입니다. |
properties.zoneRedundant |
boolean |
다중 az를 사용할 수 있는지 여부입니다. |
sku |
관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 종류입니다. |
ManagedInstanceDatabaseFormat
SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다.
값 | Description |
---|---|
AlwaysUpToDate | |
SQLServer2022 |
ManagedInstanceExternalAdministrator
Active Directory 관리자의 속성입니다.
Name | 형식 | Description |
---|---|---|
administratorType |
심각도 관리자의 유형입니다. |
|
azureADOnlyAuthentication |
boolean |
Azure Active Directory만 인증을 사용하도록 설정했습니다. |
login |
string |
서버 관리자의 로그인 이름입니다. |
principalType |
서버 관리자의 보안 주체 유형입니다. |
|
sid |
string (uuid) |
서버 관리자의 SID(개체 ID)입니다. |
tenantId |
string (uuid) |
관리자의 테넌트 ID입니다. |
ManagedInstanceLicenseType
라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다.
값 | Description |
---|---|
BasePrice | |
LicenseIncluded |
ManagedInstancePecProperty
관리되는 인스턴스 아래의 프라이빗 엔드포인트 연결
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
properties |
프라이빗 엔드포인트 연결 속성 |
ManagedInstancePrivateEndpointConnectionProperties
프라이빗 엔드포인트 연결의 속성입니다.
Name | 형식 | Description |
---|---|---|
privateEndpoint |
연결이 속한 프라이빗 엔드포인트입니다. |
|
privateLinkServiceConnectionState |
프라이빗 엔드포인트 연결의 연결 상태입니다. |
|
provisioningState |
string |
프라이빗 엔드포인트 연결의 상태입니다. |
ManagedInstancePrivateEndpointProperty
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트의 리소스 ID입니다. |
ManagedInstancePrivateLinkServiceConnectionStateProperty
Name | 형식 | Description |
---|---|---|
actionsRequired |
string |
프라이빗 링크 서비스 연결 설명입니다. |
description |
string |
프라이빗 링크 서비스 연결 설명입니다. |
status |
string |
프라이빗 링크 서비스 연결 상태입니다. |
ManagedInstanceProxyOverride
인스턴스에 연결하는 데 사용되는 연결 유형입니다.
값 | Description |
---|---|
Default | |
Proxy | |
Redirect |
ManagedInstanceUpdate
Azure SQL Database 관리형 인스턴스에 대한 업데이트 요청입니다.
Name | 형식 | Description |
---|---|---|
identity |
관리되는 인스턴스 ID |
|
properties.administratorLogin |
string |
관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만드는 경우에만 지정할 수 있습니다(만들기에 필요). |
properties.administratorLoginPassword |
string |
관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요). |
properties.administrators |
인스턴스의 Azure Active Directory 관리자입니다. 인스턴스 생성 시간에만 사용할 수 있습니다. 인스턴스 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다. |
|
properties.authenticationMetadata |
관리되는 인스턴스의 인증 메타데이터 조회 모드입니다. |
|
properties.collation |
string |
관리되는 인스턴스의 데이터 정렬입니다. |
properties.createTime |
string (date-time) |
Managed Instance 만들기의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.currentBackupStorageRedundancy |
이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
|
properties.databaseFormat |
SQL 엔진 버전과 관련된 인스턴스 데이터베이스의 내부 형식을 지정합니다. |
|
properties.dnsZone |
string |
관리되는 인스턴스가 있는 Dns 영역입니다. |
properties.dnsZonePartner |
string (arm-id) |
이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다. |
properties.externalGovernanceStatus |
외부 거버넌스의 상태입니다. |
|
properties.fullyQualifiedDomainName |
string |
관리되는 인스턴스의 정규화된 도메인 이름입니다. |
properties.hybridSecondaryUsage |
하이브리드 보조 사용. 가능한 값은 'Active'(기본값) 및 'Passive'입니다(고객은 보조를 수동 DR로 사용). |
|
properties.hybridSecondaryUsageDetected |
하이브리드 보조 사용량이 검색되었습니다. 가능한 값은 '활성'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족하지 않음) 및 '수동'(고객이 보조를 수동 DR로 사용하기 위한 요구 사항을 충족)입니다. |
|
properties.instancePoolId |
string |
이 관리되는 서버가 속한 인스턴스 풀의 ID입니다. |
properties.isGeneralPurposeV2 |
boolean |
범용 버전의 GPv2 변형인지 여부입니다. |
properties.keyId |
string |
암호화에 사용할 키의 CMK URI입니다. |
properties.licenseType |
라이선스 유형입니다. 가능한 값은 'LicenseIncluded'(새 SQL 라이선스를 포함하는 일반 가격) 및 'BasePrice'(사용자 고유의 SQL 라이선스를 가져오기 위한 할인된 AHB 가격)입니다. |
|
properties.maintenanceConfigurationId |
string |
이 관리되는 인스턴스에 적용할 유지 관리 구성 ID를 지정합니다. |
properties.managedInstanceCreateMode |
데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 인스턴스 만들기. 복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다. |
|
properties.minimalTlsVersion |
string |
최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2' |
properties.pricingModel |
Managed Instance의 가격 책정 모델입니다. |
|
properties.primaryUserAssignedIdentityId |
string (arm-id) |
기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다. |
properties.privateEndpointConnections |
관리되는 인스턴스의 프라이빗 엔드포인트 연결 목록입니다. |
|
properties.provisioningState |
관리되는 인스턴스의 프로비전 상태입니다. |
|
properties.proxyOverride |
인스턴스에 연결하는 데 사용되는 연결 유형입니다. |
|
properties.publicDataEndpointEnabled |
boolean |
공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다. |
properties.requestedBackupStorageRedundancy |
이 인스턴스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. 옵션은 로컬(LocallyRedundantStorage), 영역(ZoneRedundantStorage), Geo(GeoRedundantStorage) 및 GeoZone(GeoZoneRedundantStorage)입니다. |
|
properties.restorePointInTime |
string (date-time) |
새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. |
properties.servicePrincipal |
관리되는 인스턴스의 서비스 주체입니다. |
|
properties.sourceManagedInstanceId |
string (arm-id) |
이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다. |
properties.state |
string |
관리되는 인스턴스의 상태입니다. |
properties.storageIOps |
integer (int32) |
스토리지 IOps. 최소값: 300. 최대값: 80000 1개의 IOps만 증분할 수 있습니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageSizeInGB |
integer (int32) |
스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다. |
properties.storageThroughputMBps |
integer (int32) |
스토리지 처리량 MBps 매개 변수는 인스턴스 만들기/업데이트 작업에서 지원되지 않습니다. |
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.virtualClusterId |
string |
Managed Instance에 대한 가상 클러스터 리소스 ID입니다. |
properties.zoneRedundant |
boolean |
다중 az를 사용할 수 있는지 여부입니다. |
sku |
관리되는 인스턴스 sku |
|
tags |
object |
리소스 태그. |
ManagedServerCreateMode
데이터베이스 만들기 모드를 지정합니다.
기본값: 일반 인스턴스 만들기.
복원: 특정 시점으로 백업 집합을 복원하여 인스턴스를 만듭니다. RestorePointInTime 및 SourceManagedInstanceId를 지정해야 합니다.
값 | Description |
---|---|
Default | |
PointInTimeRestore |
PricingModel
Managed Instance의 가격 책정 모델입니다.
값 | Description |
---|---|
Freemium | |
Regular |
PrincipalType
서버 관리자의 보안 주체 유형입니다.
값 | Description |
---|---|
Application | |
Group | |
User |
ProvisioningState
관리되는 인스턴스의 프로비전 상태입니다.
값 | Description |
---|---|
Canceled | |
Created | |
Failed | |
InProgress | |
Succeeded |
ResourceIdentity
리소스에 대한 Azure Active Directory ID 구성입니다.
Name | 형식 | Description |
---|---|---|
principalId |
string (uuid) |
Azure Active Directory 보안 주체 ID입니다. |
tenantId |
string (uuid) |
Azure Active Directory 테넌트 ID입니다. |
type |
ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다. |
|
userAssignedIdentities |
<string,
User |
사용할 사용자 할당 ID의 리소스 ID |
ServicePrincipal
리소스에 대한 관리되는 인스턴스의 서비스 주체 구성입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
Azure Active Directory 애플리케이션 클라이언트 ID입니다. |
principalId |
string |
Azure Active Directory 애플리케이션 개체 ID입니다. |
tenantId |
string |
Azure Active Directory 테넌트 ID입니다. |
type |
서비스 주체 유형입니다. |
ServicePrincipalType
서비스 주체 유형입니다.
값 | Description |
---|---|
None | |
SystemAssigned |
Sku
ARM 리소스 SKU입니다.
Name | 형식 | Description |
---|---|---|
capacity |
integer (int32) |
특정 SKU의 용량입니다. |
family |
string |
서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. |
name |
string |
SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. |
size |
string |
특정 SKU의 크기 |
tier |
string |
특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. |
UserIdentity
리소스에 대한 Azure Active Directory ID 구성입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string (uuid) |
Azure Active Directory 클라이언트 ID입니다. |
principalId |
string (uuid) |
Azure Active Directory 보안 주체 ID입니다. |