Virtual Clusters - List By Resource Group
Gets a list of virtual clusters in a resource group.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters?api-version=2021-11-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal. |
subscription
|
path | True |
string |
The subscription ID that identifies an Azure subscription. |
api-version
|
query | True |
string |
The API version to use for the request. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Successfully retrieved the list of virtual clusters. |
|
Other Status Codes |
*** Error Responses: ***
|
Examples
List virtual clusters by resource group
Sample request
Sample response
{
"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"
}
]
}
Definitions
Name | Description |
---|---|
Virtual |
An Azure SQL virtual cluster. |
Virtual |
A list of virtual clusters. |
VirtualCluster
An Azure SQL virtual cluster.
Name | Type | Description |
---|---|---|
id |
string |
Resource ID. |
location |
string |
Resource location. |
name |
string |
Resource name. |
properties.childResources |
string[] |
List of resources in this virtual cluster. |
properties.family |
string |
If the service has different generations of hardware, for the same SKU, then that can be captured here. |
properties.maintenanceConfigurationId |
string |
Specifies maintenance configuration id to apply to this virtual cluster. |
properties.subnetId |
string |
Subnet resource ID for the virtual cluster. |
tags |
object |
Resource tags. |
type |
string |
Resource type. |
VirtualClusterListResult
A list of virtual clusters.
Name | Type | Description |
---|---|---|
nextLink |
string |
Link to retrieve next page of results. |
value |
Array of results. |