Providers

Providers are infrastructure endpoints registered by service provider instances. Each provider represents a backend system — such as a KubeVirt-enabled Kubernetes cluster — that can host virtual machines or other resources managed through DCM.

Providers are read-only in the CLI. They are created automatically when a service provider instance connects to DCM and registers its available infrastructure.

Listing Providers

Use dcm sp provider list to display all registered providers:

dcm sp provider list

Example output:

ID                                     NAME                  SERVICE TYPE   STATUS       HEALTH    CREATED
3f8a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c  kubevirt-cluster-01   vm             REGISTERED   HEALTHY   2026-01-15T08:30:00Z
a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d  kubevirt-cluster-02   vm             REGISTERED   HEALTHY   2026-02-20T14:45:00Z

Filtering by Service Type

Use the --type flag to show only providers of a specific service type:

dcm sp provider list --type vm

Pagination

For environments with many providers, use pagination flags to control the output:

• --page-size — Maximum number of providers to return per page (int32).
• --page-token — Token for retrieving the next page of results (returned in the previous response).

dcm sp provider list --page-size 10

Getting Provider Details

Use dcm sp provider get to retrieve detailed information about a single provider:

dcm sp provider get 3f8a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c

To view the full details as JSON:

dcm sp provider get 3f8a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c -o json

Example JSON output:

{
  "create_time": "2026-04-15T18:37:45.550963Z",
  "endpoint": "http://kubevirt-service-provider-main:8081/api/v1alpha1/vms",
  "health_status": "ready",
  "status": "registered",
  "id": "9a0d35e0-4ed5-4728-a78e-c6ad61cdaab4",
  "name": "kubevirt-main",
  "schema_version": "v1alpha1",
  "service_type": "vm",
  "update_time": "2026-04-17T12:12:51.214419Z"
}

Provider Status and Health

Each provider exposes two key fields:

• STATUS — Reflects the provider’s registration state within DCM. A status of registered means the provider has been successfully registered and is recognized by the system.
• HEALTH — Reflects the result of the provider’s last health check. A health value of ready indicates that the provider is reachable and operating normally.

These fields are updated automatically as service provider instances report to DCM.

Note: See Register Another Provider for a walkthrough of adding a new provider.