Virtual Clusters - List By Resource Group

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém uma lista de clusters virtuais em um grupo de recursos.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Respostas

Nome	Tipo	Description
200 OK	VirtualClusterListResult	Recuperou com êxito a lista de clusters virtuais.
Other Status Codes		Respostas de erro: *** 400 SubscriptionNotEnabledForFeature – Assinatura do usuário não habilitada para o recurso que o usuário tentou usar. 400 ManagementServiceFeatureDisabled - O usuário tentou usar um recurso que está desabilitado. 404 SubscriptionNotFound - A assinatura solicitada 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 assinatura especificados. 404 SubscriptionNotFound - A assinatura solicitada não foi encontrada. 404 SubscriptionDoesNotHaveVirtualCluster - O cluster virtual solicitado não foi encontrado 404 ResourceNotFound – O recurso solicitado não foi encontrado. 409 VirtualClusterRemovalAlreadyInProgress – A remoção do cluster virtual já está em andamento. O cluster virtual é criado automaticamente com a criação da primeira instância e removido automaticamente com a exclusã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 excluído. 409 VirtualClusterIsBusy – O cluster virtual está ocupado no momento. Tente novamente a operação mais tarde. 409 VirtualClusterRemovalFailed – Falha na solicitação para remover o cluster virtual. Verifique se há recursos dependentes ativos. 409 ConflictingVirtualClusterOperation – Uma operação está em andamento no momento para o cluster virtual. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 ConflictingSubscriptionOperation – Uma operação está em andamento para a assinatura. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

Exemplos

List virtual clusters by resource group

Solicitação de exemplo

HTTP

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

Java

/**
 * 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 de exemplo

Código de status:

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

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

VirtualCluster

Um cluster virtual SQL do Azure.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local 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 a mesma SKU, isso poderá ser capturado aqui.
properties.maintenanceConfigurationId	string	Especifica a ID de configuração de manutenção a ser aplicada a esse cluster virtual.
properties.subnetId	string	ID do recurso de sub-rede para o cluster virtual.
tags	object	Marcas de recurso.
type	string	Tipo de recurso.

VirtualClusterListResult

Uma lista de clusters virtuais.

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	VirtualCluster[]	Matriz de resultados.