W3cubDocs

/Ansible

azure_rm_virtualmachineimage_facts - Get virtual machine image facts.

New in version 2.1.

Synopsis

Get facts for virtual machine images.

Requirements (on host that executes module)

  • python >= 2.7
  • azure == 2.0.0rc5

Options

parameter required default choices comments
ad_user
 no
Active Directory username. Use when authenticating with an Active Directory user rather than service principal.
client_id
 no
Azure client ID. Use when authenticating with a Service Principal.
location
 yes
Azure location value (ie. westus, eastus, eastus2, northcentralus, etc.). Supplying only a location value will yield a list of available publishers for the location.
name
 no
Only show results for a specific security group.
offer
 no
Name of an image offering. Combine with sku to see a list of available image versions.
password
 no
Active Directory user password. Use when authenticating with an Active Directory user rather than service principal.
profile
 no
Security profile found in ~/.azure/credentials file.
publisher
 no
Name of an image publisher. List image offerings associated with a particular publisher.
secret
 no
Azure client secret. Use when authenticating with a Service Principal.
sku
 no
Image offering SKU. Combine with offer to see a list of available versions.
subscription_id
 no
Your Azure subscription Id.
tenant
 no
Azure tenant ID. Use when authenticating with a Service Principal.
version
 no
Specific version number of an image.

Examples

- name: Get facts for a specific image
  azure_rm_virtualmachineimage_facts:
    location: eastus
    publisher: OpenLogic
    offer: CentOS
    sku: '7.1'
    version: '7.1.20160308'

- name: List available versions
  azure_rm_virtualmachineimage_facts:
    location: eastus
    publisher: OpenLogic
    offer: CentOS
    sku: '7.1'

- name: List available offers
  azure_rm_virtualmachineimage_facts:
    location: eastus
    publisher: OpenLogic

- name: List available publishers
  azure_rm_virtualmachineimage_facts:
    location: eastus

Return Values

Common return values are documented here Common Return Values, the following are the fields unique to this module:

name description returned type sample
azure_vmimages List of image dicts. always list

Notes

Note

For authentication with Azure you can pass parameters, set environment variables or use a profile stored in ~/.azure/credentials. Authentication is possible using a service principal or Active Directory user. To authenticate via service principal pass subscription_id, client_id, secret and tenant or set set environment variables AZURE_SUBSCRIPTION_ID, AZURE_CLIENT_ID, AZURE_SECRET and AZURE_TENANT.

Note

To Authentication via Active Directory user pass ad_user and password, or set AZURE_AD_USER and AZURE_PASSWORD in the environment.

Note

Alternatively, credentials can be stored in ~/.azure/credentials. This is an ini file containing a [default] section and the following keys: subscription_id, client_id, secret and tenant or subscription_id, ad_user and password. It is also possible to add additional profiles. Specify the profile by passing profile or setting AZURE_PROFILE in the environment.

This is a Core Module

For more information on what this means please read Core Modules

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, developing_test_pr and Developing Modules.

© 2012–2016 Michael DeHaan
© 2016 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/azure_rm_virtualmachineimage_facts_module.html