Virtual Clusters - List By Resource Group

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Obtém uma lista de clusters virtuais num grupo de recursos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/virtualClusters?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.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	VirtualClusterListResult	Obteve com êxito a lista de clusters virtuais.
Other Status Codes		Respostas de Erro: *** 400 SubscriptionNotEnabledForFeature - Subscrição de utilizador não 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. Repita 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 dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 ConflictingSubscriptionOperation - Está em curso uma operação para a subscrição. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Name

Tipo

Description

200 OK

VirtualClusterListResult

Obteve com êxito a lista de clusters virtuais.

Other Status Codes

Respostas de Erro: ***

400 SubscriptionNotEnabledForFeature - Subscrição de utilizador não 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. Repita 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 dos pedidos máximos que podem ser processados por recursos disponíveis.
429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.
429 ConflictingSubscriptionOperation - Está em curso uma operação para a subscrição.
503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis.

Exemplos

List virtual clusters by resource group

GET https://management.azure.com/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters?api-version=2021-11-01


/**
 * Samples for VirtualClusters ListByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/VirtualClusterListByResourceGroup.
     * json
     */
    /**
     * Sample code: List virtual clusters by resource group.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listVirtualClustersByResourceGroup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getVirtualClusters().listByResourceGroup("testrg",
            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

{
  "value": [
    {
      "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"
    },
    {
      "properties": {
        "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "family": "Gen4",
        "childResources": [
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance3",
          "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance4"
        ],
        "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-subnet2-14b795bd-9c8f-46ec-adb8-2b8eff56ac16",
      "name": "vc-subnet1-14b795bd-9c8f-46ec-adb8-2b8eff56ac16",
      "type": "Microsoft.Sql/virtualClusters"
    }
  ]
}

Definições

Name	Description
VirtualCluster	Um cluster virtual SQL do Azure.
VirtualClusterListResult	Uma lista de clusters virtuais.

VirtualCluster

Um cluster virtual SQL do Azure.

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 de recurso da sub-rede para o cluster virtual.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso.

VirtualClusterListResult

Uma lista de clusters virtuais.

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	VirtualCluster[]	Matriz de resultados.

Partilhar via

Virtual Clusters - List By Resource Group

Parâmetros do URI

Respostas

Exemplos

List virtual clusters by resource group

Pedido de amostra

Resposta da amostra

Definições

VirtualCluster

VirtualClusterListResult

Recursos adicionais