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

Virtual Clusters - Get

获取虚拟群集。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters/{virtualClusterName}?api-version=2023-08-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

ErrorResponse

错误响应: ***

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

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

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

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

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

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

  • 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 SubscriptionTooManyRequests - 请求超出可用资源可以处理的最大请求数。

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

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

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

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

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

示例

Gets a virtual cluster

示例请求

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

示例响应

{
  "properties": {
    "subnetId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/cltest",
    "version": "2.0",
    "childResources": [
      "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl",
      "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/mi"
    ]
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "name": "vc-f769ed71-b3ad-491a-a9d5-26eeceaa6be2",
  "type": "Microsoft.Sql/virtualClusters"
}

定义

名称 说明
ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

VirtualCluster

Azure SQL 虚拟群集。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

VirtualCluster

Azure SQL 虚拟群集。

名称 类型 说明
id

string

资源 ID。

location

string

资源位置。

name

string

资源名称。

properties.childResources

string[]

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

properties.subnetId

string

虚拟群集的子网资源 ID。

properties.version

string

虚拟群集版本。

tags

object

资源标记。

type

string

资源类型。