License reservation (REST)

AppMon 2018 February

These REST interface is available in the AppMon 2018 February only.

The AppMon Server offers several RESTful interfaces to manage license assignments. You can also perform the some of these operations in the AppMon Client, in the Licensing item of the Dynatrace Server Settings dialog box. See License assignments and Manage UEM visits volume for more information.

Agents and UEM reservations

GET Agent and UEM reservations

Produces a list of all license and UEM reservations for all System Profiles on the server.

GET https://<server>:8021/api/v3/license/reservation produces application/json

Agents reservations

These request handle Agents reservations for certain System Profiles and Agent Groups in those System Profiles.

You can configure the number of reserved and maximum allowed Agents, set up usage of Agent Hours, and set up validity period of the reservation.

You can also view and delete such configurations.

PUT Agent reservation

Creates the Agents reservation for the specified System Profile and an Agent Group in this System Profile. If such a reservation already exists, it will be overwritten.

If no group is specified, the reservation for all Agent Groups will be created/updated. Reservations for a particular group, if any, won't be affected.

The specified Agent Group must exist in the System Profile prior to request execution.

PUT https://<server>:8021/api/v3/license/reservation/agents consumes application/json

GET Agent reservation

Produces the information about the Agents reservations for the specified System Profile and an Agent Group in this System Profile.

If no group is specified, only reservation, valid for all Agent Groups, will be listed. Reservations for a particular group, if any, won't be listed.

GET https://<server>:8021/api/v3/license/reservation/agents produces application/json

DELETE Agent reservation

Deletes all Agents reservations from the specified System Profile and an Agent Group in this System Profile.

If no group is specified, the reservation for all Agent Groups will be deleted. Reservations for a specific group, if any, won't be affected.

DELETE https://<server>:8021/api/v3/license/reservation/agents

Agent Hour reservations

These requests handle Agent Hours reservations for certain System Profiles and Agent Groups in those System Profiles.

You can enable/disable usage of Agent Hours, reserve them for a System Profile and an Agent Group, and set up the validity period of the reservation.

You can also view and delete such configurations.

PUT Agent Hour reservation

Creates the Agent Hour reservation for the specified System Profile and an Agent Group in this System Profile. If such a reservation already exists, it will be overwritten.

If no group is specified, the reservation for all Agent Groups will be created/updated. Reservations for a particular group, if any, won't be affected.

The specified Agent Group must exist in the System Profile prior to request execution.

PUT https://<server>:8021/api/v3/license/reservation/agents/agenthours consumes application/json

GET Agent Hour reservation

Produces a list of the Agent Hours reservations for the specified System Profile and an Agent Group in this System Profile.

If no group is specified, only reservation, valid for all Agent Groups, will be listed.

GET https://<server>:8021/api/v3/license/reservation/agents/agenthours produces application/json

DELETE Agent Hours reservation

Deletes Agent Hours reservation from the specified System Profile and an Agent Group in this System Profile.

If no group is specified, the reservation for all Agent Groups will be deleted. Reservations for a specific group, if any, won't be affected.

DELETE https://<server>:8021/api/v3/license/reservation/agents/agenthours

Agent Unit reservations

These requests handle Agent Units reservations for certain System Profiles and Agent Groups in those System Profiles. Agent Units may be consumed by any Agent, regardless of its technology.

You can configure the number of reserved and maximum allowed Agents Units.

You can also view and delete such configurations.

PUT Agent Unit reservation

Creates the Agent Unit reservation for the specified System Profile and an Agent Group in this System Profile. If such a reservation already exists, it will be overwritten.

If no group is specified, the reservation for all Agent Groups will be created/updated. Reservations for a particular group, if any, won't be affected.

The specified Agent Group must exist in the System Profile prior to request execution.

PUT https://<server>:8021/api/v3/license/reservation/agents/agentunits consumes application/json

GET Agent Unit reservation

Produces a list of the Agent Units reservations for the specified System Profile and an Agent Group in this System Profile.

If no group is specified, only reservation, valid for all Agent Groups will be listed.

GET https://<server>:8021/api/v3/license/reservation/agents/agentunits produces application/json

DELETE Agent Unit reservation

Deletes Agent Units reservation from the specified System Profile and an Agent Group in this System Profile.

If no group is specified, the reservation for all Agent Groups will be deleted. Reservations for a specific group, if any, won't be affected.

DELETE https://<server>:8021/api/v3/license/reservation/agents/agentunits

Technology reservations

These requests handle reservations of a particular technology for certain System Profiles and Agent Groups in those System Profiles.

You can configure the number of reserved and maximum allowed Agents of a particular technology, set up usage of Agent Hours, and set up validity period of the reservation.

PUT Technology reservation

Creates a technology reservation for the specified System Profile and an Agent Group in this System Profile. If such a reservation already exists, it will be overwritten.

If no group is specified, the reservation for all Agent Groups will be created/updated. Reservations for a particular group, if any, won't be affected.

The specified Agent Group must exist in the System Profile prior to request execution.

PUT https://<server>:8021/api/v3/license/reservation/agents/technology consumes application/json

GET Technology reservation

Produces a list of the particular technology reservations for the specified System Profile and an Agent Group in this System Profile.

If no group is specified, only reservation, valid for all Agent Groups, will be listed.

GET https://<server>:8021/api/v3/license/reservation/agents/technology produces application/json

DELETE Technology reservation

Deletes technology reservation for the specified technology from the specified System Profile and an Agent Group in this System Profile.

If no group is specified, the reservation for all Agent Groups will be deleted. Reservations for a specific group, if any, won't be affected.

DELETE https://<server>:8021/api/v3/license/reservation/agents/technology

UEM reservations

These requests handle UEM volume reservations certain System Profiles and applications in those System Profiles.

You can configure the number of reserved visits, enable/disable usage of unreserved visits, and set up validity period of the reservation.

You can also view and delete such configurations.

PUT UEM reservation

Creates a UEM volume reservation for the specified System Profile and an application in this System Profile. If such a reservation already exists, it will be overwritten.

If no application is specified, the reservation for all applications will be created/updated. Reservations for a particular application, if any, won't be affected.

The specified application must exist in the System Profile prior to request execution.

PUT https://<server>:8021/api/v3/license/reservation/uem consumes application/json

GET UEM reservation

Produces a list of the UEM volume reservation informations for the specified System Profile and an application in this System Profile.

If no application is specified, only reservation, valid for all applications will be listed.

GET https://<server>:8021/api/v3/license/reservation/uem produces application/json

DELETE UEM reservation

Deletes a UEM volume reservation from the specified System Profile and an application in this System Profile.

If no application is specified, the reservation for all applications will be deleted. Reservations for a specific application, if any, won't be affected.

DELETE https://<server>:8021/api/v3/license/reservation/uem