Azure credentials API - POST new credentials

Creates a new Azure credentials configuration.

The body must not provide an ID. The Dynatrace server automatically assigns an ID.

The request consumes and produces an application/json payload.

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Body format

      
  {
  "metadata": {
    "configurationVersions": [
      "integer"
    ],
    "currentConfigurationVersions": [
      "string"
    ],
    "clusterVersion": "1.192.1"
  },
  "id": "string",
  "label": "string",
  "appId": "string",
  "directoryId": "string",
  "key": "string",
  "active": true,
  "autoTagging": true,
  "monitorOnlyTaggedEntities": true,
  "monitorOnlyTagPairs": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "supportingServices": [
    {
      "name": "string",
      "monitoredMetrics": [
        {
          "name": "string",
          "dimensions": [
            "string"
          ]
        }
      ]
    }
  ]
}
      
    

Response

Response codes

Response body

    
{
  "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
  "name": "Dynatrace entity",
  "description": "Dynatrace entity for the REST API example\n"
}
    
  

Validate payload

We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.

The request consumes an application/json payload.

Authentication

To execute this request, you need the Write configuration (WriteConfig) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Response

Response codes

Response body

A successful request doesn't return any content.

Example

In this example, the request creates a new configuration of Azure app-level credentials.

The API token is passed in the Authorization header.

Because the request body is lengthy, it is truncated in this example Curl section. See the full body in the Request body section.

Curl

curl -X POST \
  https://mySampleEnv.live.dynatrace.com/api/config/v1/azure/credentials \
  -H 'Authorization: Api-Token abcdefjhij1234567890' \
  -H 'Content-Type: application/json' \
  -d '{<truncated - see the Request body section >}'

Request URL

https://mySampleEnv.live.dynatrace.com/api/config/v1/azure/credentials

Request body

{
  "label": "Booking application",
  "appId": "c4431dec-34fe-4d4c-ad93-aea38b4f944e",
  "directoryId": "f836b63d-8c92-4ad8-a314-bb1eeka46aa1",
  "key": "fzksjdfsjdfghsrtgbh",
  "active": true,
  "autoTagging": true,
  "monitorOnlyTaggedEntities": true,
  "monitorOnlyTagPairs": [
    {
      "name": "bookingApp",
      "value": "mobile"
    },
    {
      "name": "bookingApp",
      "value": "browser"
    }
  ]
}

Response body

{
    "id": "AZURE_CREDENTIALS-357FDA338DAAF338",
    "name": "Booking application"
}

Response code

201