通过

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

Managed Instances - List By Resource Group

服务:
SQL Database
API 版本:
2023-08-01

获取资源组中托管实例的列表。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01
具有可选参数: 
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2023-08-01

URI 参数

名称 在 必需 类型 说明
resourceGroupName
 path True

string

包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId
 path True

string

标识 Azure 订阅的订阅 ID。
api-version
 query True

string

要用于请求的 API 版本。
$expand
 query

string

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

响应

名称 类型 说明
200 OK

ManagedInstanceListResult

已成功检索托管实例列表。
Other Status Codes

ErrorResponse

错误响应： ***

  • 400 SubnetMissingRequiredDelegation - 未为 SQL 托管实例委托所选子网。

  • 400 ManagementServiceManagedServerDisabled - 由于禁用托管实例“{0}”，作失败。 请启用托管实例，然后重试。

  • 400 MiGeoRestoreWithWrongBackupStorageRedundancy - 对于具有 LRS/ZRS 备份存储冗余的托管实例，不允许 Geo-Restore。

  • 400 LastBackupNameHasNewline - 请勿在 lastBackupName 中使用禁止字符（“\n”、“\r”）。

  • 400 LastBackupNameHasNonAsciiCharacter -作已中止，因为“LastBackupName”参数包含无效字符。 仅允许 ASCII 字符。

  • 400 ProvisioningDisabled - 按原样显示资源作授权者的错误消息，无需更改

  • 400 LRSCutoverDatabaseDoesNotExist -作已中止，因为请求中指定的数据库名称与指定服务器上的任何数据库名称不匹配。

  • 400 LRSCutoverDatabaseNotInRestoringState -作已中止，因为指定的数据库未处于还原状态。

  • 400 LRSCutoverDatabaseAlreadyRestored -作已中止，因为已还原指定的数据库。

  • 400 LRSCutoverAlreadyInitiated -作已中止，因为指定的数据库的直接转换正在进行中。

  • 400 ManagementServiceFeatureDisabled - 用户尝试使用禁用的功能。

  • 400 AadOnlyAuthenticationIsEnabled - 已启用 Azure Active Directory 仅身份验证。 请与系统管理员联系。

  • 400 UpdateingInstanceAndBackupRedundancy - 实例区域冗余和备份存储冗余不能在同一请求中更新。

  • 400 DeleteOfManagedInstanceIsDisabled - 禁用托管实例的删除作。

  • 400 RequestCantLandOnPaaSv2Platform - 请求需要登陆 PaaSv2 平台，但未启用 PaaSv2。

  • 400 CustomMaintenanceWindowIsDisabled - 未启用自定义维护时段。

  • 400 DeleteOfVersion2VirtualClusterIsDisabled - 未启用版本 2 的虚拟群集删除。

  • 400 DeleteOfVirtualClusterIsDisabled - 未启用虚拟群集删除。

  • 400 MICantBeMovedFromOrToInstancePool - 无法将现有托管实例移动到托管实例池。

  • 400 DnsRefreshOnVirtualClusterIsDisabled - 未启用虚拟群集上的 DNS 记录刷新。

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 ManagedInstanceNotInSubscriptionResourceGroup - 指定的托管实例在指定的资源组和订阅中不存在。

  • 404 SubscriptionNotFound - 找不到请求的订阅。

  • 404 ServerNotInSubscription - 指定的服务器在指定的订阅上不存在。

  • 404 ResourceNotFound - 找不到请求的资源。

  • 409 MiCreateFailedNonDelegatedSubnet - 用户尝试在子网中部署未委托给 Microsoft.Sql/managedInstances 的托管实例或托管实例池。

  • 409 InstancePoolBusy - 实例池正忙于另一个正在进行的作

  • 409 ConflictingManagedInstanceOperation - 托管实例当前正在进行作。

  • 409 BackupRedundancyUpdateAndInstanceRedundancyConflict - 实例是多 az，但备份存储正在从区域冗余更新为非区域冗余。

  • 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress - 无法更新实例冗余，因为备份存储冗余更新正在进行中。

  • 409 InstanceRedundancyUpdateAndBackupRedundancyConflict - 备份存储是非区域冗余的，但实例冗余正在更新为区域冗余。

  • 409 BackupRedundancyUpdateConflict - 无法更新备份存储冗余，因为备份存储冗余更新正在进行中。

  • 409 MiDropFailedOnAuthLocks - 用户尝试删除已对资源应用了锁定的子网中的最后一个托管实例。

  • 412 InstanceNotReadyForBackupRedundancyUpdate - 无法更新备份存储冗余，因为实例尚未就绪。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 429 ConflictingSubscriptionOperation - 订阅当前正在进行作。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

  • 504 RequestTimeout - 服务请求超过了允许的超时。

  • 504 RequestTimeout - 服务请求超过了允许的超时。

示例

List managed instances by resource group
List managed instances by resource group with $expand=administrators/activedirectory

List managed instances by resource group

示例请求

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

示例响应

