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 ID	Schema groups	Scope
`builtin:hyperscaler-authentication.connections.azure`	-	`environment`

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.azure`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.azure`
	Environment ActiveGate	`https://{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

Property	Type	Description	Required
Name `name`	text	The name of the connection	required
Connection Type `type`	enum	Azure Authentication mechanism to be used by the connection `clientSecret` `federatedIdentityCredential`	required
`clientSecret`	ClientSecretConfig	-	required
`federatedIdentityCredential`	FederatedIdentityCredential	-	required

The `ClientSecretConfig` object

Property	Type	Description	Required
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 `DA` `SVC:com.dynatrace.da` `NONE`	required

The `FederatedIdentityCredential` object

Property	Type	Description	Required
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 `DA` `SVC:com.dynatrace.da` `NONE`	required