Virtual Clusters - List

Obtiene una lista de todos los virtualClusters de la suscripción.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

La versión de API que se va a utilizar para esta operación.

Respuestas

Nombre Tipo Description
200 OK

VirtualClusterListResult

Operación de Azure completada con éxito.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

List virtualClusters

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/virtualClusters?api-version=2025-01-01

Respuesta de muestra

{
  "value": [
    {
      "name": "VirtualClustercltest",
      "type": "Microsoft.Sql/virtualClusters",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/VirtualClustercltest",
      "location": "japaneast",
      "properties": {
        "childResources": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl"
        ],
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/cltest",
        "version": "1.0"
      }
    },
    {
      "name": "vc2",
      "type": "Microsoft.Sql/virtualClusters",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc2",
      "location": "japaneast",
      "properties": {
        "childResources": [],
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/cltest2",
        "version": "2.0"
      }
    },
    {
      "name": "vc1",
      "type": "Microsoft.Sql/virtualClusters",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc1",
      "location": "japaneast",
      "properties": {
        "childResources": [
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testcl",
          "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/mi"
        ],
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/cltest",
        "version": "2.0"
      }
    }
  ]
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

systemData

Metadatos relativos a la creación y última modificación del recurso.

VirtualCluster

Un clúster virtual de Azure SQL.

VirtualClusterListResult

La respuesta de una operación de lista VirtualCluster.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

La marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

VirtualCluster

Un clúster virtual de Azure SQL.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso

properties.childResources

string[]

Lista de recursos de este clúster virtual.

properties.subnetId

string

Identificador de recurso de subred para el clúster virtual.

properties.version

string

Versión del clúster virtual.

systemData

systemData

Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento"

VirtualClusterListResult

La respuesta de una operación de lista VirtualCluster.

Nombre Tipo Description
nextLink

string (uri)

El enlace a la siguiente página de artículos

value

VirtualCluster[]

Los elementos de VirtualCluster en esta página