Managed Instances - Get

관리형 인스턴스를 가져옵니다.

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

URI 매개 변수

Name In Required Type Description
managedInstanceName
path True
  • string

관리되는 인스턴스의 이름입니다.

resourceGroupName
path True
  • string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure 리소스 관리자 API 또는 포털에서 이 값을 가져올 수 있습니다.

subscriptionId
path True
  • string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True
  • string

요청에 사용할 API 버전입니다.

$expand
query
  • string

응답에 포함할 자식 리소스입니다.

응답

Name Type Description
200 OK

지정된 관리되는 인스턴스를 성공적으로 검색했습니다.

Other Status Codes

오류 응답: ***

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - LRS/ZRS 백업 스토리지 중복성이 있는 관리되는 인스턴스에는 Geo-Restore 허용되지 않습니다.

  • 400 UpdatingInstanceAndBackupRedundancy - 인스턴스 영역 중복성 및 백업 스토리지 중복성은 동일한 요청에서 업데이트할 수 없습니다.

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

  • 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory 전용 인증이 사용됩니다. 시스템 관리자에게 문의하세요.

  • 400 ManagementServiceFeatureDisabled - 사용자가 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

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

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

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - 지정된 관리되는 인스턴스가 지정된 리소스 그룹 및 구독에 없습니다.

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

  • 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.

  • 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 - 현재 구독에 대한 작업이 진행 중입니다.

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

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

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

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

예제

Get managed instance
Get managed instance with $expand=administrators/activedirectory

Get managed instance

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "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": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

Get managed instance with $expand=administrators/activedirectory

Sample Request

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2021-11-01

Sample Response

{
  "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": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "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
    }
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}

정의

AdministratorType

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

BackupStorageRedundancy

