Virtual Clusters - Get

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Pobiera klaster wirtualny.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
virtualClusterName	path	True	string	Nazwa klastra wirtualnego.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VirtualCluster	Pomyślnie pobrano określony klaster wirtualny.
Other Status Codes		Odpowiedzi na błędy: *** 400 SubscriptionNotEnabledForFeature — subskrypcja użytkownika nie jest włączona dla użytkownika funkcji, który próbował użyć. 400 ManagementServiceFeatureDisabled — użytkownik próbował użyć funkcji, która jest wyłączona. 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji. 404 VirtualClusterDoesNotExist — klaster wirtualny nie istnieje. 404 ResourceDoesNotExist — zasób o nazwie "{0}" nie istnieje. Aby kontynuować, określ prawidłową nazwę zasobu. 404 VirtualClusterNotInSubscriptionResourceGroup — określony klaster wirtualny nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionNotFound — nie można odnaleźć żądanej subskrypcji. 404 SubscriptionDoesNotHaveVirtualCluster — nie znaleziono żądanego klastra wirtualnego 404 ResourceNotFound — żądany zasób nie został znaleziony. 409 VirtualClusterRemovalAlreadyInProgress — usuwanie klastra wirtualnego jest już w toku. Klaster wirtualny jest tworzony automatycznie przy użyciu tworzenia pierwszego wystąpienia i automatycznie usuwany po usunięciu ostatniego wystąpienia. Dowiedz się więcej tutaj: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty — klaster wirtualny nie jest pusty i nie można go usunąć. 409 VirtualClusterIsBusy — klaster wirtualny jest obecnie zajęty. Ponów próbę wykonania operacji później. 409 VirtualClusterRemovalFailed — żądanie porzucenia klastra wirtualnego nie powiodło się. Sprawdź, czy istnieją aktywne zasoby zależne. 409 ConflictingVirtualClusterOperation — operacja jest obecnie w toku dla klastra wirtualnego. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Get virtual cluster

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

VirtualCluster

Klaster wirtualny Azure SQL.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.childResources	string[]	Lista zasobów w tym klastrze wirtualnym.
properties.family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
properties.maintenanceConfigurationId	string	Określa identyfikator konfiguracji konserwacji, który ma być stosowany do tego klastra wirtualnego.
properties.subnetId	string	Identyfikator zasobu podsieci dla klastra wirtualnego.
tags	object	Tagi zasobów.
type	string	Typ zasobu.