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

Managed Instances - List

获取订阅中所有托管实例的列表。

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

名称 必需 类型 说明
subscriptionId
path True

string

用于标识 Azure 订阅的订阅 ID。

api-version
query True

string

要用于请求的 API 版本。

$expand
query

string

要包含在响应中的子资源。

响应

名称 类型 说明
200 OK

ManagedInstanceListResult

已成功检索托管实例的列表。

Other Status Codes

错误响应:***

示例

List managed instances
List managed instances with $expand=administrators/activedirectory

List managed instances

示例请求

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

示例响应

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

示例请求

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

示例响应

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

定义

名称 说明
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 价格。

ManagedInstanceListResult

托管实例的列表。

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

ManagedInstanceListResult

托管实例的列表。

名称 类型 说明
nextLink

string

用于检索下一页结果的链接。

value

ManagedInstance[]

结果数组。

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。