v1

latestOpenAPI 3.0.02026-07-142351,1971.3 MB

Azure Integration

Update an Azure integration

Update a Datadog-Azure integration. Requires an existing tenant_name and client_id. Any other fields supplied will overwrite existing values. To overwrite tenant_name or client_id, use new_tenant_name and new_client_id. To leave a field unchanged, do not supply that field in the payload.

put/api/v1/integration/azure

Request body

app_service_plan_filtersstring

Limit the Azure app service plans that are pulled into Datadog using tags. Only app service plans that match one of the defined tags are imported into Datadog.

automuteboolean

Silence monitors for expected Azure VM shutdowns.

client_idstring

Your Azure web application ID.

client_secretstring

Your Azure web application secret key.

container_app_filtersstring

Limit the Azure container apps that are pulled into Datadog using tags. Only container apps that match one of the defined tags are imported into Datadog.

cspm_enabledboolean

When enabled, Datadog’s Cloud Security Management product scans resource configurations monitored by this app registration. Note: This requires resource_collection_enabled to be set to true.

custom_metrics_enabledboolean

Enable custom metrics for your organization.

errorsstring[]

Errors in your configuration.

host_filtersstring

Limit the Azure instances that are pulled into Datadog by using tags. Only hosts that match one of the defined tags are imported into Datadog.

metrics_enabledboolean

Enable Azure metrics for your organization.

metrics_enabled_defaultboolean

Enable Azure metrics for your organization for resource providers where no resource provider config is specified.

new_client_idstring

Your New Azure web application ID.

new_tenant_namestring

Your New Azure Active Directory ID.

resource_collection_enabledboolean

When enabled, Datadog collects metadata and configuration info from cloud resources (compute instances, databases, load balancers, etc.) monitored by this app registration.

secretless_auth_enabledboolean

(Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.

tenant_namestring

Your Azure Active Directory ID.

usage_metrics_enabledboolean

Enable azure.usage metrics for your organization.

Example request

{
  "app_service_plan_filters": "key:value,filter:example",
  "automute": true,
  "client_id": "testc7f6-1234-5678-9101-3fcbf464test",
  "client_secret": "TestingRh2nx664kUy5dIApvM54T4AtO",
  "container_app_filters": "key:value,filter:example",
  "cspm_enabled": true,
  "custom_metrics_enabled": true,
  "errors": [
    "*"
  ],
  "host_filters": "key:value,filter:example",
  "metrics_enabled": true,
  "metrics_enabled_default": true,
  "new_client_id": "new1c7f6-1234-5678-9101-3fcbf464test",
  "new_tenant_name": "new1c44-1234-5678-9101-cc00736ftest",
  "resource_collection_enabled": true,
  "resource_provider_configs": [
    {
      "metrics_enabled": true,
      "namespace": "Microsoft.Compute"
    }
  ],
  "secretless_auth_enabled": true,
  "tenant_name": "testc44-1234-5678-9101-cc00736ftest",
  "usage_metrics_enabled": true
}

Response

object required

Example response

{}