Skip to main content

clusters

Creates, updates, deletes, gets or lists a clusters resource.

Overview

Nameclusters
TypeResource
Idazure.stream_analytics.clusters

Fields

NameDatatypeDescription
capacity_allocatedtextfield from the properties object
capacity_assignedtextfield from the properties object
clusterNametextfield from the properties object
cluster_idtextfield from the properties object
created_datetextfield from the properties object
etagtextThe current entity tag for the cluster. This is an opaque string. You can use it to detect whether the resource has changed between requests. You can also use it in the If-Match or If-None-Match headers for write operations for optimistic concurrency.
locationtextThe geo-location where the resource lives
provisioning_statetextfield from the properties object
resourceGroupNametextfield from the properties object
skutextThe SKU of the cluster. This determines the size/capacity of the cluster. Required on PUT (CreateOrUpdate) requests.
subscriptionIdtextfield from the properties object
tagstextResource tags.

Methods

NameAccessible byRequired ParamsDescription
getSELECTclusterName, resourceGroupName, subscriptionIdGets information about the specified cluster.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdLists all of the clusters in the given resource group.
list_by_subscriptionSELECTsubscriptionIdLists all of the clusters in the given subscription.
create_or_updateINSERTclusterName, resourceGroupName, subscriptionIdCreates a Stream Analytics Cluster or replaces an already existing cluster.
deleteDELETEclusterName, resourceGroupName, subscriptionIdDeletes the specified cluster.
updateUPDATEclusterName, resourceGroupName, subscriptionIdUpdates an existing cluster. This can be used to partially update (ie. update one or two properties) a cluster without affecting the rest of the cluster definition.

SELECT examples

Lists all of the clusters in the given subscription.

SELECT
capacity_allocated,
capacity_assigned,
clusterName,
cluster_id,
created_date,
etag,
location,
provisioning_state,
resourceGroupName,
sku,
subscriptionId,
tags
FROM azure.stream_analytics.vw_clusters
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

Use the following StackQL query and manifest file to create a new clusters resource.

/*+ create */
INSERT INTO azure.stream_analytics.clusters (
clusterName,
resourceGroupName,
subscriptionId,
tags,
location,
sku,
properties
)
SELECT
'{{ clusterName }}',
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ tags }}',
'{{ location }}',
'{{ sku }}',
'{{ properties }}'
;

UPDATE example

Updates a clusters resource.

/*+ update */
UPDATE azure.stream_analytics.clusters
SET
tags = '{{ tags }}',
location = '{{ location }}',
sku = '{{ sku }}',
properties = '{{ properties }}'
WHERE
clusterName = '{{ clusterName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified clusters resource.

/*+ delete */
DELETE FROM azure.stream_analytics.clusters
WHERE clusterName = '{{ clusterName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';