Monitored entities API - GET all entity types

Lists all types of monitored entities observed in your environment.

Additionally, every entity type lists the possible properties of an entity of that type. Note that these are placeholders showing what properties an entity can possibly have, not actual properties. To view actual properties of an entity, use the GET an entity request.

You can limit the output by using the pagination:

Specify the number of results per page in the pageSize query parameter.
Then use the cursor from the nextPageKey field of the previous response in the nextPageKey query parameter to obtain subsequent pages.

The request produces an application/json payload.

Early Adopter

This request is an Early Adopter release and may be changed in non-compatible way.

GET	Managed https://{your-domain}/e/{your-environment-id}/api/v2/entityTypes SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/entityTypes

Authentication

To execute this request, you need the Read entities using API V2 (entities.read) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
nextPageKey	string	The cursor for the next page of results. You can find it in the nextPageKey field of the previous response. The first page is always returned if you don't specify the nextPageKey query parameter. When the nextPageKey is set to obtain subsequent pages, you must omit all other query parameters.	query	optional
pageSize	integer	The desired amount of entity types in a single response payload. The maximal allowed page size is 500. If not set, 50 is used.	query	optional

Parameter

Type

Description

Required

nextPageKey

string

The cursor for the next page of results. You can find it in the nextPageKey field of the previous response.

The first page is always returned if you don't specify the nextPageKey query parameter.

When the nextPageKey is set to obtain subsequent pages, you must omit all other query parameters.

query

optional

pageSize

integer

The desired amount of entity types in a single response payload.

The maximal allowed page size is 500.

If not set, 50 is used.

query

optional

Response format

Response parameters JSON model

The EntityTypeList object

A list of properties of all available entity types.

Element	Type	Description
totalCount	integer	The total number of entries in the result.
pageSize	integer	The number of entries per page.
nextPageKey	string	The cursor for the next page of results. Has the value of `null` on the last page. Use it in the nextPageKey query parameter to obtain subsequent pages of the result.
types	EntityType[]	The list of meta information for all available entity-types

The EntityType object

A list of properties of the monitored entity type.

Element	Type	Description
fromRelationships	ToPosition[]	A list of possible relationships where the monitored entity type occupies the FROM position
toRelationships	FromPosition[]	A list of possible relationships where the monitored entity type occupies the TO position.
managementZones	string	The placeholder for the list of management zones of an actual entity.
properties	EntityTypePropertyDto[]	A list of additional properties of the monitored entity type.
type	string	The type of the monitored entity.
tags	string	The placeholder for the list of tags of an actual entity.

The EntityTypePropertyDto object

The property of a monitored entity.

Element	Type	Description
id	string	The ID of the property.
type	string	The type of the property.

The FromPosition object

The FROM position of a relationship.

Element	Type	Description
fromTypes	string[]	A list of monitored entity types that can occupy the FROM position.
id	string	The ID of the relationship.

The ToPosition object

The TO position of a relationship.

Element	Type	Description
toTypes	string[]	A list of monitored entity types that can occupy the TO position.
id	string	The ID of the relationship.

    
{
  "totalCount": 0,
  "pageSize": 0,
  "nextPageKey": "AQAAABQBAAAABQ==",
  "types": [
    {
      "type": "HOST",
      "properties": [
        {
          "id": "BITNESS",
          "type": "Enum"
        },
        {
          "id": "CPU_CORES",
          "type": "Number"
        }
      ],
      "tags": "placeholder for tags",
      "managementZones": "placeholder for management zones",
      "fromRelationships": [
        {
          "id": "RUNS_ON_RESOURCE",
          "toTypes": [
            "CUSTOM_DEVICE"
          ]
        },
        {
          "id": "IS_NETWORK_CLIENT_OF_HOST",
          "toTypes": [
            "HOST",
            "CUSTOM_DEVICE"
          ]
        }
      ],
      "toRelationships": [
        {
          "id": "IS_DISK_OF",
          "fromTypes": [
            "DISK"
          ]
        },
        {
          "id": "IS_SITE_OF",
          "fromTypes": [
            "VMWARE_DATACENTER",
            "GEOLOC_SITE"
          ]
        }
      ]
    }
  ]
}

Example

In this example, the request lists all entity types observed in the mySampleEnv environment.

The API token is passed in the Authorization header.

Because the full result is rather lengthy, it is truncated to three entries. Subsequently, the properties array of each entity is also truncated to three entries.

