Virtual Clusters - Get

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Získá virtuální cluster.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
virtualClusterName	path	True	string	Název virtuálního clusteru.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	VirtualCluster	Zadaný virtuální cluster se úspěšně načetl.
Other Status Codes		Chybové odpovědi: *** 400 SubscriptionNotEnabledForFeature – uživatelské předplatné není povolené pro funkci, kterou se uživatel pokusil použít. 400 ManagementServiceFeatureDisabled – Uživatel se pokusil použít funkci, která je zakázaná. 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno. 404 VirtualClusterDoesNotExist – virtuální cluster neexistuje. 404 ResourceDoesNotExist – prostředek s názvem{0} neexistuje. Pokud chcete pokračovat, zadejte platný název prostředku. 404 VirtualClusterNotInSubscriptionResourceGroup – Zadaný virtuální cluster v zadané skupině prostředků a předplatném neexistuje. 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno. 404 SubscriptionDoesNotHaveVirtualCluster – požadovaný virtuální cluster se nenašel. 404 ResourceNotFound – požadovaný prostředek nebyl nalezen. 409 VirtualClusterRemovalAlreadyInProgress – odebrání virtuálního clusteru už probíhá. Virtuální cluster se automaticky vytvoří při vytvoření první instance a automaticky se odebere s odstraněním poslední instance. Další informace najdete tady: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – Virtuální cluster není prázdný a nelze ho odstranit. 409 VirtualClusterIsBusy – Virtuální cluster je momentálně zaneprázdněný. Zkuste operaci zopakovat později. 409 VirtualClusterRemovalFailed – Požadavek na vyřazení virtuálního clusteru selhal. Zkontrolujte, jestli existují aktivní závislé prostředky. 409 ConflictingVirtualClusterOperation – aktuálně probíhá operace pro virtuální cluster. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Get virtual cluster

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Definice

VirtualCluster

Virtuální cluster Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.childResources	string[]	Seznam prostředků v tomto virtuálním clusteru
properties.family	string	Pokud má služba různé generace hardwaru, pro stejnou skladovou položku, můžete to tady zaznamenat.
properties.maintenanceConfigurationId	string	Určuje ID konfigurace údržby, které se má použít pro tento virtuální cluster.
properties.subnetId	string	ID prostředku podsítě pro virtuální cluster
tags	object	Značky prostředků.
type	string	Typ prostředku.