1. Packages
  2. Azure Native
  3. API Docs
  4. operationalinsights
  5. getCluster
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.3.0 published on Monday, Apr 28, 2025 by Pulumi

azure-native.operationalinsights.getCluster

Explore with Pulumi AI

azure-native logo
This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
Azure Native v3.3.0 published on Monday, Apr 28, 2025 by Pulumi

    Gets a Log Analytics cluster instance.

    Uses Azure REST API version 2023-09-01.

    Other available API versions: 2019-08-01-preview, 2020-03-01-preview, 2020-08-01, 2020-10-01, 2021-06-01, 2022-10-01, 2025-02-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native operationalinsights [ApiVersion]. See the version guide for details.

    Using getCluster

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getCluster(args: GetClusterArgs, opts?: InvokeOptions): Promise<GetClusterResult>
    function getClusterOutput(args: GetClusterOutputArgs, opts?: InvokeOptions): Output<GetClusterResult>
    def get_cluster(cluster_name: Optional[str] = None,
                    resource_group_name: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetClusterResult
    def get_cluster_output(cluster_name: Optional[pulumi.Input[str]] = None,
                    resource_group_name: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetClusterResult]
    func LookupCluster(ctx *Context, args *LookupClusterArgs, opts ...InvokeOption) (*LookupClusterResult, error)
    func LookupClusterOutput(ctx *Context, args *LookupClusterOutputArgs, opts ...InvokeOption) LookupClusterResultOutput

    > Note: This function is named LookupCluster in the Go SDK.

    public static class GetCluster 
    {
        public static Task<GetClusterResult> InvokeAsync(GetClusterArgs args, InvokeOptions? opts = null)
        public static Output<GetClusterResult> Invoke(GetClusterInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetClusterResult> getCluster(GetClusterArgs args, InvokeOptions options)
    public static Output<GetClusterResult> getCluster(GetClusterArgs args, InvokeOptions options)
    
    fn::invoke:
      function: azure-native:operationalinsights:getCluster
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ClusterName string
    Name of the Log Analytics Cluster.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    ClusterName string
    Name of the Log Analytics Cluster.
    ResourceGroupName string
    The name of the resource group. The name is case insensitive.
    clusterName String
    Name of the Log Analytics Cluster.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.
    clusterName string
    Name of the Log Analytics Cluster.
    resourceGroupName string
    The name of the resource group. The name is case insensitive.
    cluster_name str
    Name of the Log Analytics Cluster.
    resource_group_name str
    The name of the resource group. The name is case insensitive.
    clusterName String
    Name of the Log Analytics Cluster.
    resourceGroupName String
    The name of the resource group. The name is case insensitive.

    getCluster Result

    The following output properties are available:

    AzureApiVersion string
    The Azure API version of the resource.
    ClusterId string
    The ID associated with the cluster.
    CreatedDate string
    The cluster creation time
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    LastModifiedDate string
    The last time the cluster was updated.
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    ProvisioningState string
    The provisioning state of the cluster.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    AssociatedWorkspaces List<Pulumi.AzureNative.OperationalInsights.Outputs.AssociatedWorkspaceResponse>
    The list of Log Analytics workspaces associated with the cluster
    BillingType string
    The cluster's billing type.
    CapacityReservationProperties Pulumi.AzureNative.OperationalInsights.Outputs.CapacityReservationPropertiesResponse
    Additional properties for capacity reservation
    Identity Pulumi.AzureNative.OperationalInsights.Outputs.ManagedServiceIdentityResponse
    Resource's identity.
    IsAvailabilityZonesEnabled bool
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    IsDoubleEncryptionEnabled bool
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    KeyVaultProperties Pulumi.AzureNative.OperationalInsights.Outputs.KeyVaultPropertiesResponse
    The associated key properties.
    Sku Pulumi.AzureNative.OperationalInsights.Outputs.ClusterSkuResponse
    The sku properties.
    Tags Dictionary<string, string>
    Resource tags.
    AzureApiVersion string
    The Azure API version of the resource.
    ClusterId string
    The ID associated with the cluster.
    CreatedDate string
    The cluster creation time
    Id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    LastModifiedDate string
    The last time the cluster was updated.
    Location string
    The geo-location where the resource lives
    Name string
    The name of the resource
    ProvisioningState string
    The provisioning state of the cluster.
    Type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    AssociatedWorkspaces []AssociatedWorkspaceResponse
    The list of Log Analytics workspaces associated with the cluster
    BillingType string
    The cluster's billing type.
    CapacityReservationProperties CapacityReservationPropertiesResponse
    Additional properties for capacity reservation
    Identity ManagedServiceIdentityResponse
    Resource's identity.
    IsAvailabilityZonesEnabled bool
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    IsDoubleEncryptionEnabled bool
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    KeyVaultProperties KeyVaultPropertiesResponse
    The associated key properties.
    Sku ClusterSkuResponse
    The sku properties.
    Tags map[string]string
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    clusterId String
    The ID associated with the cluster.
    createdDate String
    The cluster creation time
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    lastModifiedDate String
    The last time the cluster was updated.
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    provisioningState String
    The provisioning state of the cluster.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    associatedWorkspaces List<AssociatedWorkspaceResponse>
    The list of Log Analytics workspaces associated with the cluster
    billingType String
    The cluster's billing type.
    capacityReservationProperties CapacityReservationPropertiesResponse
    Additional properties for capacity reservation
    identity ManagedServiceIdentityResponse
    Resource's identity.
    isAvailabilityZonesEnabled Boolean
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    isDoubleEncryptionEnabled Boolean
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    keyVaultProperties KeyVaultPropertiesResponse
    The associated key properties.
    sku ClusterSkuResponse
    The sku properties.
    tags Map<String,String>
    Resource tags.
    azureApiVersion string
    The Azure API version of the resource.
    clusterId string
    The ID associated with the cluster.
    createdDate string
    The cluster creation time
    id string
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    lastModifiedDate string
    The last time the cluster was updated.
    location string
    The geo-location where the resource lives
    name string
    The name of the resource
    provisioningState string
    The provisioning state of the cluster.
    type string
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    associatedWorkspaces AssociatedWorkspaceResponse[]
    The list of Log Analytics workspaces associated with the cluster
    billingType string
    The cluster's billing type.
    capacityReservationProperties CapacityReservationPropertiesResponse
    Additional properties for capacity reservation
    identity ManagedServiceIdentityResponse
    Resource's identity.
    isAvailabilityZonesEnabled boolean
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    isDoubleEncryptionEnabled boolean
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    keyVaultProperties KeyVaultPropertiesResponse
    The associated key properties.
    sku ClusterSkuResponse
    The sku properties.
    tags {[key: string]: string}
    Resource tags.
    azure_api_version str
    The Azure API version of the resource.
    cluster_id str
    The ID associated with the cluster.
    created_date str
    The cluster creation time
    id str
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    last_modified_date str
    The last time the cluster was updated.
    location str
    The geo-location where the resource lives
    name str
    The name of the resource
    provisioning_state str
    The provisioning state of the cluster.
    type str
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    associated_workspaces Sequence[AssociatedWorkspaceResponse]
    The list of Log Analytics workspaces associated with the cluster
    billing_type str
    The cluster's billing type.
    capacity_reservation_properties CapacityReservationPropertiesResponse
    Additional properties for capacity reservation
    identity ManagedServiceIdentityResponse
    Resource's identity.
    is_availability_zones_enabled bool
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    is_double_encryption_enabled bool
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    key_vault_properties KeyVaultPropertiesResponse
    The associated key properties.
    sku ClusterSkuResponse
    The sku properties.
    tags Mapping[str, str]
    Resource tags.
    azureApiVersion String
    The Azure API version of the resource.
    clusterId String
    The ID associated with the cluster.
    createdDate String
    The cluster creation time
    id String
    Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
    lastModifiedDate String
    The last time the cluster was updated.
    location String
    The geo-location where the resource lives
    name String
    The name of the resource
    provisioningState String
    The provisioning state of the cluster.
    type String
    The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
    associatedWorkspaces List<Property Map>
    The list of Log Analytics workspaces associated with the cluster
    billingType String
    The cluster's billing type.
    capacityReservationProperties Property Map
    Additional properties for capacity reservation
    identity Property Map
    Resource's identity.
    isAvailabilityZonesEnabled Boolean
    Sets whether the cluster will support availability zones. This can be set as true only in regions where Azure Data Explorer support Availability Zones. This Property can not be modified after cluster creation. Default value is 'true' if region supports Availability Zones.
    isDoubleEncryptionEnabled Boolean
    Configures whether cluster will use double encryption. This Property can not be modified after cluster creation. Default value is 'true'
    keyVaultProperties Property Map
    The associated key properties.
    sku Property Map
    The sku properties.
    tags Map<String>
    Resource tags.

    Supporting Types

    AssociatedWorkspaceResponse

    AssociateDate string
    The time of workspace association.
    ResourceId string
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    WorkspaceId string
    Associated workspace immutable id.
    WorkspaceName string
    Associated workspace resource name.
    AssociateDate string
    The time of workspace association.
    ResourceId string
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    WorkspaceId string
    Associated workspace immutable id.
    WorkspaceName string
    Associated workspace resource name.
    associateDate String
    The time of workspace association.
    resourceId String
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    workspaceId String
    Associated workspace immutable id.
    workspaceName String
    Associated workspace resource name.
    associateDate string
    The time of workspace association.
    resourceId string
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    workspaceId string
    Associated workspace immutable id.
    workspaceName string
    Associated workspace resource name.
    associate_date str
    The time of workspace association.
    resource_id str
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    workspace_id str
    Associated workspace immutable id.
    workspace_name str
    Associated workspace resource name.
    associateDate String
    The time of workspace association.
    resourceId String
    Associated workspace arm resource id, in the form of: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
    workspaceId String
    Associated workspace immutable id.
    workspaceName String
    Associated workspace resource name.

    CapacityReservationPropertiesResponse

    LastSkuUpdate string
    The last time Sku was updated.
    MinCapacity double
    Minimum CapacityReservation value in Gigabytes.
    LastSkuUpdate string
    The last time Sku was updated.
    MinCapacity float64
    Minimum CapacityReservation value in Gigabytes.
    lastSkuUpdate String
    The last time Sku was updated.
    minCapacity Double
    Minimum CapacityReservation value in Gigabytes.
    lastSkuUpdate string
    The last time Sku was updated.
    minCapacity number
    Minimum CapacityReservation value in Gigabytes.
    last_sku_update str
    The last time Sku was updated.
    min_capacity float
    Minimum CapacityReservation value in Gigabytes.
    lastSkuUpdate String
    The last time Sku was updated.
    minCapacity Number
    Minimum CapacityReservation value in Gigabytes.

    ClusterSkuResponse

    Capacity double
    The capacity reservation level in Gigabytes for this cluster.
    Name string
    The SKU (tier) of a cluster.
    Capacity float64
    The capacity reservation level in Gigabytes for this cluster.
    Name string
    The SKU (tier) of a cluster.
    capacity Double
    The capacity reservation level in Gigabytes for this cluster.
    name String
    The SKU (tier) of a cluster.
    capacity number
    The capacity reservation level in Gigabytes for this cluster.
    name string
    The SKU (tier) of a cluster.
    capacity float
    The capacity reservation level in Gigabytes for this cluster.
    name str
    The SKU (tier) of a cluster.
    capacity Number
    The capacity reservation level in Gigabytes for this cluster.
    name String
    The SKU (tier) of a cluster.

    KeyVaultPropertiesResponse

    KeyName string
    The name of the key associated with the Log Analytics cluster.
    KeyRsaSize int
    Selected key minimum required size.
    KeyVaultUri string
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    KeyVersion string
    The version of the key associated with the Log Analytics cluster.
    KeyName string
    The name of the key associated with the Log Analytics cluster.
    KeyRsaSize int
    Selected key minimum required size.
    KeyVaultUri string
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    KeyVersion string
    The version of the key associated with the Log Analytics cluster.
    keyName String
    The name of the key associated with the Log Analytics cluster.
    keyRsaSize Integer
    Selected key minimum required size.
    keyVaultUri String
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    keyVersion String
    The version of the key associated with the Log Analytics cluster.
    keyName string
    The name of the key associated with the Log Analytics cluster.
    keyRsaSize number
    Selected key minimum required size.
    keyVaultUri string
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    keyVersion string
    The version of the key associated with the Log Analytics cluster.
    key_name str
    The name of the key associated with the Log Analytics cluster.
    key_rsa_size int
    Selected key minimum required size.
    key_vault_uri str
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    key_version str
    The version of the key associated with the Log Analytics cluster.
    keyName String
    The name of the key associated with the Log Analytics cluster.
    keyRsaSize Number
    Selected key minimum required size.
    keyVaultUri String
    The Key Vault uri which holds they key associated with the Log Analytics cluster.
    keyVersion String
    The version of the key associated with the Log Analytics cluster.

    ManagedServiceIdentityResponse

    PrincipalId string
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    TenantId string
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    Type string
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    UserAssignedIdentities Dictionary<string, Pulumi.AzureNative.OperationalInsights.Inputs.UserAssignedIdentityResponse>
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    PrincipalId string
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    TenantId string
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    Type string
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    UserAssignedIdentities map[string]UserAssignedIdentityResponse
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    principalId String
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    tenantId String
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    type String
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    userAssignedIdentities Map<String,UserAssignedIdentityResponse>
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    principalId string
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    tenantId string
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    type string
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    userAssignedIdentities {[key: string]: UserAssignedIdentityResponse}
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    principal_id str
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    tenant_id str
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    type str
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    user_assigned_identities Mapping[str, UserAssignedIdentityResponse]
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.
    principalId String
    The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.
    tenantId String
    The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.
    type String
    Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).
    userAssignedIdentities Map<Property Map>
    The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.

    UserAssignedIdentityResponse

    ClientId string
    The client ID of the assigned identity.
    PrincipalId string
    The principal ID of the assigned identity.
    ClientId string
    The client ID of the assigned identity.
    PrincipalId string
    The principal ID of the assigned identity.
    clientId String
    The client ID of the assigned identity.
    principalId String
    The principal ID of the assigned identity.
    clientId string
    The client ID of the assigned identity.
    principalId string
    The principal ID of the assigned identity.
    client_id str
    The client ID of the assigned identity.
    principal_id str
    The principal ID of the assigned identity.
    clientId String
    The client ID of the assigned identity.
    principalId String
    The principal ID of the assigned identity.

    Package Details

    Repository
    Azure Native pulumi/pulumi-azure-native
    License
    Apache-2.0
    azure-native logo
    This is the latest version of Azure Native. Use the Azure Native v2 docs if using the v2 version of this package.
    Azure Native v3.3.0 published on Monday, Apr 28, 2025 by Pulumi