v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1450227196.3 KB

Creates a license configuration.

A license configuration is an abstraction of a customer license agreement that can be consumed and enforced by License Manager. Components include specifications for the license type (licensing by instance, socket, CPU, or vCPU), allowed tenancy (shared tenancy, Dedicated Instance, Dedicated Host, or all of these), license affinity to host (how long a license must be associated with a host), and the number of licenses purchased and used.

post/#X-Amz-Target=AWSLicenseManager.CreateLicenseConfiguration

Headers

X-Amz-Target'AWSLicenseManager.CreateLicenseConfiguration' required

Request body

Namestring required

Name of the license configuration.

Descriptionstring

Description of the license configuration.

LicenseCountingType'vCPU' | 'Instance' | 'Core' | 'Socket' required

Dimension used to track the license inventory.

LicenseCountinteger

Number of licenses managed by the license configuration.

LicenseCountHardLimitboolean

Indicates whether hard or soft license enforcement is used. Exceeding a hard limit blocks the launch of new instances.

LicenseRulesString[]
<p>License rules. The syntax is #name=value (for example, #allowedTenancy=EC2-DedicatedHost). The available rules vary by dimension, as follows.</p> <ul> <li> <p> <code>Cores</code> dimension: <code>allowedTenancy</code> | <code>licenseAffinityToHost</code> | <code>maximumCores</code> | <code>minimumCores</code> </p> </li> <li> <p> <code>Instances</code> dimension: <code>allowedTenancy</code> | <code>maximumCores</code> | <code>minimumCores</code> | <code>maximumSockets</code> | <code>minimumSockets</code> | <code>maximumVcpus</code> | <code>minimumVcpus</code> </p> </li> <li> <p> <code>Sockets</code> dimension: <code>allowedTenancy</code> | <code>licenseAffinityToHost</code> | <code>maximumSockets</code> | <code>minimumSockets</code> </p> </li> <li> <p> <code>vCPUs</code> dimension: <code>allowedTenancy</code> | <code>honorVcpuOptimization</code> | <code>maximumVcpus</code> | <code>minimumVcpus</code> </p> </li> </ul> <p>The unit for <code>licenseAffinityToHost</code> is days and the range is 1 to 180. The possible values for <code>allowedTenancy</code> are <code>EC2-Default</code>, <code>EC2-DedicatedHost</code>, and <code>EC2-DedicatedInstance</code>. The possible values for <code>honorVcpuOptimization</code> are <code>True</code> and <code>False</code>.</p>
DisassociateWhenNotFoundboolean

When true, disassociates a resource when software is uninstalled.

Response

Success

LicenseConfigurationArnstring

Amazon Resource Name (ARN) of the license configuration.