azure_accounts

Creates, updates, deletes, gets or lists an azure_accounts resource.

Overview

Name	`azure_accounts`
Type	Resource
Id	`datadog.integrations.azure_accounts`

Fields

The following fields are returned by SELECT queries:

list_azure_integration

Name	Datatype	Description
`client_id`	`string`	Your Azure web application ID. (example: testc7f6-1234-5678-9101-3fcbf464test)
`new_client_id`	`string`	Your New Azure web application ID. (example: new1c7f6-1234-5678-9101-3fcbf464test)
`new_tenant_name`	`string`	Your New Azure Active Directory ID. (example: new1c44-1234-5678-9101-cc00736ftest)
`tenant_name`	`string`	Your Azure Active Directory ID. (example: testc44-1234-5678-9101-cc00736ftest)
`app_service_plan_filters`	`string`	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. (example: key:value,filter:example)
`automute`	`boolean`	Silence monitors for expected Azure VM shutdowns.
`client_secret`	`string`	Your Azure web application secret key. (example: TestingRh2nx664kUy5dIApvM54T4AtO)
`container_app_filters`	`string`	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. (example: key:value,filter:example)
`cspm_enabled`	`boolean`	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_enabled`	`boolean`	Enable custom metrics for your organization.
`errors`	`array`	Errors in your configuration.
`host_filters`	`string`	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. (example: key:value,filter:example)
`metrics_enabled`	`boolean`	Enable Azure metrics for your organization.
`metrics_enabled_default`	`boolean`	Enable Azure metrics for your organization for resource providers where no resource provider config is specified.
`resource_collection_enabled`	`boolean`	When enabled, Datadog collects metadata and configuration info from cloud resources (compute instances, databases, load balancers, etc.) monitored by this app registration.
`resource_provider_configs`	`array`	Configuration settings applied to resources from the specified Azure resource providers.
`secretless_auth_enabled`	`boolean`	(Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.
`usage_metrics_enabled`	`boolean`	Enable azure.usage metrics for your organization.

Methods

The following methods are available for this resource:

Name	Accessible by	Description
`list_azure_integration`	`select`	List all Datadog-Azure integrations configured in your Datadog account.
`create_azure_integration`	`insert`	Create a Datadog-Azure integration.<br /><br />Using the `POST` method updates your integration configuration by adding your new<br />configuration to the existing one in your Datadog organization.<br /><br />Using the `PUT` method updates your integration configuration by replacing your<br />current configuration with the new one sent to your Datadog organization.
`update_azure_integration`	`replace`	Update a Datadog-Azure integration. Requires an existing `tenant_name` and `client_id`.<br />Any other fields supplied will overwrite existing values. To overwrite `tenant_name` or `client_id`,<br />use `new_tenant_name` and `new_client_id`. To leave a field unchanged, do not supply that field in the payload.
`delete_azure_integration`	`delete`	Delete a given Datadog-Azure integration from your Datadog account.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
`site`	`string`	The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both.

`SELECT` examples

list_azure_integration

List all Datadog-Azure integrations configured in your Datadog account.

SELECT
client_id,
new_client_id,
new_tenant_name,
tenant_name,
app_service_plan_filters,
automute,
client_secret,
container_app_filters,
cspm_enabled,
custom_metrics_enabled,
errors,
host_filters,
metrics_enabled,
metrics_enabled_default,
resource_collection_enabled,
resource_provider_configs,
secretless_auth_enabled,
usage_metrics_enabled
FROM datadog.integrations.azure_accounts
;

`INSERT` examples

create_azure_integration
Manifest

Create a Datadog-Azure integration. Using the POST method updates your integration configuration by adding your new configuration to the existing one in your Datadog organization. Using the PUT method updates your integration configuration by replacing your current configuration with the new one sent to your Datadog organization.

INSERT INTO datadog.integrations.azure_accounts (
app_service_plan_filters,
automute,
client_id,
client_secret,
container_app_filters,
cspm_enabled,
custom_metrics_enabled,
errors,
host_filters,
metrics_enabled,
metrics_enabled_default,
new_client_id,
new_tenant_name,
resource_collection_enabled,
resource_provider_configs,
secretless_auth_enabled,
tenant_name,
usage_metrics_enabled
)
SELECT 
'{{ app_service_plan_filters }}',
{{ automute }},
'{{ client_id }}',
'{{ client_secret }}',
'{{ container_app_filters }}',
{{ cspm_enabled }},
{{ custom_metrics_enabled }},
'{{ errors }}',
'{{ host_filters }}',
{{ metrics_enabled }},
{{ metrics_enabled_default }},
'{{ new_client_id }}',
'{{ new_tenant_name }}',
{{ resource_collection_enabled }},
'{{ resource_provider_configs }}',
{{ secretless_auth_enabled }},
'{{ tenant_name }}',
{{ usage_metrics_enabled }}
;

# Description fields are for documentation purposes
- name: azure_accounts
props:
  - name: app_service_plan_filters
    value: "{{ app_service_plan_filters }}"
    description: |
      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.
  - name: automute
    value: {{ automute }}
    description: |
      Silence monitors for expected Azure VM shutdowns.
  - name: client_id
    value: "{{ client_id }}"
    description: |
      Your Azure web application ID.
  - name: client_secret
    value: "{{ client_secret }}"
    description: |
      Your Azure web application secret key.
  - name: container_app_filters
    value: "{{ container_app_filters }}"
    description: |
      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.
  - name: cspm_enabled
    value: {{ cspm_enabled }}
    description: |
      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.
  - name: custom_metrics_enabled
    value: {{ custom_metrics_enabled }}
    description: |
      Enable custom metrics for your organization.
  - name: errors
    value:
      - "{{ errors }}"
    description: |
      Errors in your configuration.
  - name: host_filters
    value: "{{ host_filters }}"
    description: |
      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.
  - name: metrics_enabled
    value: {{ metrics_enabled }}
    description: |
      Enable Azure metrics for your organization.
  - name: metrics_enabled_default
    value: {{ metrics_enabled_default }}
    description: |
      Enable Azure metrics for your organization for resource providers where no resource provider config is specified.
  - name: new_client_id
    value: "{{ new_client_id }}"
    description: |
      Your New Azure web application ID.
  - name: new_tenant_name
    value: "{{ new_tenant_name }}"
    description: |
      Your New Azure Active Directory ID.
  - name: resource_collection_enabled
    value: {{ resource_collection_enabled }}
    description: |
      When enabled, Datadog collects metadata and configuration info from cloud resources (compute instances, databases, load balancers, etc.) monitored by this app registration.
  - name: resource_provider_configs
    description: |
      Configuration settings applied to resources from the specified Azure resource providers.
    value:
      - metrics_enabled: {{ metrics_enabled }}
        namespace: "{{ namespace }}"
  - name: secretless_auth_enabled
    value: {{ secretless_auth_enabled }}
    description: |
      (Preview) When enabled, Datadog authenticates with this app registration using federated workload identity credentials instead of a client secret.
  - name: tenant_name
    value: "{{ tenant_name }}"
    description: |
      Your Azure Active Directory ID.
  - name: usage_metrics_enabled
    value: {{ usage_metrics_enabled }}
    description: |
      Enable azure.usage metrics for your organization.

`REPLACE` examples

update_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.

REPLACE datadog.integrations.azure_accounts
SET 
app_service_plan_filters = '{{ app_service_plan_filters }}',
automute = {{ automute }},
client_id = '{{ client_id }}',
client_secret = '{{ client_secret }}',
container_app_filters = '{{ container_app_filters }}',
cspm_enabled = {{ cspm_enabled }},
custom_metrics_enabled = {{ custom_metrics_enabled }},
errors = '{{ errors }}',
host_filters = '{{ host_filters }}',
metrics_enabled = {{ metrics_enabled }},
metrics_enabled_default = {{ metrics_enabled_default }},
new_client_id = '{{ new_client_id }}',
new_tenant_name = '{{ new_tenant_name }}',
resource_collection_enabled = {{ resource_collection_enabled }},
resource_provider_configs = '{{ resource_provider_configs }}',
secretless_auth_enabled = {{ secretless_auth_enabled }},
tenant_name = '{{ tenant_name }}',
usage_metrics_enabled = {{ usage_metrics_enabled }};

`DELETE` examples

delete_azure_integration

Delete a given Datadog-Azure integration from your Datadog account.

DELETE FROM datadog.integrations.azure_accounts
;

Overview​

Fields​

Methods​

Parameters​

SELECT examples​

INSERT examples​

REPLACE examples​

DELETE examples​