Managed Instances - Update
更新托管实例。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2023-08-01URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 | 
|---|---|---|---|---|
| managed | path | True | string | 托管实例的名称。 | 
| resource | path | True | string | 包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。 | 
| subscription | path | True | string | 标识 Azure 订阅的订阅 ID。 | 
| api-version | query | True | string | 要用于请求的 API 版本。 | 
请求正文
| 名称 | 类型 | 说明 | 
|---|---|---|
| identity | 托管实例标识 | |
| properties.administratorLogin | string | 托管实例的管理员用户名。 只能在创建托管实例时指定(创建时需要)。 | 
| properties.administratorLoginPassword | string | 管理员登录密码(创建托管实例时需要)。 | 
| properties.administrators | 实例的 Azure Active Directory 管理员。 这只能在实例创建时使用。 如果用于实例更新,将忽略它,否则将导致错误。 对于各个 API 的更新,需要使用这些 API。 | |
| properties.authenticationMetadata | 托管实例的身份验证元数据查找模式。 | |
| properties.collation | string | 托管实例的排序规则。 | 
| properties.databaseFormat | 指定特定于 SQL 引擎版本的实例数据库的内部格式。 | |
| properties.dnsZonePartner | string (arm-id) | 创建后,此托管实例将共享其 DNS 区域的另一个托管实例的资源 ID。 | 
| properties.hybridSecondaryUsage | 混合辅助用途。 可能的值是“主动”(默认值)和“被动”(客户使用辅助数据库作为被动 DR)。 | |
| properties.instancePoolId | string | 此托管服务器的实例池的 ID。 | 
| properties.isGeneralPurposeV2 | boolean | 这是否是常规用途版本的 GPv2 变体。 | 
| properties.keyId | string | 要用于加密的密钥的 CMK URI。 | 
| properties.licenseType | 许可证类型。 可能的值为“LicenseIncluded”(包括新 SQL 许可证的常规价格)和“BasePrice”(自带 SQL 许可证的折扣 AHB 价格)。 | |
| properties.maintenanceConfigurationId | string | 指定要应用于此托管实例的维护配置 ID。 | 
| properties.managedInstanceCreateMode | 指定数据库创建模式。 默认值:定期创建实例。 还原:通过将一组备份还原到特定的时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。 | |
| properties.minimalTlsVersion | string | 最低 TLS 版本。 允许的值:“None”、“1.0”、“1.1”、“1.2” | 
| properties.pricingModel | 托管实例的定价模型。 | |
| properties.primaryUserAssignedIdentityId | string (arm-id) | 默认情况下要使用的用户分配标识的资源 ID。 | 
| properties.proxyOverride | 用于连接到实例的连接类型。 | |
| properties.publicDataEndpointEnabled | boolean | 是否启用公共数据终结点。 | 
| properties.requestedBackupStorageRedundancy | 用于存储此实例的备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | |
| properties.restorePointInTime | string (date-time) | 指定将还原以创建新数据库的源数据库的时间点(ISO8601格式)。 | 
| properties.servicePrincipal | 托管实例的服务主体。 | |
| properties.sourceManagedInstanceId | string (arm-id) | 与此实例的创建作关联的源托管实例的资源标识符。 | 
| 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.zoneRedundant | boolean | 是否启用 multi-az。 | 
| sku | 托管实例 SKU | |
| tags | object | 资源标记。 | 
响应
| 名称 | 类型 | 说明 | 
|---|---|---|
| 200 OK | 已成功更新托管实例。 | |
| 202 Accepted | 接受 标头 Location: string | |
| Other Status Codes | 错误响应: *** 
 | 
示例
| Remove maintenance policy from managed instance (select default maintenance policy) | 
| Update managed instance with all properties | 
| Update managed instance with minimal properties | 
Remove maintenance policy from managed instance (select default maintenance policy)
示例请求
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01
{
  "properties": {
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default"
  }
}
示例响应
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/japaneast/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "hybridSecondaryUsage": "Passive",
    "externalGovernanceStatus": "Enabled",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111Update managed instance with all properties
