How to Access UPM REST API for License Details


アトラシアン コミュニティをご利用ください。


データベースの変更を行う場合は必ず事前にバックアップを取得してください。可能な場合は、まずステージング サーバーで SQL コマンドの変更、挿入、更新、または削除を行うようにします。


This document is for System Administrators who would like to use the UPM API to monitor license details of Add-Ons of their JIRA Server.  


There is some documentation in: UPM REST API may assist you with this process.

Call the UPM REST API:

To get a JSON document for tall the Add-ons from the UPM:

GET <BASE-URL>/rest/plugins/1.0/

This will return a response with the content similar to the following:

      "enabled": true,
      "links": {
        "self": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key",
        "plugin-summary": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/summary",
        "modify": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key",
        "plugin-icon": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/media\/plugin-icon",
        "plugin-logo": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/media\/plugin-logo",
        "manage": "http:\/\/example:18000\/jiralatest\/plugins\/servlet\/upm?fragment=manage%2Fcom.atlassian.servicedesk",
        "delete": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key"
      "name": "JIRA Service Desk",
      "version": "2.5.4",
      "userInstalled": true,
      "optional": true,
      "static": false,
      "unloadable": false,
      "description": "Service and support for teams. Put the power of JIRA into the hands of your service desk team. JIRA Service Desk combines an intuitive, user-friendly experience with powerful SLA management and real-time reporting.",
      "key": "com.atlassian.servicedesk",
      "usesLicensing": true,
      "remotable": false,
      "vendor": {
        "name": "Atlassian",
        "link": "http:\/\/"

Use the results to query specific Add-ons:

Add "license' to a specific License query:

GET <BASE-URL>/rest/plugins/1.0/com.atlassian.servicedesk-key/license

This will return results similar to the following:

  "links": {
    "self": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/license",
    "alternate": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key",
    "license": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/license",
    "update-license": "\/jiralatest\/rest\/plugins\/1.0\/com.atlassian.servicedesk-key\/license",
    "license-callback": "http:\/\/example:18000\/jiralatest\/plugins\/servlet\/upm\/license\/com.atlassian.servicedesk"
  "pluginKey": "com.atlassian.servicedesk",
  "valid": true,
  "evaluation": false,
  "nearlyExpired": false,
  "maximumNumberOfUsers": 5000,
  "maintenanceExpiryDate": 3012645600000,
  "licenseType": "COMMERCIAL",
  "licenseTypeDescriptionKey": "COMMERCIAL",
  "creationDateString": "20\/Jun\/14",
  "rawLicense": "removed",
  "maintenanceExpiryDateString": "20\/Jun\/15",
  "organizationName": "",
  "contactEmail": "",
  "enterprise": true,
  "dataCenter": false,
  "subscription": false,
  "active": true,
  "autoRenewal": false,
  "currentRoleCount": 1,
  "roleManagementUri": "\/jiralatest\/secure\/admin\/AgentAllocation.jspa",
  "typeI18nSingular": "agent",
  "typeI18nPlural": "agents",
  "supportEntitlementNumber": "SEN-000000"

If you are looking to complete more integrations with JIRA through the REST API, you might like to look at: the Atlassian REST API Browser and it will help you uncover the Public (and private) API's and call these. Please keep in mind that accessing these private API's is not supported by Atlassian, and may be harmful if used in an unintentional manner.

最終更新日: 2018 年 12 月 4 日


Powered by Confluence and Scroll Viewport.