Virtual Clusters - Get

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém um cluster virtual.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
virtualClusterName	path	True	string	O nome do cluster virtual.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	VirtualCluster	O cluster virtual especificado foi obtido com êxito.
Other Status Codes		Respostas de Erro: *** 400 SubscriptionNotEnabledForFeature – a subscrição do utilizador não está ativada para a funcionalidade que o utilizador tentou utilizar. 400 ManagementServiceFeatureDisabled – o utilizador tentou utilizar uma funcionalidade que está desativada. 404 SubscriptionNotFound – a subscrição pedida não foi encontrada. 404 VirtualClusterDoesNotExist – o cluster virtual não existe. 404 ResourceDoesNotExist – o recurso com o nome "{0}" não existe. Para continuar, especifique um nome de recurso válido. 404 VirtualClusterNotInSubscriptionResourceGroup - O cluster virtual especificado não existe no grupo de recursos e na subscrição especificados. 404 SubscriptionNotFound – a subscrição pedida não foi encontrada. 404 SubscriptionDoesNotHaveVirtualCluster – O cluster virtual pedido não foi encontrado 404 ResourceNotFound – o recurso pedido não foi encontrado. 409 VirtualClusterRemovalAlreadyInProgress – a remoção do cluster virtual já está em curso. O cluster virtual é criado automaticamente com a criação da primeira instância e removido automaticamente com a eliminação da última instância. Saiba mais aqui: https://aka.ms/sqlmi-virtual-cluster-removal. 409 VirtualClusterIsNotEmpty – O cluster virtual não está vazio e não pode ser eliminado. 409 VirtualClusterIsBusy – O cluster virtual está atualmente ocupado. Tente novamente a operação mais tarde. 409 VirtualClusterRemovalFailed – O pedido para remover o cluster virtual falhou. Verifique se existem recursos dependentes ativos. 409 ConflictingVirtualClusterOperation – está atualmente em curso uma operação para o cluster virtual. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 ConflictingSubscriptionOperation – está atualmente em curso uma operação para a subscrição. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Get virtual cluster

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Definições

VirtualCluster

Object

Um SQL do Azure cluster virtual.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.childResources	string[]	Lista de recursos neste cluster virtual.
properties.family	string	Se o serviço tiver diferentes gerações de hardware, para o mesmo SKU, isso pode ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica o ID de configuração de manutenção a aplicar a este cluster virtual.
properties.subnetId	string	ID do recurso de sub-rede para o cluster virtual.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.