instance {AzureVMmetadata}

Metadata for an Azure VM

Description

Metadata for an Azure VM

Usage

instance

attested

events

update_instance_metadata()

update_attested_metadata(nonce = NULL)

update_scheduled_events()

Arguments

nonce

For update_attested_metadata, an optional string to use as a nonce.

Format

instance, attested and events are environments.

Details

The instance, attested and events environments contain the instance metadata, attested metadata, and scheduled events respectively for a VM running in Azure. instance and attested are automatically populated when you load the AzureVMmetadata package, or you can manually populate them yourself with the update_instance_metadata and update_attested_metadata functions. events is not populated at package startup, because calling the scheduled event service can require up to several minutes if it is not running already. You can manually populate it with the update_scheduled_events function.

If AzureVMmetadata is loaded in an R session that is not running in an Azure VM, all the metadata environments will be empty.

Value

The updating functions return the contents of their respective environments as lists, invisibly.

See Also

in_azure_vm

Instance metadata service documentation

To obtain OAuth tokens from the metadata service, see AzureAuth::get_managed_token

Examples

## these will only be meaningful when run in an Azure VM

# all compute metadata
AzureVMmetadata::instance$compute

# VM name and ID
AzureVMmetadata::instance$compute$name
AzureVMmetadata::instance$compute$vmId

# VM resource details: subscription, resource group, resource ID
AzureVMmetadata::instance$compute$subscriptionId
AzureVMmetadata::instance$compute$resourceGroupName
AzureVMmetadata::instance$compute$resourceId

# all network metadata
AzureVMmetadata::instance$network

# IPv4 address details (1st network interface)
AzureVMmetadata::instance$network$interface[[1]]$ipv4