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

Virtual Clusters - Get

Service:

SQL Database

API Version:

2021-11-01

获取虚拟群集。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。
subscriptionId	path	True	string	用于标识 Azure 订阅的订阅 ID。
virtualClusterName	path	True	string	虚拟群集的名称。
api-version	query	True	string	要用于请求的 API 版本。

响应

名称	类型	说明
200 OK	VirtualCluster	已成功检索指定的虚拟群集。
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 - 超出可用资源可处理的最大请求数的请求数。

示例

Get virtual cluster

Sample Request

HTTP

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2?api-version=2021-11-01

Java

import com.azure.core.util.Context;

/** Samples for VirtualClusters GetByResourceGroup. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterGet.json
     */
    /**
     * Sample code: Get virtual cluster.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getVirtualCluster(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().getByResourceGroupWithResponse("testrg",
            "vc-subnet1-f769ed71-b3ad-491a-a9d5-26eeceaa6be2", 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

Sample Response

Status code:

200

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

定义

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	资源类型。