virtual_machine_extensions

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

Overview

Name	virtual_machine_extensions
Type	Resource
Id	azure.compute.virtual_machine_extensions

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Resource Id
name	string	Resource name
location	string	Resource location
properties	object	Describes the properties of a Virtual Machine Extension.
tags	object	Resource tags
type	string	Resource type

list

Name	Datatype	Description
id	string	Resource Id
name	string	Resource name
location	string	Resource location
properties	object	Describes the properties of a Virtual Machine Extension.
tags	object	Resource tags
type	string	Resource type

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resourceGroupName, vmName, vmExtensionName, subscriptionId	$expand	The operation to get the extension.
list	select	resourceGroupName, vmName, subscriptionId	$expand	The operation to get all extensions of a Virtual Machine.
create_or_update	insert	resourceGroupName, vmName, vmExtensionName, subscriptionId		The operation to create or update the extension.
update	update	resourceGroupName, vmName, vmExtensionName, subscriptionId		The operation to update the extension.
delete	delete	resourceGroupName, vmName, vmExtensionName, subscriptionId		The operation to delete the extension.

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
resourceGroupName	string	The name of the resource group.
subscriptionId	string	Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.
vmExtensionName	string	The name of the virtual machine extension.
vmName	string	The name of the virtual machine where the extension should be deleted.
$expand	string	The expand expression to apply on the operation.

SELECT examples

get

The operation to get the extension.

SELECT
id,
name,
location,
properties,
tags,
type
FROM azure.compute.virtual_machine_extensions
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND vmName = '{{ vmName }}' -- required
AND vmExtensionName = '{{ vmExtensionName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND $expand = '{{ $expand }}'
;

list

The operation to get all extensions of a Virtual Machine.

SELECT
id,
name,
location,
properties,
tags,
type
FROM azure.compute.virtual_machine_extensions
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND vmName = '{{ vmName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND $expand = '{{ $expand }}'
;

INSERT examples

create_or_update

The operation to create or update the extension.

INSERT INTO azure.compute.virtual_machine_extensions (
data__properties,
data__location,
data__tags,
resourceGroupName,
vmName,
vmExtensionName,
subscriptionId
)
SELECT 
'{{ properties }}',
'{{ location }}',
'{{ tags }}',
'{{ resourceGroupName }}',
'{{ vmName }}',
'{{ vmExtensionName }}',
'{{ subscriptionId }}'
RETURNING
id,
name,
location,
properties,
tags,
type
;

Manifest

# Description fields are for documentation purposes
- name: virtual_machine_extensions
  props:
    - name: resourceGroupName
      value: string
      description: Required parameter for the virtual_machine_extensions resource.
    - name: vmName
      value: string
      description: Required parameter for the virtual_machine_extensions resource.
    - name: vmExtensionName
      value: string
      description: Required parameter for the virtual_machine_extensions resource.
    - name: subscriptionId
      value: string
      description: Required parameter for the virtual_machine_extensions resource.
    - name: properties
      value: object
      description: |
        Describes the properties of a Virtual Machine Extension.
    - name: location
      value: string
      description: |
        Resource location
    - name: tags
      value: object
      description: |
        Resource tags

UPDATE examples

update

The operation to update the extension.

UPDATE azure.compute.virtual_machine_extensions
SET 
data__properties = '{{ properties }}',
data__tags = '{{ tags }}'
WHERE 
resourceGroupName = '{{ resourceGroupName }}' --required
AND vmName = '{{ vmName }}' --required
AND vmExtensionName = '{{ vmExtensionName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
RETURNING
id,
name,
location,
properties,
tags,
type;

DELETE examples

delete

The operation to delete the extension.

DELETE FROM azure.compute.virtual_machine_extensions
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND vmName = '{{ vmName }}' --required
AND vmExtensionName = '{{ vmExtensionName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
;