View Untagged Virtual Machines

This task reports on untagged virtual machines for a chosen subscription.

You can run this task interactively, from a schedule, or via an API call to PPA.

It requires credentials for an Azure service principal with the correct permissions.

If you choose to create a new issue in Jira for the untagged instances, it requires Jira access credentials.

Integrations

Required PPA Configuration

If you run start this task from a schedule or API call, a new issue will be created in Jira with details of the untagged instances.

When started interactively the user will have the choice to create a new issue in Jira.

Required Vault Details

Azure

  • Tenant ID
  • Client ID
  • Client Secret
  • Subscription ID

The service principal must have permissions to read virtual machine details.

Jira
(optional)

  • Host
  • Username
  • API key

PPA will add these to the Vault for you when you first run the task (see Vault Config Wizard for more).

API/Schedule Payload

To run this task from a schedule or API call, you'll need to supply a Jira project name and Jira user name in the task payload.

The payload should be in this format:

{ "jira_project_name": "your_project_name", "jira_user_name": "your_user_name" }

You can use the example payload above as a template.

What the Task Does

Interactive

When run interactively this task will:

  • Find all untagged virtual machines
  • Display them in a table
  • Ask the user whether to create a new Jira issue
  • Ask the user to provide a Jira project name and Jira user to assign the issue to

Schedule/API

When started from a schedule or API call, this task will:

  • Find all untagged virtual machines
  • Display them in a table
  • Create an issue in Jira with details of the untagged VMs (using Jira project details provided in the payload)
View playbook on Github
Product Boot Screen

Get PPA for free!

Start automating your estate with a free 30 day trial today. No signup required!

Get PPA Express

Documentation


Theale Court
11-13 High Street, Theale
Reading, Berkshire, RG7 5AH
United Kingdom
+44 (0) 118 324 2444

Logo

Copyright 2020 Osirium Ltd.