Extensions API - GET available hosts
Lists all available hosts that run the specified technology.
The request produces an application/json payload.
| GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/extensions/{technology}/availableHosts |
| Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/extensions/{technology}/availableHosts |
Authentication
To execute this request, you need an access token with ReadConfig scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameter
Name of requested technology
ACTIVEMQ_CLIENTACTIVE_MQACTIVE_MQ_ARTEMISADOBE_EXPERIENCE_MANAGERADO_NETAIXAKKAAMAZON_REDSHIFTAMQPAPACHE_CAMELAPACHE_CASSANDRAAPACHE_COUCH_DBAPACHE_DERBYAPACHE_HTTP_CLIENT_ASYNCAPACHE_HTTP_CLIENT_SYNCAPACHE_HTTP_SERVERAPACHE_KAFKAAPACHE_LOG4JAPACHE_SOLRAPACHE_STORMAPACHE_SYNAPSEAPACHE_TOMCATAPPARMORAPPLICATION_INSIGHTS_SDKASP_DOTNETASP_DOTNET_COREASP_DOTNET_CORE_SIGNALRASP_DOTNET_SIGNALRASYNC_HTTP_CLIENTAWS_DYNAMO_DBAWS_LAMBDAAWS_RDSAWS_SERVICEAWS_SNS_CLIENTAWS_SQSAXISAZURE_FUNCTIONSAZURE_SERVICE_BUSAZURE_SERVICE_FABRICAZURE_STORAGEBOSHBPMCICS_FILE_ACCESSCITRIXCITRIX_COMMONCITRIX_DESKTOP_DELIVERY_CONTROLLERSCITRIX_DIRECTORCITRIX_LICENSE_SERVERCITRIX_PROVISIONING_SERVICESCITRIX_STOREFRONTCITRIX_VIRTUAL_DELIVERY_AGENTCITRIX_WORKSPACE_ENVIRONMENT_MANAGEMENTCITRIX_XENCLOUDFOUNDRYCLOUDFOUNDRY_AUCTIONEERCLOUDFOUNDRY_BOSHCLOUDFOUNDRY_GOROUTERCODEIGNITERCOLDFUSIONCONFLUENT_KAFKA_CLIENTCONTAINERDCORE_DNSCOSMOSDBCOUCHBASECRIOCXFDATASTAXDB2DIEGO_CELLDOCKERDOTNETDOTNET_REMOTINGDRUPALDYNATRACEELASTIC_SEARCHENVOYERLANGETCDF5_LTMFSHARPGARDENGLASSFISHGOGOOGLE_CLOUD_FUNCTIONSGRAAL_NATIVE_IMAGEGRAAL_TRUFFLEGRAPH_QLGRPCGRSECURITYHADOOPHADOOP_HDFSHADOOP_YARNHAPROXYHEATHELIDONHESSIANHORNET_QIBM_CICS_REGIONIBM_CICS_TRANSACTION_GATEWAYIBM_IMS_CONNECT_REGIONIBM_IMS_CONTROL_REGIONIBM_IMS_MESSAGE_PROCESSING_REGIONIBM_IMS_SOAP_GATEWAYIBM_INTEGRATION_BUSIBM_MQIBM_MQ_CLIENTIBM_WEBSHPRERE_APPLICATION_SERVERIBM_WEBSHPRERE_LIBERTYIBM_WEBSPHERE_APPLICATION_SERVERIBM_WEBSPHERE_LIBERTYIISIIS_APP_POOLISTIOJAVAJAVA_HTTPURLCONNECTIONJAVA_HTTPURLCONNETIONJAX_WSJBOSSJBOSS_EAPJBOSS_LOGMANAGERJDK_HTTP_CLIENTJDK_HTTP_SERVERJERSEYJETTYJOOMLAJRUBYJYTHONKUBERNETESLAMINASLARAVELLIBCLIBVIRTLINKERDLINUX_SYSTEMMAGENTOMARIADBMEMCACHEDMICRONAUTMICROSOFT_SQL_SERVERMONGODBMONGODB_CLIENTMONGODB_CLIENT_DOTNETMSSQL_CLIENTMULE_ESBMYSQLMYSQL_CONNECTORNETFLIX_SERVONETTYNGINXNODE_JSOK_HTTP_CLIENTONEAGENT_SDKOPENCENSUSOPENSHIFTOPENSTACK_COMPUTEOPENSTACK_CONTROLLEROPENTELEMETRYOPENTRACINGOPEN_LIBERTYORACLE_DATABASEORACLE_DB_LISTENERORACLE_WEBLOGICOWINPERLPHPPHP_FPMPLAYPODMANPOSTGRE_SQLPOSTGRE_SQL_DOTNET_DATA_PROVIDERPOWER_DNSPROGRESSPYTHONQOS_LOGBACKQUARKUSRABBIT_MQREACTOR_COREREDISRESTEASYRESTLETRIAKRKE2RSOCKETRUBYRUNCRXJAVASAG_WEBMETHODS_ISSAPSAP_HANADBSAP_HYBRISSAP_MAXDBSAP_SYBASESCALASECURITY_SOFTWARESELINUXSHAREPOINTSHELLSLIMSPARKSPRINGSQLITESYMFONYTHRIFTTIBCOTIBCO_BUSINESS_WORKSTIBCO_EMSUNDERTOW_IOVARNISH_CACHEVERTXVIM2VIOSVIRTUAL_MACHINE_KVMVIRTUAL_MACHINE_QEMUWILDFLYWINDOWS_CONTAINERSWINDOWS_SYSTEMWINKWORDPRESSZERO_MQZOS_CONNECT
Filters the resulting set of hosts by the specified tag.
You can specify several tags in the following format: tag=tag1&tag=tag2. The host has to match all the specified tags.
Only return hosts that are part of the specified management zone.
Filters the resulting set of hosts by the specified host group.
Specify the Dynatrace IDs of the host group you're interested in.
Filters the resulting set of hosts by the specified host group.
Specify the name of the host group you're interested in.
The number of results per result page. Must be between 1 and 500
The cursor for the next page of results.
Response
Response codes
Response body objects
The HostList object
The list of hosts supported by extension.
Next page key used for paging
Total number of results
The Host object
Host details. Contains ID, name, host group, and tags.
The ID of the host
The name of the host
The HostGroup object
Host group to which the host belongs.
The Dynatrace entity ID of the host group.
The name of the Dynatrace entity, displayed in the UI.
The EntityShortRepresentation object
The short representation of a Dynatrace entity.
A short description of the Dynatrace entity.
The ID of the Dynatrace entity.
The name of the Dynatrace entity.
The TagInfo object
Tag of a Dynatrace entity.
The origin of the tag, such as AWS or Cloud Foundry.
Custom tags use the CONTEXTLESS value.
AWSAWS_GENERICAZURECLOUD_FOUNDRYCONTEXTLESSENVIRONMENTGOOGLE_CLOUDKUBERNETES
The key of the tag.
Custom tags have the tag value here.
The value of the tag.
Not applicable to custom tags.
Response body JSON model
{"hosts": [{"hostGroup": {"meId": "HOST_GROUP-CF1DA380B3A53F17","name": "example host group"},"id": "HOST-0000000000000000","managementZones": [{"id": "000000000000000000","name": "example zone"}],"name": "example host","tags": ["tagA","tagB"]}],"nextPageKey": "string","totalResults": 1}