通过

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

Virtual Clusters - List By Resource Group

  • 参考
服务:
SQL Database
API 版本:
2021-11-01

获取资源组中虚拟群集的列表。

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

URI 参数

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

string

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

string

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

string

要用于请求的 API 版本。

响应

名称 类型 说明
200 OK

VirtualClusterListResult

已成功检索虚拟群集列表。
Other Status Codes

错误响应：***

  • 400 SubscriptionNotEnabledForFeature - 未为用户尝试使用的功能启用用户订阅。

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

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

  • 404 VirtualClusterDoesNotExist - 虚拟群集不存在。

  • 404 ResourceDoesNotExist - 名称为“”{0}的资源不存在。 若要继续，请指定有效的资源名称。

  • 404 VirtualClusterNotInSubscriptionResourceGroup - 指定的虚拟群集不存在于指定的资源组和订阅中。

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

  • 404 SubscriptionDoesNotHaveVirtualCluster - 找不到请求的虚拟群集

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

  • 409 VirtualClusterRemovalAlreadyInProgress - 删除虚拟群集已在进行中。 虚拟群集在创建第一个实例时自动创建，并在删除最后一个实例时自动删除。 在此处了解详细信息：https://aka.ms/sqlmi-virtual-cluster-removal。

  • 409 VirtualClusterIsNotEmpty - 虚拟群集不为空，无法删除。

  • 409 VirtualClusterIsBusy - 虚拟群集当前正忙。 请稍后重试操作。

  • 409 VirtualClusterRemovalFailed - 删除虚拟群集的请求失败。 检查是否存在活动的依赖资源。

  • 409 ConflictingVirtualClusterOperation - 当前正在进行虚拟群集的操作。

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

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

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

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

示例

List virtual clusters by resource group

示例请求

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

示例响应

状态代码:
200 
{
  "value": [
    {
      "properties": {
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "family": "Gen4",
        "childResources": [
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance1",
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance2"
        ],
        "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
      },
      "location": "onebox",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
      "name": "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
      "type": "Microsoft.Sql/virtualClusters"
    },
    {
      "properties": {
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "family": "Gen4",
        "childResources": [
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance3",
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance4"
        ],
        "maintenanceConfigurationId": "/subscriptions/ab0e51c0-83c0-4380-8ae9-025516df392f/resourceGroups/Federation/providers/Microsoft.Maintenance/maintenanceConfigurations/MiPolicy1"
      },
      "location": "onebox",
      "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet2-14b795bd-9c8f-46ec-adb8-2b8eff56ac16",
      "name": "vc-subnet1-14b795bd-9c8f-46ec-adb8-2b8eff56ac16",
      "type": "Microsoft.Sql/virtualClusters"
    }
  ]
}

定义

名称 说明
VirtualCluster

Azure SQL虚拟群集。
VirtualClusterListResult

虚拟群集的列表。

VirtualCluster

Azure SQL虚拟群集。

名称 类型 说明
id

string

资源 ID。
location

string

资源位置。
name

string

资源名称。
properties.childResources

string[]

此虚拟群集中的资源列表。
properties.family

string

如果服务针对同一 SKU 具有不同代系的硬件，则可以在此处捕获。
properties.maintenanceConfigurationId

string

指定要应用于此虚拟群集的维护配置 ID。
properties.subnetId

string

虚拟群集的子网资源 ID。
tags

object

资源标记。
type

string

资源类型。

VirtualClusterListResult

虚拟群集的列表。

名称 类型 说明
nextLink

string

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

VirtualCluster[]

结果数组。