示例请求
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2023-08-01
{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8
  },
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "minimalTlsVersion": "1.2",
    "licenseType": "BasePrice",
    "vCores": 8,
    "storageSizeInGB": 448,
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "requestedBackupStorageRedundancy": "Geo",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "databaseFormat": "AlwaysUpToDate"
  }
}
示例响应
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "location": "japaneast",
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "vCores": 8,
    "storageSizeInGB": 448,
    "licenseType": "BasePrice",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Redirect",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "databaseFormat": "AlwaysUpToDate"
  }
}Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111Update managed instance with minimal properties
示例请求
示例响应
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen4"
  },
  "properties": {
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "administratorLogin": "PLACEHOLDER",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Ready",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "dnsZone": "1b4e2caff2530",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_Default",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "tagKey1": "TagValue1"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances"
}Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/locations/eastus/managedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111定义
| 名称 | 说明 | 
|---|---|
| Administrator | 服务器管理员的类型。 | 
| Auth | 托管实例的身份验证元数据查找模式。 | 
| Backup | 用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | 
| Error | 资源管理错误附加信息。 | 
| Error | 错误详细信息。 | 
| Error | 错误响应 | 
| External | 外部治理的状态。 | 
| Hybrid | 混合辅助用途。 可能的值是“主动”(默认值)和“被动”(客户使用辅助数据库作为被动 DR)。 | 
| Hybrid | 检测到混合辅助使用情况。 可能的值为“主动”(客户不满足将辅助数据库用作被动 DR 的要求)和“被动”(客户满足将辅助数据库用作被动 DR 的要求)。 | 
| Identity | 标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。 | 
| Managed | Azure SQL 托管实例。 | 
| Managed | 指定特定于 SQL 引擎版本的实例数据库的内部格式。 | 
| Managed | Active Directory 管理员的属性。 | 
| Managed | 许可证类型。 可能的值为“LicenseIncluded”(包括新 SQL 许可证的常规价格)和“BasePrice”(自带 SQL 许可证的折扣 AHB 价格)。 | 
| Managed | 托管实例下的专用终结点连接 | 
| Managed | 专用终结点连接的属性。 | 
| Managed | |
| Managed | |
| Managed | 用于连接到实例的连接类型。 | 
| Managed | Azure SQL 数据库托管实例的更新请求。 | 
| Managed | 指定数据库创建模式。 默认值:定期创建实例。 还原:通过将一组备份还原到特定的时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。 | 
| Pricing | 托管实例的定价模型。 | 
| Principal | 服务器管理员的主体类型。 | 
| Provisioning | 托管实例的预配状态。 | 
| Resource | 资源的 Azure Active Directory 标识配置。 | 
| Service | 资源的托管实例的服务主体配置。 | 
| Service | 服务主体类型。 | 
| Sku | ARM 资源 SKU。 | 
| User | 资源的 Azure Active Directory 标识配置。 | 
AdministratorType 
			
			服务器管理员的类型。
| 值 | 说明 | 
|---|---|
| ActiveDirectory | 
AuthMetadataLookupModes   
			
			托管实例的身份验证元数据查找模式。
| 值 | 说明 | 
|---|---|
| AzureAD | |
| Paired | |
| Windows | 
BackupStorageRedundancy  
			
			用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage)
| 值 | 说明 | 
|---|---|
| Geo | |
| Local | |
| Zone | |
| GeoZone | 
ErrorAdditionalInfo  
			
			资源管理错误附加信息。
| 名称 | 类型 | 说明 | 
|---|---|---|
| info | object | 其他信息。 | 
| type | string | 其他信息类型。 | 
ErrorDetail 
			
			错误详细信息。
| 名称 | 类型 | 说明 | 
|---|---|---|
| additionalInfo | 错误附加信息。 | |
| code | string | 错误代码。 | 
| details | 错误详细信息。 | |
| message | string | 错误消息。 | 
| target | string | 错误目标。 | 
ErrorResponse 
			
			错误响应
| 名称 | 类型 | 说明 | 
|---|---|---|
| error | 错误对象。 | 
ExternalGovernanceStatus  
			
			外部治理的状态。
| 值 | 说明 | 
|---|---|
| Enabled | |
| Disabled | 
HybridSecondaryUsage  
			
			混合辅助用途。 可能的值是“主动”(默认值)和“被动”(客户使用辅助数据库作为被动 DR)。
| 值 | 说明 | 
|---|---|
| Active | |
| Passive | 
HybridSecondaryUsageDetected   
			
			检测到混合辅助使用情况。 可能的值为“主动”(客户不满足将辅助数据库用作被动 DR 的要求)和“被动”(客户满足将辅助数据库用作被动 DR 的要求)。
