CREATEENTITLEMENT()`¶

About CreateEntitlement¶

Creates a Windows Server License entitlement for virtual machines in an Amazon EVS environment using the provided vCenter Server connector. This is an asynchronous operation. Amazon EVS validates the specified virtual machines before starting usage tracking.

Method Signature¶

METHODS /AWS1/IF_EVS~CREATEENTITLEMENT
  IMPORTING
    !IV_CLIENTTOKEN TYPE /AWS1/EVSCLIENTTOKEN OPTIONAL
    !IV_ENVIRONMENTID TYPE /AWS1/EVSENVIRONMENTID OPTIONAL
    !IV_CONNECTORID TYPE /AWS1/EVSCONNECTORID OPTIONAL
    !IV_ENTITLEMENTTYPE TYPE /AWS1/EVSENTITLEMENTTYPE OPTIONAL
    !IT_VMIDS TYPE /AWS1/CL_EVSVMIDLIST_W=>TT_VMIDLIST OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_evscreateentresponse
  RAISING
    /AWS1/CX_EVSRESOURCENOTFOUNDEX
    /AWS1/CX_EVSTHROTTLINGEX
    /AWS1/CX_EVSVALIDATIONEX
    /AWS1/CX_EVSCLIENTEXC
    /AWS1/CX_EVSSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_environmentid` `TYPE /AWS1/EVSENVIRONMENTID` `/AWS1/EVSENVIRONMENTID`¶

A unique ID for the environment to create the entitlement in.

`iv_connectorid` `TYPE /AWS1/EVSCONNECTORID` `/AWS1/EVSCONNECTORID`¶

A unique ID for the connector associated with the entitlement.

`iv_entitlementtype` `TYPE /AWS1/EVSENTITLEMENTTYPE` `/AWS1/EVSENTITLEMENTTYPE`¶

The type of entitlement to create.

`it_vmids` `TYPE /AWS1/CL_EVSVMIDLIST_W=>TT_VMIDLIST` `TT_VMIDLIST`¶

The list of VMware vSphere virtual machine managed object IDs to create entitlements for.

Optional arguments:¶

`iv_clienttoken` `TYPE /AWS1/EVSCLIENTTOKEN` `/AWS1/EVSCLIENTTOKEN`¶

This parameter is not used in Amazon EVS currently. If you supply input for this parameter, it will have no effect.

A unique, case-sensitive identifier that you provide to ensure the idempotency of the entitlement creation request. If you do not specify a client token, a randomly generated token is used for the request to ensure idempotency.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_evscreateentresponse` `/AWS1/CL_EVSCREATEENTRESPONSE`¶

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->createentitlement(
  it_vmids = VALUE /aws1/cl_evsvmidlist_w=>tt_vmidlist(
    ( new /aws1/cl_evsvmidlist_w( |string| ) )
  )
  iv_clienttoken = |string|
  iv_connectorid = |string|
  iv_entitlementtype = |string|
  iv_environmentid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_entitlements( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_vmid = lo_row_1->get_vmid( ).
      lv_environmentid = lo_row_1->get_environmentid( ).
      lv_connectorid = lo_row_1->get_connectorid( ).
      lv_vmname = lo_row_1->get_vmname( ).
      lv_entitlementtype = lo_row_1->get_type( ).
      lv_entitlementstatus = lo_row_1->get_status( ).
      lv_timestamp = lo_row_1->get_lastsyncedat( ).
      lv_timestamp = lo_row_1->get_startedat( ).
      lv_timestamp = lo_row_1->get_stoppedat( ).
      lo_errordetail = lo_row_1->get_errordetail( ).
      IF lo_errordetail IS NOT INITIAL.
        lv_string = lo_errordetail->get_errorcode( ).
        lv_string = lo_errordetail->get_errormessage( ).
      ENDIF.
    ENDIF.
  ENDLOOP.
ENDIF.

/AWS1/IF_EVS=>CREATEENTITLEMENT()¶