Settings API - Connections to GCP environments schema table

Published Apr 27, 2026

Connections to GCP environments (`builtin:hyperscaler-authentication.connections.gcp)`

Connections to GCP for Dynatrace integrations

Schema ID	Schema groups	Scope
`builtin:hyperscaler-authentication.connections.gcp`	-	`environment`

Retrieve schema via Settings API


GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.gcp`
GET	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.gcp`
GET	Environment ActiveGate	`https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:hyperscaler-authentication.connections.gcp`

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	GCP Authentication mechanism to be used by the connection The element has these enums `serviceAccountImpersonation`	Required
`serviceAccountImpersonation`	ServiceAccountImpersonation	-	Required

The `ServiceAccountImpersonation` object

Property	Type	Description	Required
Service Account Id `serviceAccountId`	text	Id of your Service Account	Optional
Consumers `consumers`	ConsumersOfServiceAccountImpersonation[]	Dynatrace integrations that can use this connection The element has these enums `SVC:com.dynatrace.da` `SVC:com.dynatrace.openpipeline` `SVC:com.dynatrace.bo`	Required