managed_clusters

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

Overview

Name	managed_clusters
Type	Resource
Id	azure.service_fabric_managed_clusters.managed_clusters

Fields

The following fields are returned by SELECT queries:

get

The operation completed successfully.

Name	Datatype	Description
id	string	Azure resource identifier.
name	string	Azure resource name.
etag	string	Azure resource etag.
location	string	Azure resource location.
properties	object	The managed cluster resource properties
sku	object	The sku of the managed cluster
systemData	object	Metadata pertaining to creation and last modification of the resource.
tags	object	Azure resource tags.
type	string	Azure resource type.

list_by_resource_group

The operation completed successfully.

Name	Datatype	Description
id	string	Azure resource identifier.
name	string	Azure resource name.
etag	string	Azure resource etag.
location	string	Azure resource location.
properties	object	The managed cluster resource properties
sku	object	The sku of the managed cluster
systemData	object	Metadata pertaining to creation and last modification of the resource.
tags	object	Azure resource tags.
type	string	Azure resource type.

list_by_subscription

The operation completed successfully.

Name	Datatype	Description
id	string	Azure resource identifier.
name	string	Azure resource name.
etag	string	Azure resource etag.
location	string	Azure resource location.
properties	object	The managed cluster resource properties
sku	object	The sku of the managed cluster
systemData	object	Metadata pertaining to creation and last modification of the resource.
tags	object	Azure resource tags.
type	string	Azure resource type.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resourceGroupName, clusterName, subscriptionId	api-version	Get a Service Fabric managed cluster resource created or in the process of being created in the specified resource group.
list_by_resource_group	select	resourceGroupName, subscriptionId	api-version	Gets all Service Fabric cluster resources created or in the process of being created in the resource group.
list_by_subscription	select	subscriptionId	api-version	Gets all Service Fabric cluster resources created or in the process of being created in the subscription.
create_or_update	insert	resourceGroupName, clusterName, subscriptionId, data__sku	api-version	Create or update a Service Fabric managed cluster resource with the specified name.
update	update	resourceGroupName, clusterName, subscriptionId	api-version	Update the tags of of a Service Fabric managed cluster resource with the specified name.
delete	delete	resourceGroupName, clusterName, subscriptionId	api-version	Delete a Service Fabric managed cluster resource with the specified name.
apply_maintenance_window	exec	resourceGroupName, clusterName, subscriptionId	api-version	Action to Apply Maintenance window on the Service Fabric Managed Clusters, right now. Any pending update will be applied.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
clusterName	string	The name of the cluster resource.
resourceGroupName	string	The name of the resource group.
subscriptionId	string	The customer subscription identifier.
api-version	string	The version of the Service Fabric resource provider API. This is a required parameter and it's value must be "2024-06-01-preview" for this specification.

SELECT examples

get

Get a Service Fabric managed cluster resource created or in the process of being created in the specified resource group.

SELECT
id,
name,
etag,
location,
properties,
sku,
systemData,
tags,
type
FROM azure.service_fabric_managed_clusters.managed_clusters
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND clusterName = '{{ clusterName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND api-version = '{{ api-version }}'
;

list_by_resource_group

Gets all Service Fabric cluster resources created or in the process of being created in the resource group.

SELECT
id,
name,
etag,
location,
properties,
sku,
systemData,
tags,
type
FROM azure.service_fabric_managed_clusters.managed_clusters
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND api-version = '{{ api-version }}'
;

list_by_subscription

Gets all Service Fabric cluster resources created or in the process of being created in the subscription.

SELECT
id,
name,
etag,
location,
properties,
sku,
systemData,
tags,
type
FROM azure.service_fabric_managed_clusters.managed_clusters
WHERE subscriptionId = '{{ subscriptionId }}' -- required
AND api-version = '{{ api-version }}'
;

INSERT examples

create_or_update

Create or update a Service Fabric managed cluster resource with the specified name.

INSERT INTO azure.service_fabric_managed_clusters.managed_clusters (
data__location,
data__tags,
data__properties,
data__sku,
resourceGroupName,
clusterName,
subscriptionId,
api-version
)
SELECT 
'{{ location }}',
'{{ tags }}',
'{{ properties }}',
'{{ sku }}' /* required */,
'{{ resourceGroupName }}',
'{{ clusterName }}',
'{{ subscriptionId }}',
'{{ api-version }}'
RETURNING
id,
name,
etag,
location,
properties,
sku,
systemData,
tags,
type
;

Manifest

# Description fields are for documentation purposes
- name: managed_clusters
  props:
    - name: resourceGroupName
      value: string
      description: Required parameter for the managed_clusters resource.
    - name: clusterName
      value: string
      description: Required parameter for the managed_clusters resource.
    - name: subscriptionId
      value: string
      description: Required parameter for the managed_clusters resource.
    - name: location
      value: string
      description: |
        Azure resource location.
    - name: tags
      value: object
      description: |
        Azure resource tags.
    - name: properties
      value: object
      description: |
        The managed cluster resource properties
    - name: sku
      value: object
      description: |
        The sku of the managed cluster
    - name: api-version
      value: string
      description: The version of the Service Fabric resource provider API. This is a required parameter and it's value must be "2024-06-01-preview" for this specification.

UPDATE examples

update

Update the tags of of a Service Fabric managed cluster resource with the specified name.

UPDATE azure.service_fabric_managed_clusters.managed_clusters
SET 
data__tags = '{{ tags }}'
WHERE 
resourceGroupName = '{{ resourceGroupName }}' --required
AND clusterName = '{{ clusterName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
AND api-version = '{{ api-version}}'
RETURNING
id,
name,
etag,
location,
properties,
sku,
systemData,
tags,
type;

DELETE examples

delete

Delete a Service Fabric managed cluster resource with the specified name.

DELETE FROM azure.service_fabric_managed_clusters.managed_clusters
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND clusterName = '{{ clusterName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
AND api-version = '{{ api-version }}'
;

Lifecycle Methods

apply_maintenance_window

Action to Apply Maintenance window on the Service Fabric Managed Clusters, right now. Any pending update will be applied.

EXEC azure.service_fabric_managed_clusters.managed_clusters.apply_maintenance_window 
@resourceGroupName='{{ resourceGroupName }}' --required, 
@clusterName='{{ clusterName }}' --required, 
@subscriptionId='{{ subscriptionId }}' --required, 
@api-version='{{ api-version }}'
;