你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Managed Instances - Get

服务:

SQL Database

API 版本:

2021-11-01

获取托管实例。

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 参数

名称	在	必需	类型	说明
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	要包含在响应中的子资源。

响应

名称	类型	说明
200 OK	ManagedInstance	已成功检索指定的托管实例。
Other Status Codes		错误响应：*** 400 MiGeoRestoreWithWrongBackupStorageRedundancy - 具有 LRS/ZRS 备份存储冗余的托管实例不允许 Geo-Restore。 400 UpdateingInstanceAndBackupRedundancy - 无法在同一请求中更新实例区域冗余和备份存储冗余。 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 - 用户尝试删除子网中的最后一个托管实例，该子网已对资源 () 应用了 Lock。 409 MiCreateFailedNonDelegatedSubnet - 用户尝试在未委托给 Microsoft.Sql/managedInstances 的子网中部署托管实例或托管实例池。 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

示例请求

HTTP

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

Java

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

示例响应

状态代码:

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

示例请求

HTTP

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

Java

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

示例响应

状态代码:

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

定义

名称	说明
AdministratorType	服务器管理员的类型。
BackupStorageRedundancy	用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage) 、Zone (ZoneRedundantStorage) 、Geo (GeoRedundantStorage) 和 GeoZone (GeoZoneRedundantStorage)
IdentityType	标识类型。 将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。
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 标识配置。
ServicePrincipal	资源托管实例的服务主体配置。
ServicePrincipalType	服务主体类型。
Sku	ARM 资源 SKU。
UserIdentity	资源的 Azure Active Directory 标识配置。

AdministratorType

服务器管理员的类型。

名称	类型	说明
ActiveDirectory	string

BackupStorageRedundancy

用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage) 、Zone (ZoneRedundantStorage) 、Geo (GeoRedundantStorage) 和 GeoZone (GeoZoneRedundantStorage)

名称	类型	说明
Geo	string
GeoZone	string
Local	string
Zone	string

IdentityType

标识类型。 将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。

名称	类型	说明
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ManagedInstance

Azure SQL托管实例。

名称	类型	说明
id	string	资源 ID。
identity	ResourceIdentity	托管实例的 Azure Active Directory 标识。
location	string	资源位置。
name	string	资源名称。
properties.administratorLogin	string	托管实例的管理员用户名。 仅当 (创建托管实例并且需要创建) 时，才能指定。
properties.administratorLoginPassword	string	创建托管实例 () 所需的管理员登录密码。
properties.administrators	ManagedInstanceExternalAdministrator	服务器的 Azure Active Directory 管理员。
properties.collation	string	托管实例的排序规则。
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage) 、Zone (ZoneRedundantStorage) 、Geo (GeoRedundantStorage) 和 GeoZone (GeoZoneRedundantStorage)
properties.dnsZone	string	托管实例位于的 Dns 区域。
properties.dnsZonePartner	string	另一个托管实例的资源 ID，该托管实例在创建后将共享其 DNS 区域。
properties.fullyQualifiedDomainName	string	托管实例的完全限定域名。
properties.instancePoolId	string	此托管服务器所属的实例池的 ID。
properties.keyId	string	用于加密的密钥的 CMK URI。
properties.licenseType	ManagedInstanceLicenseType	许可证类型。 可能的值为“LicenseIncluded” (包含新 SQL 许可证) 的常规价格，“BasePrice” (将自己的 SQL 许可证) 的折扣 AHB 价格。
properties.maintenanceConfigurationId	string	指定要应用于此托管实例的维护配置 ID。
properties.managedInstanceCreateMode	ManagedServerCreateMode	指定数据库创建模式。 默认值：定期创建实例。 还原：通过将一组备份还原到特定时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。
properties.minimalTlsVersion	string	最低 TLS 版本。 允许的值：“None”、“1.0”、“1.1”、“1.2”
properties.primaryUserAssignedIdentityId	string	默认要使用的用户分配标识的资源 ID。
properties.privateEndpointConnections	ManagedInstancePecProperty[]	托管实例上的专用终结点连接列表。
properties.provisioningState	enum: Accepted Canceled Created Creating Deleted Deleting Failed NotSpecified Registering Running Succeeded TimedOut Unknown Unrecognized Updating
properties.proxyOverride	ManagedInstanceProxyOverride	用于连接到实例的连接类型。
properties.publicDataEndpointEnabled	boolean	是否启用公共数据终结点。
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage) 、Zone (ZoneRedundantStorage) 、Geo (GeoRedundantStorage) 和 GeoZone (GeoZoneRedundantStorage)
properties.restorePointInTime	string	指定要还原以创建新数据库的源数据库的时间点 (ISO8601 格式) 。
properties.servicePrincipal	ServicePrincipal	托管实例的服务主体。
properties.sourceManagedInstanceId	string	与此实例的创建操作关联的源托管实例的资源标识符。
properties.state	string	托管实例的状态。
properties.storageSizeInGB	integer	存储大小（以 GB 为单位）。 最小值：32。 最大值：16384。 仅允许 32 GB 的增量。 最大值取决于所选硬件系列和 vCore 数。
properties.subnetId	string	托管实例的子网资源 ID。
properties.timezoneId	string	时区的 ID。 允许的值是 Windows 支持的时区。 Windows 会在注册表中的 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zone 下保留有关支持时区（包括 ID）的详细信息。 可以通过查询 SELECT name 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。 sku.name 允许的值：GP_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH
tags	object	资源标记。
type	string	资源类型。

