Clusters - Get

Referencia

Servicio:: Log Analytics

Versión de la API:: 2023-09-01

Obtiene una instancia de clúster de Log Analytics.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2023-09-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
clusterName	path	True	string	Nombre del clúster de Log Analytics.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	Cluster	Definición de respuesta correcta.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

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

ClustersGet

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2023-09-01

Respuesta de muestra

status code:: 200

{
  "properties": {
    "keyVaultProperties": {
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyName": "aztest2170cert",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "provisioningState": "Succeeded",
    "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
    "billingType": "Cluster",
    "lastModifiedDate": "Sun, 04 Jan 2020 17:10:56 GMT",
    "createdDate": "Mon, 13 Jan 2020 14:40:33 GMT",
    "isDoubleEncryptionEnabled": true,
    "isAvailabilityZonesEnabled": true,
    "associatedWorkspaces": [
      {
        "workspaceId": "942bdefd-e6c9-411c-ac69-70ffad564363",
        "workspaceName": "testWs1",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1",
        "associateDate": "Tue, 07 Jul 2020 07:35:51 GMT"
      },
      {
        "workspaceId": "c7edb8f8-67f7-41f2-bddb-aecf22507e3f",
        "workspaceName": "testWs2",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2",
        "associateDate": "Mon, 13 Jan 2020 16:03:39 GMT"
      }
    ],
    "capacityReservationProperties": {
      "lastSkuUpdate": "Thu, 01 Jan 1970 00:00:00 GMT",
      "minCapacity": 100
    }
  },
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "name": "TestResourceLock",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "eastus"
}

Definiciones

Nombre	Description
AssociatedWorkspace	Lista de áreas de trabajo de Log Analytics asociadas al clúster.
BillingType	Tipo de facturación del clúster.
Capacity	Nivel de reserva de capacidad en Gigabytes para este clúster.
CapacityReservationProperties	Propiedades de reserva de capacidad.
Cluster	Contenedor de recursos de clúster de Log Analytics de nivel superior.
ClusterEntityStatus	Estado de aprovisionamiento del clúster.
ClusterSku	Definición de SKU del clúster.
ClusterSkuNameEnum	SKU (nivel) de un clúster.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
keyVaultProperties	Propiedades del almacén de claves.
ManagedServiceIdentity	Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)
ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
UserAssignedIdentity	Propiedades de identidad asignadas por el usuario

AssociatedWorkspace

Object

Lista de áreas de trabajo de Log Analytics asociadas al clúster.

Nombre	Tipo	Description
associateDate	string	Hora de asociación del área de trabajo.
resourceId	string (arm-id)	Id. de recurso del arm del área de trabajo asociada, en forma de: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string (uuid)	Id. inmutable del área de trabajo asociada.
workspaceName	string	Nombre del recurso del área de trabajo asociada.

BillingType

Enumeración

Tipo de facturación del clúster.

Valor	Description
Cluster
Workspaces

Capacity

Enumeración

Nivel de reserva de capacidad en Gigabytes para este clúster.

Valor	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

CapacityReservationProperties

Object

Propiedades de reserva de capacidad.

Nombre	Tipo	Description
lastSkuUpdate	string	La última vez que se actualizó la SKU.
minCapacity	integer (int64)	Valor de CapacityReservation mínimo en Gigabytes.

Cluster

Object

Contenedor de recursos de clúster de Log Analytics de nivel superior.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	Identidad del recurso.
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.associatedWorkspaces	AssociatedWorkspace[]	Lista de áreas de trabajo de Log Analytics asociadas al clúster
properties.billingType	BillingType	Tipo de facturación del clúster.
properties.capacityReservationProperties	CapacityReservationProperties	Propiedades adicionales para la reserva de capacidad
properties.clusterId	string	Identificador asociado al clúster.
properties.createdDate	string	Hora de creación del clúster
properties.isAvailabilityZonesEnabled	boolean	Establece si el clúster admitirá zonas de disponibilidad. Esto se puede establecer como true solo en las regiones en las que Azure Data Explorer admite Availability Zones. Esta propiedad no se puede modificar después de la creación del clúster. El valor predeterminado es "true" si la región admite Availability Zones.
properties.isDoubleEncryptionEnabled	boolean	Configura si el clúster usará el cifrado doble. Esta propiedad no se puede modificar después de la creación del clúster. El valor predeterminado es "true"
properties.keyVaultProperties	keyVaultProperties	Propiedades de clave asociadas.
properties.lastModifiedDate	string	La última vez que se actualizó el clúster.
properties.provisioningState	ClusterEntityStatus	Estado de aprovisionamiento del clúster.
sku	ClusterSku	Propiedades de SKU.
tags	object	Etiquetas de recursos.
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Enumeración

Estado de aprovisionamiento del clúster.

Valor	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

ClusterSku

Object

Definición de SKU del clúster.

Nombre	Tipo	Description
capacity	Capacity (int64)	Nivel de reserva de capacidad en Gigabytes para este clúster.
name	ClusterSkuNameEnum	SKU (nivel) de un clúster.

ClusterSkuNameEnum

Enumeración

SKU (nivel) de un clúster.

Valor	Description
CapacityReservation

ErrorAdditionalInfo

Object

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

Object

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	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

keyVaultProperties

Object

Propiedades del almacén de claves.

Nombre	Tipo	Description
keyName	string	Nombre de la clave asociada al clúster de Log Analytics.
keyRsaSize	integer (int32)	Tamaño mínimo necesario de clave seleccionado.
keyVaultUri	string	Identificador URI de Key Vault que contiene la clave asociada al clúster de Log Analytics.
keyVersion	string	Versión de la clave asociada al clúster de Log Analytics.

ManagedServiceIdentity

Object

Identidad de servicio administrada (identidades asignadas por el sistema o asignadas por el usuario)

Nombre	Tipo	Description
principalId	string (uuid)	Identificador de entidad de servicio de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
tenantId	string (uuid)	Identificador de inquilino de la identidad asignada por el sistema. Esta propiedad solo se proporcionará para una identidad asignada por el sistema.
type	ManagedServiceIdentityType	Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identidades de User-Assigned Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.

ManagedServiceIdentityType

Enumeración

Tipo de identidad de servicio administrada (donde se permiten los tipos SystemAssigned y UserAssigned).

Valor	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

UserAssignedIdentity

Object

Propiedades de identidad asignadas por el usuario

Nombre	Tipo	Description
clientId	string (uuid)	Identificador de cliente de la identidad asignada.
principalId	string (uuid)	Identificador de entidad de seguridad de la identidad asignada.

Compartir a través de

Clusters - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

ClustersGet

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AssociatedWorkspace

BillingType

Capacity

CapacityReservationProperties

Cluster

ClusterEntityStatus

ClusterSku

ClusterSkuNameEnum

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

keyVaultProperties

ManagedServiceIdentity

ManagedServiceIdentityType

UserAssignedIdentity

Recursos adicionales