Microsoft Azure Virtual Machine
The Azure Virtual Machine Input component collects list of virtual machines and their metadata from Azure subscriptions using the Azure Resource Manager API.
Sync Type: Full Synchronisation
Details
The Microsoft Azure Virtual Machine input ingests list of all the virtual machines which belongs to a particular subscription with their metadata from the Azure Resource Manager API.
Requirements
Before setting up the Microsoft Azure Virtual Machine input, you need to:
- Have a Microsoft Account with an active Azure Subscription.
- Register a new Application in App Registrations in Azure Entra ID portal, with a client secret.
- Assign the application the Reader role on the subscription (steps given below).
Required Permissions
The application needs the Reader role on the subscription. The input lists virtual machines across the whole subscription, so assign Reader at subscription scope rather than on a resource group.
Setting up API Access
- Registering a new application
- Open the App Registration page in the Azure Entra ID portal.
- Select New Registration.
- Add a name to the new registration.
- Click Register.
- Save the applications
Application (client) IDandDirectory (tenant) ID. - Select Certificates and Secrets.
- Click link next to Client credentials.
- In "Client secrets" click "New client secret".
- Add a name and expiration to the new secret.
- Save the client secret value.
- Grant the application access to the subscription
- Navigate to Subscriptions.
- Select the active Subscription.
- Click "Access control (IAM)" on the left menu.
- Select "Add Role Assignment" from the "+ Add" menu.
- Select the
Readerrole and click Next. - Click "Select members".
- Search for the new application name and click Select.
- Click "Review + assign".
- Confirm by clicking "Review + assign".
Configuration
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
tenant_id | string | Yes | - | The tenant ID of the Entra ID directory associated with your Azure subscription. |
subscription_id | string | Yes | - | The unique identifier of your Azure subscription, used to manage resources and billing in Azure Cloud. |
cron | string (cron) | Yes | 0 * * * * | Cron string for scheduling the ingest of your input. eg: 0 0 * * * - Daily at midnight, or */15 * * * * - Every 15 minutes. Defaults to an hour. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
Secrets
| Secret | Type | Required | Description |
|---|---|---|---|
client_id | secret | Yes | The client ID of the Entra ID application |
client_secret | secret | Yes | The client secret of the Entra ID application |
Related Articles
Sample Record
Code
Sync frequency
This input runs on a cron schedule (default hourly, 0 * * * *), which you can configure on the pipeline.
See Input Sync Frequency for details.
Community transforms
The Monad Transforms Repository has ready-made transforms for this input. Import one into your organization, then add it to a pipeline after this input.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | Microsoft Azure Virtual Machine to OCSF v1.9.0 |
| ECS v9.5.0 | Microsoft Azure Virtual Machine to ECS v9.5.0 |
| CEF | Microsoft Azure Virtual Machine to CEF |
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.