Acquire License

Description: Acquires one or several license(s) from a bucket and returns it or them. Those licenses are marked as used in the bucket report under the "Unknown usage" section.

Since: 4.0

Notes: Requires Artifactory Enterprise

Security: Requires an admin user

Usage: POST /mc/api/v1/buckets/{name}/acquire

Consumes: application/json

{
    "name" : "<a free text label>",
    "license_count" : <number of licenses to acquire> 
} 

Produces: application/json

Return codes:

200 - Success

404 - "The entity 'LicenseBucket' with identifier '<Non existing Bucket Id>' was not found."

Sample usage:

acquirelicense.json

POST /api/v1/buckets/mybucket/acquire
{
    "name" : "team-A-license",
    "license_count" : 1
} 

Sample response:

example output

{
  "license_keys" : [ "<license-key>" ]
}