Managed Instances - Get

참조

Service:: SQL Database

API Version:: 2021-11-01

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

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

With optional parameters:

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 - 서비스 요청이 허용된 시간 제한을 초과했습니다.

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


import com.azure.core.util.Context;

/** Samples for ManagedInstances GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedInstanceGet.json
     */
    /**
     * Sample code: Get managed instance.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().getByResourceGroupWithResponse("testrg",
            "testinstance", 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

Sample Response

Status code:: 200

{
  "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

HTTP
Java

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


import com.azure.core.util.Context;

/** Samples for ManagedInstances GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceGetWithExpandEqualsAdministrators.json
     */
    /**
     * Sample code: Get managed instance with $expand=administrators/activedirectory.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getManagedInstanceWithExpandAdministratorsActivedirectory(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedInstances().getByResourceGroupWithResponse("testrg",
            "testinstance", 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

Sample Response

Status code:: 200

{
  "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