| 值 | 说明 | 
|---|---|
| Active | |
| Passive | 
IdentityType 
			
			标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。
| 值 | 说明 | 
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned | 
ManagedInstance 
			
			Azure SQL 托管实例。
| 名称 | 类型 | 说明 | 
|---|---|---|
| id | string | 资源 ID。 | 
| identity | 托管实例的 Azure Active Directory 标识。 | |
| location | string | 资源位置。 | 
| name | string | 资源名称。 | 
| properties.administratorLogin | string | 托管实例的管理员用户名。 只能在创建托管实例时指定(创建时需要)。 | 
| properties.administratorLoginPassword | string | 管理员登录密码(创建托管实例时需要)。 | 
| properties.administrators | 实例的 Azure Active Directory 管理员。 这只能在实例创建时使用。 如果用于实例更新,将忽略它,否则将导致错误。 对于各个 API 的更新,需要使用这些 API。 | |
| properties.authenticationMetadata | 托管实例的身份验证元数据查找模式。 | |
| properties.collation | string | 托管实例的排序规则。 | 
| properties.createTime | string (date-time) | 指定创建托管实例的时间点(ISO8601格式)。 | 
| properties.currentBackupStorageRedundancy | 用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | |
| properties.databaseFormat | 指定特定于 SQL 引擎版本的实例数据库的内部格式。 | |
| properties.dnsZone | string | 托管实例位于的 Dns 区域。 | 
| properties.dnsZonePartner | string (arm-id) | 创建后,此托管实例将共享其 DNS 区域的另一个托管实例的资源 ID。 | 
| properties.externalGovernanceStatus | 外部治理的状态。 | |
| properties.fullyQualifiedDomainName | string | 托管实例的完全限定域名。 | 
| properties.hybridSecondaryUsage | 混合辅助用途。 可能的值是“主动”(默认值)和“被动”(客户使用辅助数据库作为被动 DR)。 | |
| properties.hybridSecondaryUsageDetected | 检测到混合辅助使用情况。 可能的值为“主动”(客户不满足将辅助数据库用作被动 DR 的要求)和“被动”(客户满足将辅助数据库用作被动 DR 的要求)。 | |
| properties.instancePoolId | string | 此托管服务器的实例池的 ID。 | 
| properties.isGeneralPurposeV2 | boolean | 这是否是常规用途版本的 GPv2 变体。 | 
| properties.keyId | string | 要用于加密的密钥的 CMK URI。 | 
| properties.licenseType | 许可证类型。 可能的值为“LicenseIncluded”(包括新 SQL 许可证的常规价格)和“BasePrice”(自带 SQL 许可证的折扣 AHB 价格)。 | |
| properties.maintenanceConfigurationId | string | 指定要应用于此托管实例的维护配置 ID。 | 
| properties.managedInstanceCreateMode | 指定数据库创建模式。 默认值:定期创建实例。 还原:通过将一组备份还原到特定的时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。 | |
| properties.minimalTlsVersion | string | 最低 TLS 版本。 允许的值:“None”、“1.0”、“1.1”、“1.2” | 
| properties.pricingModel | 托管实例的定价模型。 | |
| properties.primaryUserAssignedIdentityId | string (arm-id) | 默认情况下要使用的用户分配标识的资源 ID。 | 
| properties.privateEndpointConnections | 托管实例上的专用终结点连接列表。 | |
| properties.provisioningState | 托管实例的预配状态。 | |
| properties.proxyOverride | 用于连接到实例的连接类型。 | |
| properties.publicDataEndpointEnabled | boolean | 是否启用公共数据终结点。 | 
| properties.requestedBackupStorageRedundancy | 用于存储此实例的备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | |
| properties.restorePointInTime | string (date-time) | 指定将还原以创建新数据库的源数据库的时间点(ISO8601格式)。 | 
| properties.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.name 允许的值:GP_Gen5、GP_G8IM、GP_G8IH、BC_Gen5、BC_G8IM、BC_G8IH | |
| tags | object | 资源标记。 | 
| type | string | 资源类型。 | 
ManagedInstanceDatabaseFormat   
			
			指定特定于 SQL 引擎版本的实例数据库的内部格式。
| 值 | 说明 | 
|---|---|
| AlwaysUpToDate | |
| SQLServer2022 | 
ManagedInstanceExternalAdministrator   
			
			Active Directory 管理员的属性。
