Skip to main content

dedicated_host_groups

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

Overview

Namededicated_host_groups
TypeResource
Idazure.compute.dedicated_host_groups

Fields

NameDatatypeDescription
idtextResource Id
nametextResource name
additional_capabilitiestextfield from the properties object
hostGroupNametextfield from the properties object
hoststextfield from the properties object
instance_viewtextfield from the properties object
locationtextResource location
platform_fault_domain_counttextfield from the properties object
resourceGroupNametextfield from the properties object
subscriptionIdtextfield from the properties object
support_automatic_placementtextfield from the properties object
tagstextResource tags
typetextResource type
zonestextAvailability Zone to use for this host group. Only single zone is supported. The zone can be assigned only during creation. If not provided, the group supports all zones in the region. If provided, enforces each host in the group to be in the same zone.

Methods

NameAccessible byRequired ParamsDescription
getSELECThostGroupName, resourceGroupName, subscriptionIdRetrieves information about a dedicated host group.
list_by_resource_groupSELECTresourceGroupName, subscriptionIdLists all of the dedicated host groups in the specified resource group. Use the nextLink property in the response to get the next page of dedicated host groups.
list_by_subscriptionSELECTsubscriptionIdLists all of the dedicated host groups in the subscription. Use the nextLink property in the response to get the next page of dedicated host groups.
create_or_updateINSERThostGroupName, resourceGroupName, subscriptionIdCreate or update a dedicated host group. For details of Dedicated Host and Dedicated Host Groups please see [Dedicated Host Documentation] (https://go.microsoft.com/fwlink/?linkid=2082596)
deleteDELETEhostGroupName, resourceGroupName, subscriptionIdDelete a dedicated host group.
updateUPDATEhostGroupName, resourceGroupName, subscriptionIdUpdate an dedicated host group.

SELECT examples

Lists all of the dedicated host groups in the subscription. Use the nextLink property in the response to get the next page of dedicated host groups.

SELECT
id,
name,
additional_capabilities,
hostGroupName,
hosts,
instance_view,
location,
platform_fault_domain_count,
resourceGroupName,
subscriptionId,
support_automatic_placement,
tags,
type,
zones
FROM azure.compute.vw_dedicated_host_groups
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

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

/*+ create */
INSERT INTO azure.compute.dedicated_host_groups (
hostGroupName,
resourceGroupName,
subscriptionId,
properties,
zones,
location,
tags
)
SELECT
'{{ hostGroupName }}',
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ properties }}',
'{{ zones }}',
'{{ location }}',
'{{ tags }}'
;

UPDATE example

Updates a dedicated_host_groups resource.

/*+ update */
UPDATE azure.compute.dedicated_host_groups
SET
properties = '{{ properties }}',
zones = '{{ zones }}',
tags = '{{ tags }}'
WHERE
hostGroupName = '{{ hostGroupName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified dedicated_host_groups resource.

/*+ delete */
DELETE FROM azure.compute.dedicated_host_groups
WHERE hostGroupName = '{{ hostGroupName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';