状态代码:
200 
{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

List managed instances by resource group with $expand=administrators/activedirectory

示例请求

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

示例响应

状态代码:
200 
{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "externalGovernanceStatus": "Enabled",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/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/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

定义

名称 说明
AdministratorType

服务器管理员的类型。
AuthMetadataLookupModes

托管实例的身份验证元数据查找模式。
BackupStorageRedundancy

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

资源管理错误附加信息。
ErrorDetail

错误详细信息。
ErrorResponse

错误响应
ExternalGovernanceStatus

外部治理的状态。
HybridSecondaryUsage

混合辅助用途。 可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。
HybridSecondaryUsageDetected

检测到混合辅助使用情况。 可能的值为“主动”（客户不满足将辅助数据库用作被动 DR 的要求）和“被动”（客户满足将辅助数据库用作被动 DR 的要求）。
IdentityType

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

Azure SQL 托管实例。
ManagedInstanceDatabaseFormat

指定特定于 SQL 引擎版本的实例数据库的内部格式。
ManagedInstanceExternalAdministrator

Active Directory 管理员的属性。
ManagedInstanceLicenseType

许可证类型。 可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。
ManagedInstanceListResult

托管实例的列表。
ManagedInstancePecProperty

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

专用终结点连接的属性。
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

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

指定数据库创建模式。

默认值：定期创建实例。

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

托管实例的定价模型。
PrincipalType

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

托管实例的预配状态。
ResourceIdentity

资源的 Azure Active Directory 标识配置。
ServicePrincipal

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

服务主体类型。
Sku

ARM 资源 SKU。
UserIdentity

资源的 Azure Active Directory 标识配置。

AdministratorType

枚举

服务器管理员的类型。

值 说明
ActiveDirectory

AuthMetadataLookupModes

枚举

托管实例的身份验证元数据查找模式。

值 说明
AzureAD
Paired
Windows

BackupStorageRedundancy

枚举

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

值 说明
Geo
Local
Zone
GeoZone

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。
type

string

其他信息类型。

ErrorDetail

Object

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。
code

string

错误代码。
details

ErrorDetail[]

错误详细信息。
message

string

错误消息。
target

string

错误目标。

ErrorResponse

Object

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

ExternalGovernanceStatus

枚举

外部治理的状态。

值 说明
Enabled
Disabled

HybridSecondaryUsage

枚举

混合辅助用途。 可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。

值 说明
Active
Passive

HybridSecondaryUsageDetected

枚举

检测到混合辅助使用情况。 可能的值为“主动”（客户不满足将辅助数据库用作被动 DR 的要求）和“被动”（客户满足将辅助数据库用作被动 DR 的要求）。

值 说明
Active
Passive

IdentityType

枚举

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

值 说明
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ManagedInstance

Object

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 管理员。 这只能在实例创建时使用。 如果用于实例更新，将忽略它，否则将导致错误。 对于各个 API 的更新，需要使用这些 API。
properties.authenticationMetadata

AuthMetadataLookupModes

托管实例的身份验证元数据查找模式。
properties.collation

string

托管实例的排序规则。
properties.createTime

string (date-time)

指定创建托管实例的时间点（ISO8601格式）。
properties.currentBackupStorageRedundancy

BackupStorageRedundancy

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

ManagedInstanceDatabaseFormat

指定特定于 SQL 引擎版本的实例数据库的内部格式。
properties.dnsZone

string

托管实例位于的 Dns 区域。
properties.dnsZonePartner

string (arm-id)

创建后，此托管实例将共享其 DNS 区域的另一个托管实例的资源 ID。
properties.externalGovernanceStatus

ExternalGovernanceStatus

外部治理的状态。
properties.fullyQualifiedDomainName

string

托管实例的完全限定域名。
properties.hybridSecondaryUsage

HybridSecondaryUsage

混合辅助用途。 可能的值是“主动”（默认值）和“被动”（客户使用辅助数据库作为被动 DR）。
properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

检测到混合辅助使用情况。 可能的值为“主动”（客户不满足将辅助数据库用作被动 DR 的要求）和“被动”（客户满足将辅助数据库用作被动 DR 的要求）。
properties.instancePoolId

string

此托管服务器的实例池的 ID。
properties.isGeneralPurposeV2

boolean

这是否是常规用途版本的 GPv2 变体。
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.pricingModel

PricingModel

托管实例的定价模型。
properties.primaryUserAssignedIdentityId

string (arm-id)

默认情况下要使用的用户分配标识的资源 ID。
properties.privateEndpointConnections

ManagedInstancePecProperty[]

托管实例上的专用终结点连接列表。
properties.provisioningState

ProvisioningState

托管实例的预配状态。
properties.proxyOverride

ManagedInstanceProxyOverride

用于连接到实例的连接类型。
properties.publicDataEndpointEnabled

boolean

是否启用公共数据终结点。
properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

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

string (date-time)

指定将还原以创建新数据库的源数据库的时间点（ISO8601格式）。
properties.servicePrincipal

ServicePrincipal

托管实例的服务主体。
properties.sourceManagedInstanceId

string (arm-id)

与此实例的创建作关联的源托管实例的资源标识符。
properties.state

string

托管实例的状态。
properties.storageIOps

integer (int32)

存储 IOps。 最小值：300。 最大值：80000。 仅允许 1 个 IOps 的增量。 最大值取决于所选硬件系列和 vCore 数。
properties.storageSizeInGB

integer (int32)

存储大小（以 GB 为单位）。 最小值：32。 最大值：16384。 仅允许 32 GB 的增量。 最大值取决于所选硬件系列和 vCore 数。
properties.storageThroughputMBps

integer (int32)

实例创建/更新作不支持存储吞吐量 MBps 参数。
properties.subnetId

string (arm-id)

托管实例的子网资源 ID。
properties.timezoneId

string

时区的 ID。 允许的值是 Windows 支持的时区。 Windows 在注册表的 KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zone 下保留有关支持的时区的详细信息，包括 ID。 可以通过 SQL Server 获取这些注册表值，方法是查询 SELECT 名称 AS timezone_id FROM sys.time_zone_info。 还可以通过在 PowerShell 中执行 [System.TimeZoneInfo]：：GetSystemTimeZones（）来获取 ID 列表。 有效时区 ID 的示例是“太平洋标准时间”或“W”。 欧洲标准时间”。
properties.vCores

integer (int32)

vCore 数。 允许的值：8、16、24、32、40、64、80。
properties.virtualClusterId

string

托管实例的虚拟群集资源 ID。
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

资源类型。

ManagedInstanceDatabaseFormat

枚举

指定特定于 SQL 引擎版本的实例数据库的内部格式。

值 说明
AlwaysUpToDate
SQLServer2022

ManagedInstanceExternalAdministrator

Object

Active Directory 管理员的属性。

名称 类型 说明
administratorType

AdministratorType

服务器管理员的类型。
azureADOnlyAuthentication

boolean

仅启用 Azure Active Directory 身份验证。
login

string

服务器管理员的登录名。
principalType

PrincipalType

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

string (uuid)

服务器管理员的 SID （对象 ID）。
tenantId

string (uuid)

管理员的租户 ID。

ManagedInstanceLicenseType

枚举

许可证类型。 可能的值为“LicenseIncluded”（包括新 SQL 许可证的常规价格）和“BasePrice”（自带 SQL 许可证的折扣 AHB 价格）。

值 说明
LicenseIncluded
BasePrice

ManagedInstanceListResult

Object

托管实例的列表。

名称 类型 说明
nextLink

string

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

ManagedInstance[]

结果数组。

ManagedInstancePecProperty

Object

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

名称 类型 说明
id

string

资源 ID。
properties

ManagedInstancePrivateEndpointConnectionProperties

专用终结点连接属性

ManagedInstancePrivateEndpointConnectionProperties

Object

专用终结点连接的属性。

名称 类型 说明
privateEndpoint

ManagedInstancePrivateEndpointProperty

连接所属的专用终结点。
privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

专用终结点连接的连接状态。
provisioningState

string

专用终结点连接的状态。

ManagedInstancePrivateEndpointProperty

Object
名称 类型 说明
id

string

专用终结点的资源 ID。

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object
名称 类型 说明
actionsRequired

string

专用链接服务连接说明。
description

string

专用链接服务连接说明。
status

string

专用链接服务连接状态。

ManagedInstanceProxyOverride

枚举

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

值 说明
Proxy
Redirect
Default

ManagedServerCreateMode

枚举

指定数据库创建模式。

默认值：定期创建实例。

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

值 说明
Default
PointInTimeRestore

PricingModel

枚举

托管实例的定价模型。

值 说明
Regular
Freemium

PrincipalType

枚举

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

值 说明
User
Group
Application

ProvisioningState

枚举

托管实例的预配状态。

值 说明
Created
InProgress
Succeeded
Failed
Canceled

ResourceIdentity

Object

资源的 Azure Active Directory 标识配置。

名称 类型 说明
principalId

string (uuid)

Azure Active Directory 主体 ID。
tenantId

string (uuid)

Azure Active Directory 租户 ID。
type

IdentityType

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

<string,  UserIdentity>

要使用的用户分配标识的资源 ID

ServicePrincipal

Object

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

名称 类型 说明
clientId

string

Azure Active Directory 应用程序客户端 ID。
principalId

string

Azure Active Directory 应用程序对象 ID。
tenantId

string

Azure Active Directory 租户 ID。
type

ServicePrincipalType

服务主体类型。

ServicePrincipalType

枚举

服务主体类型。

值 说明
None
SystemAssigned

Sku

Object

ARM 资源 SKU。

名称 类型 说明
capacity

integer (int32)

特定 SKU 的容量。
family

string

如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。
name

string

SKU 的名称，通常为字母 + 数字代码，例如 P3。
size

string

特定 SKU 的大小
tier

string

特定 SKU 的层或版本，例如基本 SKU、高级版。

UserIdentity

Object

资源的 Azure Active Directory 标识配置。

名称 类型 说明
clientId

string (uuid)

Azure Active Directory 客户端 ID。
principalId

string (uuid)

Azure Active Directory 主体 ID。