Import cloud resources for a tenant

Creates a single long-running parent job that orchestrates subscription-level import jobs.
The parent job discovers subscriptions, dispatches child import jobs (one per subscription),
aggregates progress, and determines overall success/failure.

Two modes are supported:

  1. Import All: Set importAll: true to discover all subscriptions and import all resources
  2. Selective Import: Provide specific subscriptions and optional resource IDs to import.
    Empty or omitted resources is valid for both Reconcile and Additive.
    Under Reconcile, that empty list is the desired snapshot and existing managed resources on those
    subscriptions are soft-deleted. Under Additive, the subscription is registered or kept and existing
    managed resources are preserved.

Selective imports default to Reconcile: subscriptions omitted from the request are soft-deleted.
Set importMode to Additive to preserve subscriptions and resources omitted from the request.

When importing, CloudSubscription records are automatically created for Azure subscriptions
that don't exist yet in the system. These subscriptions are linked to the tenant and use
the tenant's default credentials.

Path Params
uuid
required

The unique tenant identifier.

Body Params

The import request specifying what to import.

Request model for importing cloud resources at the tenant level.
Supports two modes:

  1. Import ALL resources from ALL subscriptions under the tenant (importAll = true)
  2. Import specific resources grouped by subscription (subscriptions collection).
    A subscription may be listed with no resource IDs:
    • when reconcile, it treats that as an empty snapshot (soft-delete existing managed resources),
    • when additive, it registers or keeps the subscription without wiping inventory.

boolean
Defaults to false

Whether to import ALL resources from ALL subscriptions under the tenant.
When true, the system will:

  1. Discover all Azure subscriptions accessible with tenant credentials
  2. Create CloudSubscription records for any that don't exist
  3. Import all resources (HostPools, Images, etc.) from each subscription
    When false, only resources specified in the Subscriptions collection will be imported.
string
enum

Defines how a resource import treats managed resources omitted from the import request.

Allowed:
subscriptions
array of objects | null

Subscriptions and their resources to import (used when ImportAll is false).
Each item specifies an Azure subscription and the resources to import from it.

subscriptions
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json