Virtual Clusters - Get

Tjänst:

SQL Database

API-version:

2021-11-01

Hämtar ett virtuellt kluster.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters/{virtualClusterName}?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.
virtualClusterName	path	True	string	Namnet på det virtuella klustret.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	VirtualCluster	Det angivna virtuella klustret 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

Get virtual cluster

Exempelbegäran

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

/**
 * 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", 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

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

Definitioner

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.