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

Security: Requires an admin user

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

Consumes: application/json

Produces: application/json

Sample usage:

curl -X POST 'https://myserver.com/mc/api/v1/buckets/mybucket/acquire

Query Parameters:

Name	Datatype	Mandatory	Description
`remove_new_line`	boolean	no	If set to `true`, this query parameter automatically removes line breaks for the provided license contents.

Sample query:

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

Sample response:

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

Return codes:

200: Success

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