Virtual Clusters - List By Resource Group

Tjänst:

SQL Database

API-version:

2021-11-01

Hämtar en lista över virtuella kluster i en resursgrupp.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	VirtualClusterListResult	Listan över virtuella kluster har hämtats.
Other Status Codes		Felsvar: *** 400 SubscriptionNotEnabledForFeature – Användarprenumerationen är inte aktiverad för funktionsanvändare som försöker använda. 400 ManagementServiceFeatureDisabled – Användaren försökte använda en funktion som är inaktiverad. 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte. 404 VirtualClusterDoesNotExist – det virtuella klustret finns inte. 404 ResourceDoesNotExist – Resurs med namnet "{0}" finns inte. Om du vill fortsätta anger du ett giltigt resursnamn. 404 VirtualClusterNotInSubscriptionResourceGroup – Det angivna virtuella klustret finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionNotFound – Den begärda prenumerationen hittades inte. 404 SubscriptionDoesNotHaveVirtualCluster – Det begärda virtuella klustret hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 409 VirtualClusterRemovalAlreadyInProgress – Borttagning av virtuellt kluster pågår redan. Det virtuella klustret skapas automatiskt när första instansen skapas och tas bort automatiskt med den senaste instansen. Läs mer här: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – Det virtuella klustret är inte tomt och kan inte tas bort. 409 VirtualClusterIsBusy – Det virtuella klustret är för närvarande upptaget. Försök igen senare. 409 VirtualClusterRemovalFailed – Begäran om att släppa det virtuella klustret misslyckades. Kontrollera om det finns aktiva beroende resurser. 409 ConflictingVirtualClusterOperation – En åtgärd pågår för det virtuella klustret. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 ConflictingSubscriptionOperation – En åtgärd pågår för prenumerationen. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

Exempel

List virtual clusters by resource group

Exempelbegäran

HTTP

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

Java

/**
 * Samples for VirtualClusters ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterListByResourceGroup.
     * json
     */
    /**
     * Sample code: List virtual clusters by resource group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listVirtualClustersByResourceGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().listByResourceGroup("testrg",
            com.azure.core.util.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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
VirtualCluster	Ett Azure SQL virtuellt kluster.
VirtualClusterListResult	En lista över virtuella kluster.

VirtualCluster

Ett Azure SQL virtuellt kluster.

Name	Typ	Description
id	string	Resurs-ID.
location	string	Resursplats.
name	string	Resursnamn.
properties.childResources	string[]	Lista över resurser i det här virtuella klustret.
properties.family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
properties.maintenanceConfigurationId	string	Anger underhållskonfigurations-ID som ska tillämpas på det här virtuella klustret.
properties.subnetId	string	Resurs-ID för undernätet för det virtuella klustret.
tags	object	Resurstaggar.
type	string	Resurstyp.

VirtualClusterListResult

En lista över virtuella kluster.

Name	Typ	Description
nextLink	string	Länka för att hämta nästa sida med resultat.
value	VirtualCluster[]	Matris med resultat.