ManagedInstanceExternalAdministrator

Active Directory 管理员的属性。

名称	类型	说明
administratorType	AdministratorType	服务器管理员的类型。
azureADOnlyAuthentication	boolean	已启用仅限 Azure Active Directory 身份验证。
login	string	服务器管理员的登录名。
principalType	PrincipalType	服务器管理员的主体类型。
sid	string	SID (服务器管理员的对象 ID) 。
tenantId	string	管理员的租户 ID。

ManagedInstanceLicenseType

许可证类型。 可能的值为“LicenseIncluded” (包含新 SQL 许可证) 的常规价格，“BasePrice” (将自己的 SQL 许可证) 的折扣 AHB 价格。

名称	类型	说明
BasePrice	string
LicenseIncluded	string

ManagedInstancePecProperty

托管实例下的专用终结点连接

名称	类型	说明
id	string	资源 ID。
properties	ManagedInstancePrivateEndpointConnectionProperties	专用终结点连接属性

ManagedInstancePrivateEndpointConnectionProperties

专用终结点连接的属性。

名称	类型	说明
privateEndpoint	ManagedInstancePrivateEndpointProperty	连接所属的专用终结点。
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	专用终结点连接的连接状态。
provisioningState	string	专用终结点连接的状态。

ManagedInstancePrivateEndpointProperty

名称	类型	说明
id	string	专用终结点的资源 ID。

ManagedInstancePrivateLinkServiceConnectionStateProperty

名称	类型	说明
actionsRequired	string	专用链接服务连接说明。
description	string	专用链接服务连接说明。
status	string	专用链接服务连接状态。

ManagedInstanceProxyOverride

用于连接到实例的连接类型。

名称	类型	说明
Default	string
Proxy	string
Redirect	string

ManagedServerCreateMode

指定数据库创建模式。

默认值：定期创建实例。

还原：通过将一组备份还原到特定时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。

名称	类型	说明
Default	string
PointInTimeRestore	string

PrincipalType

服务器管理员的主体类型。

名称	类型	说明
Application	string
Group	string
User	string

ResourceIdentity

资源的 Azure Active Directory 标识配置。

名称	类型	说明
principalId	string	Azure Active Directory 主体 ID。
tenantId	string	Azure Active Directory 租户 ID。
type	IdentityType	标识类型。 将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。
userAssignedIdentities	<string,  UserIdentity>	要使用的用户分配标识的资源 ID

ServicePrincipal

资源托管实例的服务主体配置。

名称	类型	说明
clientId	string	Azure Active Directory 应用程序客户端 ID。
principalId	string	Azure Active Directory 应用程序对象 ID。
tenantId	string	Azure Active Directory 租户 ID。
type	ServicePrincipalType	服务主体类型。

ServicePrincipalType

服务主体类型。

名称	类型	说明
None	string
SystemAssigned	string

Sku

ARM 资源 SKU。

名称	类型	说明
capacity	integer	特定 SKU 的容量。
family	string	如果服务具有不同代系的硬件（对于同一 SKU），则可以在此处进行捕获。
name	string	SKU 的名称，通常为字母 + 数字代码，例如 P3。
size	string	特定 SKU 的大小
tier	string	特定 SKU 的层或版本，例如“基本”、“高级”。

UserIdentity

资源的 Azure Active Directory 标识配置。

名称	类型	说明
clientId	string	Azure Active Directory 客户端 ID。
principalId	string	Azure Active Directory 主体 ID。