Curl

curl -L -X GET 'https://mySampleEnv.live.dynatrace.com/api/v2/entityTypes' \
-H 'Authorization: Api-Token abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com/api/v2/entityTypes

Response body

{
  "totalCount": 33,
  "pageSize": 33,
  "types": [
    {
      "type": "APPLICATION",
      "properties": [
        {
          "id": "applicationType",
          "type": "Enum"
        },
        {
          "id": "conditionalName",
          "type": "String"
        },
        {
          "id": "customizedName",
          "type": "String"
        }
      ],
      "tags": "List",
      "managementZones": "List",
      "fromRelationships": [
        {
          "id": "calls",
          "toTypes": [
            "SERVICE"
          ]
        }
      ],
      "toRelationships": []
    },
    {
      "type": "HOST",
      "properties": [
        {
          "id": "ipAddresses",
          "type": "List"
        },
        {
          "id": "osType",
          "type": "Enum"
        },
        {
          "id": "osVersion",
          "type": "String"
        }
      ],
      "tags": "List",
      "managementZones": "List",
      "fromRelationships": [
        {
          "id": "runsOn",
          "toTypes": [
            "EC2_INSTANCE",
            "VIRTUALMACHINE",
            "AZURE_VM",
            "OPENSTACK_VM",
            "GOOGLE_COMPUTE_ENGINE",
            "HYPERVISOR"
          ]
        },
        {
          "id": "runsOnResource",
          "toTypes": [
            "CUSTOM_DEVICE"
          ]
        },
        {
          "id": "isInstanceOf",
          "toTypes": [
            "HOST_GROUP"
          ]
        },
        {
          "id": "isNetworkClientOfHost",
          "toTypes": [
            "HOST",
            "CUSTOM_DEVICE"
          ]
        },
        {
          "id": "candidateTalksWith",
          "toTypes": [
            "CUSTOM_DEVICE",
            "PROCESS_GROUP_INSTANCE"
          ]
        }
      ],
      "toRelationships": [
        {
          "id": "isProcessOf",
          "fromTypes": [
            "PROCESS_GROUP_INSTANCE"
          ]
        },
        {
          "id": "runsOn",
          "fromTypes": [
            "OPENSTACK_VM",
            "PROCESS_GROUP"
          ]
        },
        {
          "id": "isSiteOf",
          "fromTypes": [
            "GEOLOC_SITE",
            "VMWARE_DATACENTER"
          ]
        },
        {
          "id": "talksWithCandidate",
          "fromTypes": [
            "CUSTOM_DEVICE",
            "PROCESS_GROUP_INSTANCE"
          ]
        },
        {
          "id": "isNetworkClientOfHost",
          "fromTypes": [
            "CUSTOM_DEVICE",
            "HOST"
          ]
        },
        {
          "id": "isDiskOf",
          "fromTypes": [
            "DISK"
          ]
        },
        {
          "id": "runsOnHost",
          "fromTypes": [
            "SERVICE"
          ]
        },
        {
          "id": "isContainerGroupInstanceOfHost",
          "fromTypes": [
            "CONTAINER_GROUP_INSTANCE"
          ]
        }
      ]
    },
    {
      "type": "SERVICE",
      "properties": [
        {
          "id": "mainServiceSoftwareTech",
          "type": "Map"
        },
        {
          "id": "port",
          "type": "Number"
        },
        {
          "id": "serviceType",
          "type": "Enum"
        }
      ],
      "tags": "List",
      "managementZones": "List",
      "fromRelationships": [
        {
          "id": "runsOn",
          "toTypes": [
            "CUSTOM_DEVICE_GROUP",
            "PROCESS_GROUP"
          ]
        },
        {
          "id": "runsOnProcessGroupInstance",
          "toTypes": [
            "CUSTOM_DEVICE",
            "PROCESS_GROUP_INSTANCE"
          ]
        },
        {
          "id": "runsOnHost",
          "toTypes": [
            "CUSTOM_DEVICE",
            "HOST"
          ]
        },
        {
          "id": "calls",
          "toTypes": [
            "SERVICE"
          ]
        }
      ],
      "toRelationships": [
        {
          "id": "calls",
          "fromTypes": [
            "MOBILE_APPLICATION",
            "CUSTOM_APPLICATION",
            "HTTP_CHECK",
            "APPLICATION",
            "SERVICE"
          ]
        }
      ]
    }
  ]
}

Response code

200