/AWS1/IF_EKS=>UPDATECAPABILITY()

About UpdateCapability

Updates the configuration of a managed capability in your Amazon EKS cluster. You can update the IAM role, configuration settings, and delete propagation policy for a capability.

When you update a capability, Amazon EKS applies the changes and may restart capability components as needed. The capability remains available during the update process, but some operations may be temporarily unavailable.

Method Signature

METHODS /AWS1/IF_EKS~UPDATECAPABILITY
  IMPORTING
    !IV_CLUSTERNAME TYPE /AWS1/EKSSTRING OPTIONAL
    !IV_CAPABILITYNAME TYPE /AWS1/EKSSTRING OPTIONAL
    !IV_ROLEARN TYPE /AWS1/EKSSTRING OPTIONAL
    !IO_CONFIGURATION TYPE REF TO /AWS1/CL_EKSUPDCAPABILITYCONF OPTIONAL
    !IV_CLIENTREQUESTTOKEN TYPE /AWS1/EKSSTRING OPTIONAL
    !IV_DELETEPROPAGATIONPOLICY TYPE /AWS1/EKSCAPABILITYDELPROPPLY OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_eksupdcapabilityrsp
  RAISING
    /AWS1/CX_EKSACCESSDENIEDEX
    /AWS1/CX_EKSINVALIDPARAMETEREX
    /AWS1/CX_EKSRESOURCEINUSEEX
    /AWS1/CX_EKSRESOURCENOTFOUNDEX
    /AWS1/CX_EKSSERVEREXCEPTION
    /AWS1/CX_EKSCLIENTEXC
    /AWS1/CX_EKSSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_clustername TYPE /AWS1/EKSSTRING /AWS1/EKSSTRING

The name of the Amazon EKS cluster that contains the capability you want to update configuration for.

iv_capabilityname TYPE /AWS1/EKSSTRING /AWS1/EKSSTRING

The name of the capability to update configuration for.

Optional arguments:

iv_rolearn TYPE /AWS1/EKSSTRING /AWS1/EKSSTRING

The Amazon Resource Name (ARN) of the IAM role that the capability uses to interact with Amazon Web Services services. If you specify a new role ARN, the capability will start using the new role for all subsequent operations.

io_configuration TYPE REF TO /AWS1/CL_EKSUPDCAPABILITYCONF /AWS1/CL_EKSUPDCAPABILITYCONF

The updated configuration settings for the capability. You only need to specify the configuration parameters you want to change. For Argo CD capabilities, you can update RBAC role mappings and network access settings.

iv_clientrequesttoken TYPE /AWS1/EKSSTRING /AWS1/EKSSTRING

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This token is valid for 24 hours after creation.

iv_deletepropagationpolicy TYPE /AWS1/EKSCAPABILITYDELPROPPLY /AWS1/EKSCAPABILITYDELPROPPLY

The updated delete propagation policy for the capability. Currently, the only supported value is RETAIN.

RETURNING

oo_output TYPE REF TO /aws1/cl_eksupdcapabilityrsp /AWS1/CL_EKSUPDCAPABILITYRSP

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->updatecapability(
  io_configuration = new /aws1/cl_eksupdcapabilityconf(
    io_argocd = new /aws1/cl_eksupdateargocdconfig(
      io_networkaccess = new /aws1/cl_eksargocdnetacccfgreq(
        it_vpceids = VALUE /aws1/cl_eksstringlist_w=>tt_stringlist(
          ( new /aws1/cl_eksstringlist_w( |string| ) )
        )
      )
      io_rbacrolemappings = new /aws1/cl_eksupdaterolemappings(
        it_addorupdaterolemappings = VALUE /aws1/cl_eksargocdrolemapping=>tt_argocdrolemappinglist(
          (
            new /aws1/cl_eksargocdrolemapping(
              it_identities = VALUE /aws1/cl_eksssoidentity=>tt_ssoidentitylist(
                (
                  new /aws1/cl_eksssoidentity(
                    iv_id = |string|
                    iv_type = |string|
                  )
                )
              )
              iv_role = |string|
            )
          )
        )
        it_removerolemappings = VALUE /aws1/cl_eksargocdrolemapping=>tt_argocdrolemappinglist(
          (
            new /aws1/cl_eksargocdrolemapping(
              it_identities = VALUE /aws1/cl_eksssoidentity=>tt_ssoidentitylist(
                (
                  new /aws1/cl_eksssoidentity(
                    iv_id = |string|
                    iv_type = |string|
                  )
                )
              )
              iv_role = |string|
            )
          )
        )
      )
    )
  )
  iv_capabilityname = |string|
  iv_clientrequesttoken = |string|
  iv_clustername = |string|
  iv_deletepropagationpolicy = |string|
  iv_rolearn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lo_update = lo_result->get_update( ).
  IF lo_update IS NOT INITIAL.
    lv_string = lo_update->get_id( ).
    lv_updatestatus = lo_update->get_status( ).
    lv_updatetype = lo_update->get_type( ).
    LOOP AT lo_update->get_params( ) into lo_row.
      lo_row_1 = lo_row.
      IF lo_row_1 IS NOT INITIAL.
        lv_updateparamtype = lo_row_1->get_type( ).
        lv_string = lo_row_1->get_value( ).
      ENDIF.
    ENDLOOP.
    lv_timestamp = lo_update->get_createdat( ).
    LOOP AT lo_update->get_errors( ) into lo_row_2.
      lo_row_3 = lo_row_2.
      IF lo_row_3 IS NOT INITIAL.
        lv_errorcode = lo_row_3->get_errorcode( ).
        lv_string = lo_row_3->get_errormessage( ).
        LOOP AT lo_row_3->get_resourceids( ) into lo_row_4.
          lo_row_5 = lo_row_4.
          IF lo_row_5 IS NOT INITIAL.
            lv_string = lo_row_5->get_value( ).
          ENDIF.
        ENDLOOP.
      ENDIF.
    ENDLOOP.
  ENDIF.
ENDIF.