次の方法で共有


Virtual Clusters - Get

仮想クラスターを取得します。

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

要求のサンプル

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

応答のサンプル

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

リソースの種類。