hosts

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

Overview

Name	hosts
Type	Resource
Id	azure_isv.connected_vsphere.hosts

Fields

vw_hosts

Name	Datatype	Description
id	text	Gets or sets the Id.
name	text	Gets or sets the name.
cpu_mhz	text	field from the properties object
custom_resource_name	text	field from the properties object
datastore_ids	text	field from the properties object
extended_location	text	field from the properties object
hostName	text	field from the properties object
inventory_item_id	text	field from the properties object
kind	text	Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type; e.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.
location	text	Gets or sets the location.
memory_size_gb	text	field from the properties object
mo_name	text	field from the properties object
mo_ref_id	text	field from the properties object
network_ids	text	field from the properties object
overall_cpu_usage_m_hz	text	field from the properties object
overall_memory_usage_gb	text	field from the properties object
provisioning_state	text	field from the properties object
resourceGroupName	text	field from the properties object
statuses	text	field from the properties object
subscriptionId	text	field from the properties object
system_data	text	field from the properties object
tags	text	Gets or sets the Resource tags.
type	text	Gets or sets the type of the resource.
uuid	text	field from the properties object
v_center_id	text	field from the properties object

hosts

Name	Datatype	Description
id	string	Gets or sets the Id.
name	string	Gets or sets the name.
extendedLocation	object	The extended location.
kind	string	Metadata used by portal/tooling/etc to render different UX experiences for resources of the same type; e.g. ApiApps are a kind of Microsoft.Web/sites type. If supported, the resource provider must validate and persist this value.
location	string	Gets or sets the location.
properties	object	Describes the properties of a Host.
systemData	object	Metadata pertaining to creation and last modification of the resource.
tags	object	Gets or sets the Resource tags.
type	string	Gets or sets the type of the resource.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	hostName, resourceGroupName, subscriptionId	Implements host GET method.
list	SELECT	subscriptionId	List of hosts in a subscription.
list_by_resource_group	SELECT	resourceGroupName, subscriptionId	List of hosts in a resource group.
create	INSERT	hostName, resourceGroupName, subscriptionId, data__location, data__properties	Create Or Update host.
delete	DELETE	hostName, resourceGroupName, subscriptionId	Implements host DELETE method.
update	UPDATE	hostName, resourceGroupName, subscriptionId	API to update certain properties of the host resource.

SELECT examples

List of hosts in a subscription.

vw_hosts

SELECT
id,
name,
cpu_mhz,
custom_resource_name,
datastore_ids,
extended_location,
hostName,
inventory_item_id,
kind,
location,
memory_size_gb,
mo_name,
mo_ref_id,
network_ids,
overall_cpu_usage_m_hz,
overall_memory_usage_gb,
provisioning_state,
resourceGroupName,
statuses,
subscriptionId,
system_data,
tags,
type,
uuid,
v_center_id
FROM azure_isv.connected_vsphere.vw_hosts
WHERE subscriptionId = '{{ subscriptionId }}';

hosts

SELECT
id,
name,
extendedLocation,
kind,
location,
properties,
systemData,
tags,
type
FROM azure_isv.connected_vsphere.hosts
WHERE subscriptionId = '{{ subscriptionId }}';

INSERT example

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

All Properties

/*+ create */
INSERT INTO azure_isv.connected_vsphere.hosts (
hostName,
resourceGroupName,
subscriptionId,
data__location,
data__properties,
properties,
location,
extendedLocation,
systemData,
tags,
kind
)
SELECT 
'{{ hostName }}',
'{{ resourceGroupName }}',
'{{ subscriptionId }}',
'{{ data__location }}',
'{{ data__properties }}',
'{{ properties }}',
'{{ location }}',
'{{ extendedLocation }}',
'{{ systemData }}',
'{{ tags }}',
'{{ kind }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: properties
      value:
        - name: uuid
          value: string
        - name: vCenterId
          value: string
        - name: moRefId
          value: string
        - name: inventoryItemId
          value: string
        - name: moName
          value: string
        - name: statuses
          value:
            - - name: type
                value: string
              - name: status
                value: string
              - name: reason
                value: string
              - name: message
                value: string
              - name: severity
                value: string
              - name: lastUpdatedAt
                value: string
        - name: customResourceName
          value: string
        - name: overallMemoryUsageGB
          value: integer
        - name: memorySizeGB
          value: integer
        - name: overallCpuUsageMHz
          value: integer
        - name: cpuMhz
          value: integer
        - name: datastoreIds
          value:
            - string
        - name: networkIds
          value:
            - string
        - name: provisioningState
          value: []
    - name: location
      value: string
    - name: extendedLocation
      value:
        - name: type
          value: string
        - name: name
          value: string
    - name: systemData
      value:
        - name: createdBy
          value: string
        - name: createdByType
          value: string
        - name: createdAt
          value: string
        - name: lastModifiedBy
          value: string
        - name: lastModifiedByType
          value: string
        - name: lastModifiedAt
          value: string
    - name: tags
      value: object
    - name: name
      value: string
    - name: id
      value: string
    - name: type
      value: string
    - name: kind
      value: string

UPDATE example

Updates a hosts resource.

/*+ update */
UPDATE azure_isv.connected_vsphere.hosts
SET 
tags = '{{ tags }}'
WHERE 
hostName = '{{ hostName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';

DELETE example

Deletes the specified hosts resource.

/*+ delete */
DELETE FROM azure_isv.connected_vsphere.hosts
WHERE hostName = '{{ hostName }}'
AND resourceGroupName = '{{ resourceGroupName }}'
AND subscriptionId = '{{ subscriptionId }}';