Settings API - Connections to Azure environments schema table

  • Published Sep 25, 2025

Connections to Azure environments (builtin:hyperscaler-authentication.connections.azure)

Connections to Azure for Dynatrace integrations

Schema IDSchema groupsScope
builtin:hyperscaler-authentication.connections.azure-
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.azure
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.azure
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.azure

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Name
name		text

The name of the connection

Required
Connection Type
type		enum

Azure Authentication mechanism to be used by the connection

The element has these enums
  • clientSecret
  • federatedIdentityCredential
Required
clientSecretClientSecretConfig-Required
federatedIdentityCredentialFederatedIdentityCredential-Required
The ClientSecretConfig object
PropertyTypeDescriptionRequired
Directory (tenant) ID
directoryId		text

Directory (tenant) ID of Microsoft Entra ID

Required
Application (client) ID
applicationId		text

Application (client) ID of your app registered in Microsoft Azure App registrations

Required
Client secret
clientSecret		secret

Client secret of your app registered in Microsoft Azure App registrations

Required
Consumers
consumers		ConsumersOfClientSecret[]

Dynatrace integrations that can use this connection

The element has these enums
  • DA
  • SVC:com.dynatrace.da
  • NONE
Required
The FederatedIdentityCredential object
PropertyTypeDescriptionRequired
Directory (tenant) ID
directoryId		text

Directory (tenant) ID of Microsoft Entra ID

Optional
Application (client) ID
applicationId		text

Application (client) ID of your app registered in Microsoft Azure App registrations

Optional
Consumers
consumers		ConsumersOfFederatedIdentityCredential[]

Consumers that can use the connection

The element has these enums
  • DA
  • SVC:com.dynatrace.da
  • APP:dynatrace.microsoft.azure.connector
  • SVC:com.dynatrace.openpipeline
  • NONE
Required