POST https://api.ap1.datadoghq.com/api/v1/integration/azure https://api.datadoghq.eu/api/v1/integration/azure https://api.ddog-gov.com/api/v1/integration/azure https://api.datadoghq.com/api/v1/integration/azure https://api.us3.datadoghq.com/api/v1/integration/azure https://api.us5.datadoghq.com/api/v1/integration/azure
Overview
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.
Request Body Data (required) Create a Datadog-Azure integration for your Datadog account request body.
Expand All
Silence monitors for expected Azure VM shutdowns.
Your Azure web application ID.
Your Azure web application secret key.
Errors in your configuration.
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.
Your New Azure web application ID.
Your New Azure Active Directory ID.
Your Azure Active Directory ID.
{
"automute" : true ,
"client_id" : "testc7f6-1234-5678-9101-3fcbf464test" ,
"client_secret" : "testingx./Sw*g/Y33t..R1cH+hScMDt" ,
"errors" : [
"*"
],
"host_filters" : "key:value,filter:example" ,
"new_client_id" : "new1c7f6-1234-5678-9101-3fcbf464test" ,
"new_tenant_name" : "new1c44-1234-5678-9101-cc00736ftest" ,
"tenant_name" : "testc44-1234-5678-9101-cc00736ftest"
}
Response Bad Request
Error response object.
Expand All
Array of errors returned by the API.
Copy
{
"errors" : [
"Bad Request"
]
}
Authentication Error
Error response object.
Expand All
Array of errors returned by the API.
Copy
{
"errors" : [
"Bad Request"
]
}
Too many requests
Error response object.
Expand All
Array of errors returned by the API.
Copy
{
"errors" : [
"Bad Request"
]
}
Code Example
# Curl command curl -X POST "https://api.ap1.datadoghq.com "https://api.datadoghq.eu "https://api.ddog-gov.com "https://api.datadoghq.com "https://api.us3.datadoghq.com "https://api.us5.datadoghq.com /api/v1/integration/azure " \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY} " \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY} " \
-d @- << EOF
{}
EOF
Copy
"""
Create an Azure integration returns "OK" response
"""
from datadog_api_client import ApiClient , Configuration
from datadog_api_client.v1.api.azure_integration_api import AzureIntegrationApi
from datadog_api_client.v1.model.azure_account import AzureAccount
body = AzureAccount (
automute = True ,
client_id = "testc7f6-1234-5678-9101-3fcbf464test" ,
client_secret = "testingx./Sw*g/Y33t..R1cH+hScMDt" ,
errors = [
"*" ,
],
host_filters = "key:value,filter:example" ,
new_client_id = "new1c7f6-1234-5678-9101-3fcbf464test" ,
new_tenant_name = "new1c44-1234-5678-9101-cc00736ftest" ,
tenant_name = "testc44-1234-5678-9101-cc00736ftest" ,
)
configuration = Configuration ()
with ApiClient ( configuration ) as api_client :
api_instance = AzureIntegrationApi ( api_client )
response = api_instance . create_azure_integration ( body = body )
print ( response )
Instructions First install the library and its dependencies and then save the example to example.py
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" python3 "example.py"
Copy
# Create an Azure integration returns "OK" response
require "datadog_api_client"
api_instance = DatadogAPIClient :: V1 :: AzureIntegrationAPI . new
body = DatadogAPIClient :: V1 :: AzureAccount . new ({
automute : true ,
client_id : "testc7f6-1234-5678-9101-3fcbf464test" ,
client_secret : "testingx./Sw*g/Y33t..R1cH+hScMDt" ,
errors : [
"*" ,
] ,
host_filters : "key:value,filter:example" ,
new_client_id : "new1c7f6-1234-5678-9101-3fcbf464test" ,
new_tenant_name : "new1c44-1234-5678-9101-cc00736ftest" ,
tenant_name : "testc44-1234-5678-9101-cc00736ftest" ,
})
p api_instance . create_azure_integration ( body )
Instructions First install the library and its dependencies and then save the example to example.rb
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" rb "example.rb"
Copy
require 'rubygems'
require 'dogapi'
api_key = '<DATADOG_API_KEY>'
app_key = '<DATADOG_APPLICATION_KEY>'
config = {
"tenant_name" : "<AZURE_TENANT_NAME>" ,
"client_id" : "<AZURE_CLIENT_ID>" ,
"client_secret" : "<AZURE_CLIENT_SECRET>" ,
"host_filters" : "<KEY_1>:<VALUE_1>,<KEY_2>:<VALUE_2>"
}
dog = Dogapi :: Client . new ( api_key , app_key )
dog . azure_integration_create ( config )
Instructions First install the library and its dependencies and then save the example to example.rb
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" rb "example.rb"
Copy
// Create an Azure integration returns "OK" response
package main
import (
"context"
"encoding/json"
"fmt"
"os"
"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
"github.com/DataDog/datadog-api-client-go/v2/api/datadogV1"
)
func main () {
body := datadogV1 . AzureAccount {
Automute : datadog . PtrBool ( true ),
ClientId : datadog . PtrString ( "testc7f6-1234-5678-9101-3fcbf464test" ),
ClientSecret : datadog . PtrString ( "testingx./Sw*g/Y33t..R1cH+hScMDt" ),
Errors : [] string {
"*" ,
},
HostFilters : datadog . PtrString ( "key:value,filter:example" ),
NewClientId : datadog . PtrString ( "new1c7f6-1234-5678-9101-3fcbf464test" ),
NewTenantName : datadog . PtrString ( "new1c44-1234-5678-9101-cc00736ftest" ),
TenantName : datadog . PtrString ( "testc44-1234-5678-9101-cc00736ftest" ),
}
ctx := datadog . NewDefaultContext ( context . Background ())
configuration := datadog . NewConfiguration ()
apiClient := datadog . NewAPIClient ( configuration )
api := datadogV1 . NewAzureIntegrationApi ( apiClient )
resp , r , err := api . CreateAzureIntegration ( ctx , body )
if err != nil {
fmt . Fprintf ( os . Stderr , "Error when calling `AzureIntegrationApi.CreateAzureIntegration`: %v\n" , err )
fmt . Fprintf ( os . Stderr , "Full HTTP response: %v\n" , r )
}
responseContent , _ := json . MarshalIndent ( resp , "" , " " )
fmt . Fprintf ( os . Stdout , "Response from `AzureIntegrationApi.CreateAzureIntegration`:\n%s\n" , responseContent )
}
Instructions First install the library and its dependencies and then save the example to main.go
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" go run "main.go"
Copy
// Create an Azure integration returns "OK" response
import com.datadog.api.client.ApiClient ;
import com.datadog.api.client.ApiException ;
import com.datadog.api.client.v1.api.AzureIntegrationApi ;
import com.datadog.api.client.v1.model.AzureAccount ;
import java.util.Collections ;
public class Example {
public static void main ( String [] args ) {
ApiClient defaultClient = ApiClient . getDefaultApiClient ();
AzureIntegrationApi apiInstance = new AzureIntegrationApi ( defaultClient );
AzureAccount body =
new AzureAccount ()
. automute ( true )
. clientId ( "testc7f6-1234-5678-9101-3fcbf464test" )
. clientSecret ( "testingx./Sw*g/Y33t..R1cH+hScMDt" )
. errors ( Collections . singletonList ( "*" ))
. hostFilters ( "key:value,filter:example" )
. newClientId ( "new1c7f6-1234-5678-9101-3fcbf464test" )
. newTenantName ( "new1c44-1234-5678-9101-cc00736ftest" )
. tenantName ( "testc44-1234-5678-9101-cc00736ftest" );
try {
apiInstance . createAzureIntegration ( body );
} catch ( ApiException e ) {
System . err . println ( "Exception when calling AzureIntegrationApi#createAzureIntegration" );
System . err . println ( "Status code: " + e . getCode ());
System . err . println ( "Reason: " + e . getResponseBody ());
System . err . println ( "Response headers: " + e . getResponseHeaders ());
e . printStackTrace ();
}
}
}
Instructions First install the library and its dependencies and then save the example to Example.java
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" java "Example.java"
Copy
from datadog import initialize , api
options = {
'api_key' : '<DATADOG_API_KEY>' ,
'app_key' : '<DATADOG_APPLICATION_KEY>'
}
initialize ( ** options )
api . AzureIntegration . create (
tenant_name = "<AZURE_TENANT_NAME>" ,
host_filters = "<KEY_1>:<VALUE_1>,<KEY_2>:<VALUE_2>" ,
client_id = "<AZURE_CLIENT_ID>" ,
client_secret = "<AZURE_CLIENT_SECRET>"
)
Instructions First install the library and its dependencies and then save the example to example.py
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" python "example.py"
Copy
/**
* Create an Azure integration returns "OK" response
*/
import { client , v1 } from "@datadog/datadog-api-client" ;
const configuration = client . createConfiguration ();
const apiInstance = new v1 . AzureIntegrationApi ( configuration );
const params : v1.AzureIntegrationApiCreateAzureIntegrationRequest = {
body : {
automute : true ,
clientId : "testc7f6-1234-5678-9101-3fcbf464test" ,
clientSecret : "testingx./Sw*g/Y33t..R1cH+hScMDt" ,
errors : [ "*" ],
hostFilters : "key:value,filter:example" ,
newClientId : "new1c7f6-1234-5678-9101-3fcbf464test" ,
newTenantName : "new1c44-1234-5678-9101-cc00736ftest" ,
tenantName : "testc44-1234-5678-9101-cc00736ftest" ,
},
};
apiInstance
. createAzureIntegration ( params )
. then (( data : any ) => {
console . log (
"API called successfully. Returned data: " + JSON . stringify ( data )
);
})
. catch (( error : any ) => console . error ( error ));
Instructions First install the library and its dependencies and then save the example to example.ts
and run following commands:
DD_SITE = "datadoghq.com us3.datadoghq.com us5.datadoghq.com datadoghq.eu ap1.datadoghq.com ddog-gov.com " DD_API_KEY = "<API-KEY>" DD_APP_KEY = "<APP-KEY>" tsc "example.ts"