| 名称 | 类型 | 说明 | 
|---|---|---|
| administratorType | 服务器管理员的类型。 | |
| azureADOnlyAuthentication | boolean | 仅启用 Azure Active Directory 身份验证。 | 
| login | string | 服务器管理员的登录名。 | 
| principalType | 服务器管理员的主体类型。 | |
| sid | string (uuid) | 服务器管理员的 SID (对象 ID)。 | 
| tenantId | string (uuid) | 管理员的租户 ID。 | 
ManagedInstanceLicenseType   
			
			许可证类型。 可能的值为“LicenseIncluded”(包括新 SQL 许可证的常规价格)和“BasePrice”(自带 SQL 许可证的折扣 AHB 价格)。
| 值 | 说明 | 
|---|---|
| LicenseIncluded | |
| BasePrice | 
ManagedInstancePecProperty   
			
			托管实例下的专用终结点连接
| 名称 | 类型 | 说明 | 
|---|---|---|
| id | string | 资源 ID。 | 
| properties | 专用终结点连接属性 | 
ManagedInstancePrivateEndpointConnectionProperties     
			
			专用终结点连接的属性。
| 名称 | 类型 | 说明 | 
|---|---|---|
| privateEndpoint | 连接所属的专用终结点。 | |
| privateLinkServiceConnectionState | 专用终结点连接的连接状态。 | |
| provisioningState | string | 专用终结点连接的状态。 | 
ManagedInstancePrivateEndpointProperty    
			
			
				| 名称 | 类型 | 说明 | 
|---|---|---|
| id | string | 专用终结点的资源 ID。 | 
ManagedInstancePrivateLinkServiceConnectionStateProperty       
			
			
				| 名称 | 类型 | 说明 | 
|---|---|---|
| actionsRequired | string | 专用链接服务连接说明。 | 
| description | string | 专用链接服务连接说明。 | 
| status | string | 专用链接服务连接状态。 | 
ManagedInstanceProxyOverride   
			
			用于连接到实例的连接类型。
| 值 | 说明 | 
|---|---|
| Proxy | |
| Redirect | |
| Default | 
ManagedInstanceUpdate  
			
			Azure SQL 数据库托管实例的更新请求。
| 名称 | 类型 | 说明 | 
|---|---|---|
| identity | 托管实例标识 | |
| properties.administratorLogin | string | 托管实例的管理员用户名。 只能在创建托管实例时指定(创建时需要)。 | 
| properties.administratorLoginPassword | string | 管理员登录密码(创建托管实例时需要)。 | 
| properties.administrators | 实例的 Azure Active Directory 管理员。 这只能在实例创建时使用。 如果用于实例更新,将忽略它,否则将导致错误。 对于各个 API 的更新,需要使用这些 API。 | |
| properties.authenticationMetadata | 托管实例的身份验证元数据查找模式。 | |
| properties.collation | string | 托管实例的排序规则。 | 
| properties.createTime | string (date-time) | 指定创建托管实例的时间点(ISO8601格式)。 | 
| properties.currentBackupStorageRedundancy | 用于存储此实例备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | |
| properties.databaseFormat | 指定特定于 SQL 引擎版本的实例数据库的内部格式。 | |
| properties.dnsZone | string | 托管实例位于的 Dns 区域。 | 
| properties.dnsZonePartner | string (arm-id) | 创建后,此托管实例将共享其 DNS 区域的另一个托管实例的资源 ID。 | 
| properties.externalGovernanceStatus | 外部治理的状态。 | |
| properties.fullyQualifiedDomainName | string | 托管实例的完全限定域名。 | 
| properties.hybridSecondaryUsage | 混合辅助用途。 可能的值是“主动”(默认值)和“被动”(客户使用辅助数据库作为被动 DR)。 | |
| properties.hybridSecondaryUsageDetected | 检测到混合辅助使用情况。 可能的值为“主动”(客户不满足将辅助数据库用作被动 DR 的要求)和“被动”(客户满足将辅助数据库用作被动 DR 的要求)。 | |
| properties.instancePoolId | string | 此托管服务器的实例池的 ID。 | 
| properties.isGeneralPurposeV2 | boolean | 这是否是常规用途版本的 GPv2 变体。 | 
| properties.keyId | string | 要用于加密的密钥的 CMK URI。 | 
| properties.licenseType | 许可证类型。 可能的值为“LicenseIncluded”(包括新 SQL 许可证的常规价格)和“BasePrice”(自带 SQL 许可证的折扣 AHB 价格)。 | |
| properties.maintenanceConfigurationId | string | 指定要应用于此托管实例的维护配置 ID。 | 
| properties.managedInstanceCreateMode | 指定数据库创建模式。 默认值:定期创建实例。 还原:通过将一组备份还原到特定的时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。 | |
| properties.minimalTlsVersion | string | 最低 TLS 版本。 允许的值:“None”、“1.0”、“1.1”、“1.2” | 
| properties.pricingModel | 托管实例的定价模型。 | |
| properties.primaryUserAssignedIdentityId | string (arm-id) | 默认情况下要使用的用户分配标识的资源 ID。 | 
| properties.privateEndpointConnections | 托管实例上的专用终结点连接列表。 | |
| properties.provisioningState | 托管实例的预配状态。 | |
| properties.proxyOverride | 用于连接到实例的连接类型。 | |
| properties.publicDataEndpointEnabled | boolean | 是否启用公共数据终结点。 | 
| properties.requestedBackupStorageRedundancy | 用于存储此实例的备份的存储帐户类型。 选项包括 Local (LocalRedundantStorage)、Zone (ZoneRedundantStorage)、Geo (GeoRedundantStorage) 和 GeoZone(GeoZoneRedundantStorage) | |
| properties.restorePointInTime | string (date-time) | 指定将还原以创建新数据库的源数据库的时间点(ISO8601格式)。 | 
| properties.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 | |
| tags | object | 资源标记。 | 
ManagedServerCreateMode   
			
			指定数据库创建模式。
