---
title: "POST /api/v1/config/azure-metrics-integrations"
method: POST
path: "/api/v1/config/azure-metrics-integrations"
tags: ["AzureMetricsIntegration"]
---

# POST /api/v1/config/azure-metrics-integrations

`POST /api/v1/config/azure-metrics-integrations`

## Request body

- Configv1CreateAzureMetricsIntegrationRequest
  - `azure_metrics_integration` Configv1AzureMetricsIntegration
    - `count_metrics_enabled` boolean — Enables Azure count metrics for the configured resources.
    - `created_at` string, date-time — Timestamp of when the AzureMetricsIntegration was created. Cannot be set by clients.
    - `name` string, required — The name of the AzureMetricsIntegration. You can modify this value after the AzureMetricsIntegration is created.
    - `principal` AzureMetricsIntegrationAzurePrincipal
      - `client_id` string — Specifies the OAuth2 client ID of the managed identity principal.
      - `tenant_id` string — Specifies the ID of the Azure tenant that hosts the managed identity principal.
    - `propagate_tags` boolean — Specifies whether Azure resource, group, and subscription tags should be propagated as metric labels.
    - `scrape_config` AzureMetricsIntegrationAzureScrapeConfig
      - `locations` string[] — Locations to be ingested for this integration (these apply to all subscriptions; use empty for all locations).
      - `resource_types` AzureMetricsIntegrationAzureResourceType[] — Metric groups to be ingested for this integration.
        - `metric_names` string[] — List of metric names to be targeted (these apply to this resource type; use empty for all metrics).
        - `name` string — Name of the resource type.
      - `subscription_ids` string[] — Subscriptions to be targeted for this integration (use empty for all subscriptions).
    - `slug` string — The unique identifier of the AzureMetricsIntegration. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the AzureMetricsIntegration is created.
    - `updated_at` string, date-time — Timestamp of when the AzureMetricsIntegration was last updated. Cannot be set by clients.
    - `usage_metrics_enabled` boolean — Enables collection of azure usage metrics under this principal (Microsoft.Compute, Microsoft.Network, Microsoft.Storage).
  - `dry_run` boolean — If `true`, validates the specified configuration without creating the AzureMetricsIntegration. If the specified configuration is valid, the endpoint returns a partial response without the AzureMetricsIntegration. If the specified configuration is invalid, the endpoint returns an error.

## Response `200`

A successful response containing the created AzureMetricsIntegration.

- Configv1CreateAzureMetricsIntegrationResponse
  - `azure_metrics_integration` Configv1AzureMetricsIntegration
    - `count_metrics_enabled` boolean — Enables Azure count metrics for the configured resources.
    - `created_at` string, date-time — Timestamp of when the AzureMetricsIntegration was created. Cannot be set by clients.
    - `name` string, required — The name of the AzureMetricsIntegration. You can modify this value after the AzureMetricsIntegration is created.
    - `principal` AzureMetricsIntegrationAzurePrincipal
      - `client_id` string — Specifies the OAuth2 client ID of the managed identity principal.
      - `tenant_id` string — Specifies the ID of the Azure tenant that hosts the managed identity principal.
    - `propagate_tags` boolean — Specifies whether Azure resource, group, and subscription tags should be propagated as metric labels.
    - `scrape_config` AzureMetricsIntegrationAzureScrapeConfig
      - `locations` string[] — Locations to be ingested for this integration (these apply to all subscriptions; use empty for all locations).
      - `resource_types` AzureMetricsIntegrationAzureResourceType[] — Metric groups to be ingested for this integration.
        - `metric_names` string[] — List of metric names to be targeted (these apply to this resource type; use empty for all metrics).
        - `name` string — Name of the resource type.
      - `subscription_ids` string[] — Subscriptions to be targeted for this integration (use empty for all subscriptions).
    - `slug` string — The unique identifier of the AzureMetricsIntegration. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the AzureMetricsIntegration is created.
    - `updated_at` string, date-time — Timestamp of when the AzureMetricsIntegration was last updated. Cannot be set by clients.
    - `usage_metrics_enabled` boolean — Enables collection of azure usage metrics under this principal (Microsoft.Compute, Microsoft.Network, Microsoft.Storage).

## Other responses

- `400` — Cannot create the AzureMetricsIntegration because the request is invalid.
- `409` — Cannot create the AzureMetricsIntegration because there is a conflict with an existing AzureMetricsIntegration.
- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/revisions/ee91fd539ced/schema)