vm_instance_guest_agents

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

Overview

Name	vm_instance_guest_agents
Type	Resource
Id	azure_isv.connectedvmware.vm_instance_guest_agents

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
id	string	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}".
name	string	The name of the resource.
credentials	object	Username / Password Credentials to provision guest agent.
customResourceName	string	Gets the name of the corresponding resource in Kubernetes.
httpProxyConfig	object	HTTP Proxy configuration for the VM.
privateLinkScopeResourceId	string	The resource id of the private link scope this machine is assigned to, if any.
provisioningAction	string	Gets or sets the guest agent provisioning action. Known values are: "install", "uninstall", and "repair".
provisioningState	string	Gets the provisioning state. Known values are: "Succeeded", "Failed", "Canceled", "Provisioning", "Updating", "Deleting", "Accepted", and "Created".
status	string	Gets or sets the guest agent status.
statuses	array	The resource status information.
systemData	object	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
uuid	string	Gets or sets a unique identifier for this resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	resource_uri		Gets GuestAgent. Implements GuestAgent GET method.
create	insert	resource_uri		Implements GuestAgent PUT method. Create Or Update GuestAgent.
delete	delete	resource_uri		Deletes an GuestAgent. Implements GuestAgent DELETE method.
list_raw	exec	resource_uri		Implements GET GuestAgent in a vm. Returns the list of GuestAgent of the given vm.

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
resource_uri	string	The fully qualified Azure Resource manager identifier of the Hybrid Compute machine resource to be extended. Required.

SELECT examples

get

Gets GuestAgent. Implements GuestAgent GET method.

SELECT
id,
name,
credentials,
customResourceName,
httpProxyConfig,
privateLinkScopeResourceId,
provisioningAction,
provisioningState,
status,
statuses,
systemData,
type,
uuid
FROM azure_isv.connectedvmware.vm_instance_guest_agents
WHERE resource_uri = '{{ resource_uri }}' -- required
;

INSERT examples

create

Implements GuestAgent PUT method. Create Or Update GuestAgent.

INSERT INTO azure_isv.connectedvmware.vm_instance_guest_agents (
properties,
resource_uri
)
SELECT 
'{{ properties }}',
'{{ resource_uri }}'
RETURNING
id,
name,
properties,
systemData,
type
;

Manifest

# Description fields are for documentation purposes
- name: vm_instance_guest_agents
props:
  - name: resource_uri
    value: "{{ resource_uri }}"
    description: Required parameter for the vm_instance_guest_agents resource.
  - name: properties
    value:
      credentials:
        username: "{{ username }}"
        password: "{{ password }}"
      privateLinkScopeResourceId: "{{ privateLinkScopeResourceId }}"
      httpProxyConfig:
        httpsProxy: "{{ httpsProxy }}"
      provisioningAction: "{{ provisioningAction }}"

DELETE examples

delete

Deletes an GuestAgent. Implements GuestAgent DELETE method.

DELETE FROM azure_isv.connectedvmware.vm_instance_guest_agents
WHERE resource_uri = '{{ resource_uri }}' --required
;

Lifecycle Methods

list_raw

Implements GET GuestAgent in a vm. Returns the list of GuestAgent of the given vm.

EXEC azure_isv.connectedvmware.vm_instance_guest_agents.list_raw 
@resource_uri='{{ resource_uri }}' --required
;