다음을 통해 공유


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(다음 안에) 필수 형식 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 형식 Description
200 OK

ManagedInstance

지정된 관리되는 instance 성공적으로 검색했습니다.

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 - 지정된 관리되는 instance 지정된 리소스 그룹 및 구독에 없습니다.

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

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

  • 409 ConflictingManagedInstanceOperation - 관리되는 instance 대한 작업이 현재 진행 중입니다.

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - instance 다중 az이지만 백업 스토리지가 영역 중복에서 비 영역 중복으로 업데이트되고 있습니다.

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - 백업 스토리지 중복 업데이트가 진행 중이므로 instance 중복성을 업데이트할 수 없습니다.

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - 백업 스토리지는 영역이 아닌 중복이지만 instance 중복성이 영역 중복으로 업데이트되고 있습니다.

  • 409 BackupRedundancyUpdateConflict - 백업 스토리지 중복 업데이트가 이미 진행 중이므로 백업 스토리지 중복성을 업데이트할 수 없습니다.

  • 409 MiDropFailedOnAuthLocks - 사용자가 리소스에 잠금이 적용된 서브넷에서 마지막 Managed Instance 삭제하려고 했습니다.

  • 409 MiCreateFailedNonDelegatedSubnet - 사용자가 Microsoft.Sql/managedInstances에 위임되지 않은 서브넷에 Managed Instance 또는 Managed Instance 풀을 배포하려고 했습니다.

  • 412 InstanceNotReadyForBackupRedundancyUpdate - instance 준비되지 않았기 때문에 백업 스토리지 중복성을 업데이트할 수 없습니다.

  • 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

샘플 요청

GET 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",
    "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

샘플 요청

GET 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",
    "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"
}

정의

Name Description
AdministratorType

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

BackupStorageRedundancy

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

IdentityType

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

ManagedInstance

Azure SQL 관리되는 instance.

ManagedInstanceExternalAdministrator

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

ManagedInstanceLicenseType

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

ManagedInstancePecProperty

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

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

instance 연결하는 데 사용되는 연결 유형입니다.

ManagedServerCreateMode

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

기본값: 일반 instance 생성.

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

PrincipalType

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

ResourceIdentity

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

ServicePrincipal

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

ServicePrincipalType

서비스 주체 유형입니다.

Sku

ARM 리소스 SKU입니다.

UserIdentity

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

AdministratorType

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

Name 형식 Description
ActiveDirectory

string

BackupStorageRedundancy

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

Name 형식 Description
Geo

string

GeoZone

string

Local

string

Zone

string

IdentityType

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

Name 형식 Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Azure SQL 관리되는 instance.

Name 형식 Description
id

string

리소스 ID입니다.

identity

ResourceIdentity

관리되는 instance Azure Active Directory ID입니다.

location

string

리소스 위치.

name

string

리소스 이름입니다.

properties.administratorLogin

string

관리되는 instance 대한 관리자 사용자 이름입니다. 관리되는 instance 생성될 때만 지정할 수 있으며 생성에 필요합니다.

properties.administratorLoginPassword

string

관리자 로그인 암호(관리되는 instance 만들기에 필요).

properties.administrators

ManagedInstanceExternalAdministrator

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

properties.collation

string

관리되는 instance 데이터 정렬

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

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

properties.dnsZone

string

관리되는 instance 있는 Dns 영역입니다.

properties.dnsZonePartner

string

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

properties.fullyQualifiedDomainName

string

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

properties.instancePoolId

string

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

properties.keyId

string

암호화에 사용할 키의 CMK URI입니다.

properties.licenseType

ManagedInstanceLicenseType

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

properties.maintenanceConfigurationId

string

이 관리되는 instance 적용할 유지 관리 구성 ID를 지정합니다.

properties.managedInstanceCreateMode

ManagedServerCreateMode

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

기본값: 일반 instance 생성.

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

properties.minimalTlsVersion

string

최소 TLS 버전입니다. 허용되는 값: 'None', '1.0', '1.1', '1.2'

properties.primaryUserAssignedIdentityId

string

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

properties.privateEndpointConnections

ManagedInstancePecProperty[]

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

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

ManagedInstanceProxyOverride

instance 연결하는 데 사용되는 연결 유형입니다.

properties.publicDataEndpointEnabled

boolean

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

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

properties.restorePointInTime

string

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

properties.servicePrincipal

ServicePrincipal

관리되는 instance 서비스 주체입니다.

properties.sourceManagedInstanceId

string

이 instance 만들기 작업과 연결된 원본 관리 instance 리소스 식별자입니다.

properties.state

string

관리되는 instance 상태입니다.

properties.storageSizeInGB

integer

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

properties.subnetId

string

관리되는 instance 대한 서브넷 리소스 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

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

sku

Sku

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

tags

object

리소스 태그.

type

string

리소스 종류.

ManagedInstanceExternalAdministrator

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

Name 형식 Description
administratorType

AdministratorType

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

azureADOnlyAuthentication

boolean

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

login

string

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

principalType

PrincipalType

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

sid

string

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

tenantId

string

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

ManagedInstanceLicenseType

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

Name 형식 Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

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

Name 형식 Description
id

string

리소스 ID입니다.

properties

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointConnectionProperties

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

Name 형식 Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

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

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

provisioningState

string

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

ManagedInstancePrivateEndpointProperty

Name 형식 Description
id

string

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Name 형식 Description
actionsRequired

string

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

description

string

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

status

string

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

ManagedInstanceProxyOverride

instance 연결하는 데 사용되는 연결 유형입니다.

Name 형식 Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

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

기본값: 일반 instance 생성.

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

Name 형식 Description
Default

string

PointInTimeRestore

string

PrincipalType

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

Name 형식 Description
Application

string

Group

string

User

string

ResourceIdentity

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

Name 형식 Description
principalId

string

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

tenantId

string

Azure Active Directory 테넌트 ID입니다.

type

IdentityType

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

userAssignedIdentities

<string,  UserIdentity>

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

ServicePrincipal

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

Name 형식 Description
clientId

string

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

principalId

string

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

tenantId

string

Azure Active Directory 테넌트 ID입니다.

type

ServicePrincipalType

서비스 주체 유형입니다.

ServicePrincipalType

서비스 주체 유형입니다.

Name 형식 Description
None

string

SystemAssigned

string

Sku

ARM 리소스 SKU입니다.

Name 형식 Description
capacity

integer

특정 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

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

principalId

string

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