Virtual Clusters - Get

Service:

SQL Database

API Version:

2021-11-01

Obtient un cluster virtuel.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
virtualClusterName	path	True	string	Nom du cluster virtuel.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Réponses

Nom	Type	Description
200 OK	VirtualCluster	Récupération réussie du cluster virtuel spécifié.
Other Status Codes		Réponses d’erreur : *** 400 SubscriptionNotEnabledForFeature : abonnement utilisateur non activé pour la fonctionnalité que l’utilisateur a tenté d’utiliser. 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 VirtualClusterDoesNotExist : le cluster virtuel n’existe pas. 404 ResourceDoesNotExist : la ressource portant le nom «{0} » n’existe pas. Pour continuer, spécifiez un nom de ressource valide. 404 VirtualClusterNotInSubscriptionResourceGroup : le cluster virtuel spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 SubscriptionDoesNotHaveVirtualCluster : le cluster virtuel demandé est introuvable 404 ResourceNotFound : la ressource demandée est introuvable. 409 VirtualClusterRemovalAlreadyInProgress : la suppression du cluster virtuel est déjà en cours. Le cluster virtuel est automatiquement créé lors de la première instance création et automatiquement supprimé avec la dernière suppression instance. Pour plus d’informations : https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty : le cluster virtuel n’est pas vide et ne peut pas être supprimé. 409 VirtualClusterIsBusy : le cluster virtuel est actuellement occupé. Veuillez réessayer l’opération ultérieurement. 409 VirtualClusterRemovalFailed : la demande de suppression du cluster virtuel a échoué. Vérifiez s’il existe des ressources dépendantes actives. 409 ConflictingVirtualClusterOperation : une opération est en cours pour le cluster virtuel. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 429 ConflictingSubscriptionOperation : une opération est en cours pour l’abonnement. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Get virtual cluster

Sample Request

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

import com.azure.core.util.Context;

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

Sample Response

Status code:

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

Définitions

VirtualCluster

Un cluster virtuel Azure SQL.

Nom	Type	Description
id	string	ID de la ressource
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.childResources	string[]	Liste des ressources de ce cluster virtuel.
properties.family	string	Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici.
properties.maintenanceConfigurationId	string	Spécifie l’ID de configuration de maintenance à appliquer à ce cluster virtuel.
properties.subnetId	string	ID de ressource de sous-réseau pour le cluster virtuel.
tags	object	Balises de ressource.
type	string	Type de ressource.