이 인스턴스에 대한 백업을 저장하는 데 사용되는 스토리지 계정 유형입니다. 옵션은 Local(LocallyRedundantStorage), Zone(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

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

Name Type Description
ActiveDirectory
  • string

BackupStorageRedundancy

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

Name Type Description
Geo
  • string
GeoZone
  • string
Local
  • string
Zone
  • string

IdentityType

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

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

ManagedInstance

Azure SQL 관리되는 인스턴스입니다.

Name Type Description
id
  • string

리소스 ID입니다.

identity

관리되는 인스턴스의 Azure Active Directory ID입니다.

location
  • string

리소스 위치.

name
  • string

리소스 이름입니다.

properties.administratorLogin
  • string

관리되는 인스턴스의 관리자 사용자 이름입니다. 관리되는 인스턴스를 만들 때만 지정할 수 있습니다(만들기에 필요).

properties.administratorLoginPassword
  • string

관리자 로그인 암호입니다(관리되는 인스턴스를 만드는 데 필요).

properties.administrators

서버의 Azure Active Directory 관리자입니다.

properties.collation
  • string

관리되는 인스턴스의 데이터 정렬입니다.

properties.currentBackupStorageRedundancy

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

properties.dnsZone
  • string

관리되는 인스턴스가 있는 Dns 영역입니다.

properties.dnsZonePartner
  • string

이 관리되는 인스턴스가 만든 후 공유할 DNS 영역이 있는 다른 관리되는 인스턴스의 리소스 ID입니다.

properties.fullyQualifiedDomainName
  • string

관리되는 인스턴스의 정규화된 도메인 이름입니다.

properties.instancePoolId
  • string

이 관리되는 서버가 속한 인스턴스 풀의 ID입니다.

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.primaryUserAssignedIdentityId
  • string

기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.

properties.privateEndpointConnections

관리되는 인스턴스의 프라이빗 엔드포인트 연결 목록입니다.

properties.provisioningState enum:
  • Accepted
  • Canceled
  • Created
  • Creating
  • Deleted
  • Deleting
  • Failed
  • NotSpecified
  • Registering
  • Running
  • Succeeded
  • TimedOut
  • Unknown
  • Unrecognized
  • Updating
properties.proxyOverride

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

properties.publicDataEndpointEnabled
  • boolean

공용 데이터 엔드포인트를 사용할 수 있는지 여부입니다.

properties.requestedBackupStorageRedundancy

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

properties.restorePointInTime
  • string

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

properties.servicePrincipal

관리되는 인스턴스의 서비스 주체입니다.

properties.sourceManagedInstanceId
  • string

이 인스턴스의 만들기 작업과 연결된 원본 관리되는 인스턴스의 리소스 식별자입니다.

properties.state
  • string

관리되는 인스턴스의 상태입니다.

properties.storageSizeInGB
  • integer

스토리지 크기(GB)입니다. 최소값: 32. 최대값: 16384. 32GB 증분만 허용됩니다. 최대값은 선택한 하드웨어 제품군 및 vCore 수에 따라 달라집니다.

properties.subnetId
  • string

관리되는 인스턴스에 대한 서브넷 리소스 ID입니다.

properties.timezoneId
  • string

표준 시간대의 ID입니다. 허용되는 값은 Windows에서 지원하는 표준 시간대입니다. Windows는 id를 포함하여 지원되는 표준 시간대에 대한 세부 정보를 레지스트리의 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones에 보관합니다. SELECT 이름 AS timezone_id FROM sys.time_zone_info 쿼리하여 SQL Server 통해 해당 레지스트리 값을 가져올 수 있습니다. PowerShell에서 [System.TimeZoneInfo]::GetSystemTimeZones()를 실행하여 ID 목록을 가져올 수도 있습니다. 유효한 표준 시간대 ID의 예는 "태평양 표준시" 또는 "W"입니다. 유럽 표준시".

properties.vCores
  • integer

vCore 수입니다. 허용되는 값: 8, 16, 24, 32, 40, 64, 80.

properties.zoneRedundant
  • boolean

multi-az를 사용할 수 있는지 여부입니다.

sku

관리되는 인스턴스 SKU. sku.name 허용되는 값: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags
  • object

리소스 태그.

type
  • string

리소스 종류.

ManagedInstanceExternalAdministrator

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

Name Type Description
administratorType

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

azureADOnlyAuthentication
  • boolean

Azure Active Directory만 인증을 사용하도록 설정했습니다.

login
  • string

서버 관리자의 로그인 이름입니다.

principalType

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

sid
  • string

서버 관리자의 SID(개체 ID)입니다.

tenantId
  • string

관리자의 테넌트 ID입니다.

ManagedInstanceLicenseType

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

Name Type Description
BasePrice
  • string
LicenseIncluded
  • string

ManagedInstancePecProperty

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

Name Type Description
id
  • string

리소스 ID입니다.

properties

프라이빗 엔드포인트 연결 속성

ManagedInstancePrivateEndpointConnectionProperties

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

Name Type Description
privateEndpoint

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

privateLinkServiceConnectionState

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

provisioningState
  • string

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

ManagedInstancePrivateEndpointProperty

Name Type Description
id
  • string

프라이빗 엔드포인트의 리소스 ID입니다.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired
  • string

프라이빗 링크 서비스 연결 설명입니다.

description
  • string

프라이빗 링크 서비스 연결 설명입니다.

status
  • string

프라이빗 링크 서비스 연결 상태입니다.

ManagedInstanceProxyOverride

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

Name Type Description
Default
  • string
Proxy
  • string
Redirect
  • string

ManagedServerCreateMode

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

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

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

Name Type Description
Default
  • string
PointInTimeRestore
  • string

PrincipalType

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

Name Type Description
Application
  • string
Group
  • string
User
  • string

ResourceIdentity

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

Name Type Description
principalId
  • string

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

tenantId
  • string

Azure Active Directory 테넌트 ID입니다.

type

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

userAssignedIdentities

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

ServicePrincipal

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

Name Type Description
clientId
  • string

Azure Active Directory 애플리케이션 클라이언트 ID입니다.

principalId
  • string

Azure Active Directory 애플리케이션 개체 ID입니다.

tenantId
  • string

Azure Active Directory 테넌트 ID입니다.

type

서비스 주체 유형입니다.

ServicePrincipalType

서비스 주체 유형입니다.

Name Type Description
None
  • string
SystemAssigned
  • string

Sku

ARM 리소스 SKU입니다.

Name Type Description
capacity
  • integer

특정 SKU의 용량입니다.

family
  • string

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

name
  • string

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

size
  • string

특정 SKU의 크기

tier
  • string

특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다.

UserIdentity

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

Name Type Description
clientId
  • string

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

principalId
  • string

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