Skip to content

/AWS1/IF_LIC=>CREATELICENSECONFIGURATION()

About CreateLicenseConfiguration

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.

Method Signature

METHODS /AWS1/IF_LIC~CREATELICENSECONFIGURATION
  IMPORTING
    !IV_NAME TYPE /AWS1/LICSTRING OPTIONAL
    !IV_DESCRIPTION TYPE /AWS1/LICSTRING OPTIONAL
    !IV_LICENSECOUNTINGTYPE TYPE /AWS1/LICLICENSECOUNTINGTYPE OPTIONAL
    !IV_LICENSECOUNT TYPE /AWS1/LICBOXLONG OPTIONAL
    !IV_LICENSECOUNTHARDLIMIT TYPE /AWS1/LICBOXBOOLEAN OPTIONAL
    !IT_LICENSERULES TYPE /AWS1/CL_LICSTRINGLIST_W=>TT_STRINGLIST OPTIONAL
    !IT_TAGS TYPE /AWS1/CL_LICTAG=>TT_TAGLIST OPTIONAL
    !IV_DISASSOCIATEWHENNOTFOUND TYPE /AWS1/LICBOXBOOLEAN OPTIONAL
    !IT_PRODUCTINFORMATIONLIST TYPE /AWS1/CL_LICPRODUCTINFORMATION=>TT_PRODUCTINFORMATIONLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_liccrelicenseconfrsp
  RAISING
    /AWS1/CX_LICACCESSDENIEDEX
    /AWS1/CX_LICAUTHEXCEPTION
    /AWS1/CX_LICINVPARAMVALUEEX
    /AWS1/CX_LICRLIMEXCEEDEDEX
    /AWS1/CX_LICRESRCLIMITEXCDEX
    /AWS1/CX_LICSERVERINTERNALEX
    /AWS1/CX_LICCLIENTEXC
    /AWS1/CX_LICSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_name TYPE /AWS1/LICSTRING /AWS1/LICSTRING

Name of the license configuration.

iv_licensecountingtype TYPE /AWS1/LICLICENSECOUNTINGTYPE /AWS1/LICLICENSECOUNTINGTYPE

Dimension used to track the license inventory.

Optional arguments:

iv_description TYPE /AWS1/LICSTRING /AWS1/LICSTRING

Description of the license configuration.

iv_licensecount TYPE /AWS1/LICBOXLONG /AWS1/LICBOXLONG

Number of licenses managed by the license configuration.

iv_licensecounthardlimit TYPE /AWS1/LICBOXBOOLEAN /AWS1/LICBOXBOOLEAN

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

it_licenserules TYPE /AWS1/CL_LICSTRINGLIST_W=>TT_STRINGLIST TT_STRINGLIST

License rules. The syntax is #name=value (for example, #allowedTenancy=EC2-DedicatedHost). The available rules vary by dimension, as follows.

  • Cores dimension: allowedTenancy | licenseAffinityToHost | maximumCores | minimumCores

  • Instances dimension: allowedTenancy | maximumVcpus | minimumVcpus

  • Sockets dimension: allowedTenancy | licenseAffinityToHost | maximumSockets | minimumSockets

  • vCPUs dimension: allowedTenancy | honorVcpuOptimization | maximumVcpus | minimumVcpus

The unit for licenseAffinityToHost is days and the range is 1 to 180. The possible values for allowedTenancy are EC2-Default, EC2-DedicatedHost, and EC2-DedicatedInstance. The possible values for honorVcpuOptimization are True and False.

it_tags TYPE /AWS1/CL_LICTAG=>TT_TAGLIST TT_TAGLIST

Tags to add to the license configuration.

iv_disassociatewhennotfound TYPE /AWS1/LICBOXBOOLEAN /AWS1/LICBOXBOOLEAN

When true, disassociates a resource when software is uninstalled.

it_productinformationlist TYPE /AWS1/CL_LICPRODUCTINFORMATION=>TT_PRODUCTINFORMATIONLIST TT_PRODUCTINFORMATIONLIST

Product information.

RETURNING

oo_output TYPE REF TO /aws1/cl_liccrelicenseconfrsp /AWS1/CL_LICCRELICENSECONFRSP

Domain /AWS1/RT_ACCOUNT_ID
Primitive Type NUMC

Examples

Syntax Example

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->createlicenseconfiguration(
  it_licenserules = VALUE /aws1/cl_licstringlist_w=>tt_stringlist(
    ( new /aws1/cl_licstringlist_w( |string| ) )
  )
  it_productinformationlist = VALUE /aws1/cl_licproductinformation=>tt_productinformationlist(
    (
      new /aws1/cl_licproductinformation(
        it_productinfmtionfiltlist = VALUE /aws1/cl_licproductinfmtionf00=>tt_productinformationfiltlist(
          (
            new /aws1/cl_licproductinfmtionf00(
              it_productinfmtionfiltvalue = VALUE /aws1/cl_licstringlist_w=>tt_stringlist(
                ( new /aws1/cl_licstringlist_w( |string| ) )
              )
              iv_productinfmtionfiltcomp00 = |string|
              iv_productinfmtionfiltname = |string|
            )
          )
        )
        iv_resourcetype = |string|
      )
    )
  )
  it_tags = VALUE /aws1/cl_lictag=>tt_taglist(
    (
      new /aws1/cl_lictag(
        iv_key = |string|
        iv_value = |string|
      )
    )
  )
  iv_description = |string|
  iv_disassociatewhennotfound = ABAP_TRUE
  iv_licensecount = 123
  iv_licensecounthardlimit = ABAP_TRUE
  iv_licensecountingtype = |string|
  iv_name = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_string = lo_result->get_licenseconfigurationarn( ).
ENDIF.