R interface to VM instance metadata
Перейти к файлу
Hong Ooi 45683f41b7 Update azure-pipelines.yml for Azure Pipelines 2019-08-06 03:58:15 +10:00
R fixing examples 2019-08-05 14:07:55 +10:00
man rerun document() 2019-08-05 14:16:46 +10:00
.Rbuildignore 1st code commit 2019-08-03 17:35:15 +10:00
.gitignore ignores 2019-08-03 15:54:24 +10:00
CODE_OF_CONDUCT.md Initial commit 2019-08-02 22:20:32 -07:00
CONTRIBUTING.md 1st code commit 2019-08-03 17:35:15 +10:00
DESCRIPTION Update DESCRIPTION 2019-08-05 18:54:05 +10:00
LICENSE license -> license.md for CRAN 2019-08-03 15:52:48 +10:00
LICENSE.md license -> license.md for CRAN 2019-08-03 15:52:48 +10:00
NAMESPACE more updating 2019-08-03 18:48:43 +10:00
README.md link to docs page 2019-08-05 19:05:09 +10:00
azure-pipelines.yml Update azure-pipelines.yml for Azure Pipelines 2019-08-06 03:58:15 +10:00

README.md

AzureVMmetadata

A simple package to access the instance metadata service in an Azure virtual machine.

Accessing metadata

AzureVMmetadata exposes three environments that contain the instance metadata for the VM:

  • instance: The instance metadata, containing 2 components: compute and network
  • attested: The attested metadata, containing the base64-encoded PKCS-7 certificate for the VM
  • events: The scheduled events for the VM

The first two are automatically populated when the package is loaded; you can also manually update them with the update_instance_metadata() and update_attested_metadata() functions. events is not populated at package startup (it causes the event scheduler service to be started on the VM, which can take up to several minutes), but you can update it manually with update_scheduled_events().

## 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, 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

# raw PKCS-7 certificate for the VM
AzureVMmetadata::attested$signature

# certificate as an openssl::cert object
AzureVMmetadata::get_vm_cert()