guest_agents

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

Overview

Name	guest_agents
Type	Resource
Id	azure.scvmm.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}". # pylint: disable=line-too-long
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.
provisioningAction	string	Gets or sets the guest agent provisioning action. Known values are: "install", "uninstall", and "repair".
provisioningState	string	Provisioning state of the resource. Known values are: "Succeeded", "Failed", "Canceled", "Provisioning", "Updating", "Deleting", "Accepted", and "Created".
status	string	Gets the guest agent status.
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 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 a GuestAgent resource. Implements GuestAgent DELETE method.
list_by_virtual_machine_instance	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 resource. Required.

SELECT examples

get

Gets GuestAgent. Implements GuestAgent GET method.

SELECT
id,
name,
credentials,
customResourceName,
httpProxyConfig,
provisioningAction,
provisioningState,
status,
systemData,
type,
uuid
FROM azure.scvmm.guest_agents
WHERE resource_uri = '{{ resource_uri }}' -- required
;

INSERT examples

create

Implements GuestAgent PUT method. Create Or Update GuestAgent.

INSERT INTO azure.scvmm.guest_agents (
properties,
resource_uri
)
SELECT 
'{{ properties }}',
'{{ resource_uri }}'
RETURNING
id,
name,
properties,
systemData,
type
;

Manifest

# Description fields are for documentation purposes
- name: guest_agents
props:
  - name: resource_uri
    value: "{{ resource_uri }}"
    description: Required parameter for the guest_agents resource.
  - name: properties
    description: |
      The resource-specific properties for this resource.
    value:
      uuid: "{{ uuid }}"
      credentials:
        username: "{{ username }}"
        password: "{{ password }}"
      httpProxyConfig:
        httpsProxy: "{{ httpsProxy }}"
      provisioningAction: "{{ provisioningAction }}"
      status: "{{ status }}"
      customResourceName: "{{ customResourceName }}"
      provisioningState: "{{ provisioningState }}"

DELETE examples

delete

Deletes a GuestAgent resource. Implements GuestAgent DELETE method.

DELETE FROM azure.scvmm.guest_agents
WHERE resource_uri = '{{ resource_uri }}' --required
;

Lifecycle Methods

list_by_virtual_machine_instance

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

EXEC azure.scvmm.guest_agents.list_by_virtual_machine_instance 
@resource_uri='{{ resource_uri }}' --required
;