Managed Instances - List

서비스:

SQL Database

API 버전:

2021-11-01

구독의 모든 관리되는 인스턴스 목록을 가져옵니다.

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

선택적 매개 변수:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.
$expand	query		string	응답에 포함할 자식 리소스입니다.

응답

Name	형식	Description
200 OK	ManagedInstanceListResult	관리되는 인스턴스 목록을 성공적으로 검색했습니다.
Other Status Codes		오류 응답: ***

예제

List managed instances

List managed instances with $expand=administrators/activedirectory

List managed instances

샘플 요청

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ManagedInstances List. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceList.json
     */
    /**
     * Sample code: List managed instances.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstances(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, Context.NONE);
    }
}

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

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo"
      }
    }
  ]
}

List managed instances with $expand=administrators/activedirectory

샘플 요청

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for ManagedInstances List. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceListWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: List managed instances with $expand=administrators/activedirectory.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listManagedInstancesWithExpandAdministratorsActivedirectory(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().list(null, Context.NONE);
    }
}

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

샘플 응답

상태 코드:

200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen4",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.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",
        "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",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "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
        }
      }
    }
  ]
}

정의

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 가격)입니다.
ManagedInstanceListResult	관리되는 인스턴스 목록입니다.
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

ManagedInstanceListResult

관리되는 인스턴스 목록입니다.

Name	형식	Description
nextLink	string	연결하여 결과의 다음 페이지를 검색합니다.
value	ManagedInstance[]	결과 배열입니다.

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입니다.