Hub capabilities API - GET items
Lists all available Hub items.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/hub/items |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/hub/items | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/hub/items |
Authentication
To execute this request, you need an access token with hub.read
scope.
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 amount of hub items in a single response payload. The maximal allowed page size is 100. If not set, 20 is used. | query | optional |
itemType | string | If provided, will filter out results based on the given item type. | query | optional |
query | string | Filter the results for items matching the query string within id, name, author, description or any tag.
| query | optional |
installed | boolean | If provided, will restrict the result to Extensions 2.0 that have the respective installed state.
| query | optional |
categoryId | string | If provided, will filter items that belong to the given category.
| query | optional |
offset | string | If provided, will skip the desired number of results, allowing for pagination in combination with page size | query | optional |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Item | OK |
503 | ErrorEnvelope | Unavailable |
Response body objects
The ItemList
object
Element | Type | Description |
---|---|---|
items | Item | A list of available items. |
nextPageKey | string | The cursor for the next page of results. Has the value of Use it in the nextPageKey query parameter to obtain subsequent pages of the result. |
pageSize | integer | The number of entries per page. |
totalCount | integer | The total number of entries in the result. |
The ItemOverview
object
Overview of an item.
Response body JSON model
{
"items": [
{
"activationLink": "string",
"artifactId": "snmp-extension.dynatrace.com",
"authorLogo": "string",
"authorName": "string",
"clusterCompatible": true,
"comingSoon": true,
"description": "string",
"documentationLink": "string",
"hasDescriptionBlocks": true,
"itemId": "string",
"logo": "string",
"marketingLink": "string",
"name": "string",
"notCompatibleReason": "string",
"tags": [
"string"
],
"type": "EXTENSION1"
}
],
"nextPageKey": "AQAAABQBAAAABQ==",
"pageSize": 1,
"totalCount": 1
}