默认值:定期创建实例。
还原:通过将一组备份还原到特定的时间点来创建实例。 必须指定 RestorePointInTime 和 SourceManagedInstanceId。
| 值 | 说明 | 
|---|---|
| Default | |
| PointInTimeRestore | 
PricingModel 
			
			托管实例的定价模型。
| 值 | 说明 | 
|---|---|
| Regular | |
| Freemium | 
PrincipalType 
			
			服务器管理员的主体类型。
| 值 | 说明 | 
|---|---|
| User | |
| Group | |
| Application | 
ProvisioningState 
			
			托管实例的预配状态。
| 值 | 说明 | 
|---|---|
| Created | |
| InProgress | |
| Succeeded | |
| Failed | |
| Canceled | 
ResourceIdentity 
			
			资源的 Azure Active Directory 标识配置。
| 名称 | 类型 | 说明 | 
|---|---|---|
| principalId | string (uuid) | Azure Active Directory 主体 ID。 | 
| tenantId | string (uuid) | Azure Active Directory 租户 ID。 | 
| type | 标识类型。 将此设置为“SystemAssigned”,以便自动为资源创建和分配 Azure Active Directory 主体。 | |
| userAssignedIdentities | 
				
		<string, 
		User | 要使用的用户分配标识的资源 ID | 
ServicePrincipal 
			
			资源的托管实例的服务主体配置。
| 名称 | 类型 | 说明 | 
|---|---|---|
| clientId | string | Azure Active Directory 应用程序客户端 ID。 | 
| principalId | string | Azure Active Directory 应用程序对象 ID。 | 
| tenantId | string | Azure Active Directory 租户 ID。 | 
| type | 服务主体类型。 | 
ServicePrincipalType  
			
			服务主体类型。
| 值 | 说明 | 
|---|---|
| None | |
| SystemAssigned | 
Sku
ARM 资源 SKU。
| 名称 | 类型 | 说明 | 
|---|---|---|
| capacity | integer (int32) | 特定 SKU 的容量。 | 
| family | string | 如果服务具有不同代的硬件(对于同一 SKU,则可以在此处捕获)。 | 
| name | string | SKU 的名称,通常为字母 + 数字代码,例如 P3。 | 
| size | string | 特定 SKU 的大小 | 
| tier | string | 特定 SKU 的层或版本,例如基本 SKU、高级版。 | 
UserIdentity 
			
			资源的 Azure Active Directory 标识配置。
| 名称 | 类型 | 说明 | 
|---|---|---|
| clientId | string (uuid) | Azure Active Directory 客户端 ID。 | 
| principalId | string (uuid) | Azure Active Directory 主体 ID。 |