/AWS1/IF_ACM=>LISTCERTIFICATES()

About ListCertificates

Retrieves a list of certificate ARNs and domain names. You can request that only certificates that match a specific status be listed. You can also filter by specific attributes of the certificate. Default filtering returns only RSA_2048 certificates. For more information, see Filters.

Method Signature

METHODS /AWS1/IF_ACM~LISTCERTIFICATES
  IMPORTING
    !IT_CERTIFICATESTATUSES TYPE /AWS1/CL_ACMCERTSTATUSES_W=>TT_CERTIFICATESTATUSES OPTIONAL
    !IO_INCLUDES TYPE REF TO /AWS1/CL_ACMFILTERS OPTIONAL
    !IV_NEXTTOKEN TYPE /AWS1/ACMNEXTTOKEN OPTIONAL
    !IV_MAXITEMS TYPE /AWS1/ACMMAXITEMS OPTIONAL
    !IV_SORTBY TYPE /AWS1/ACMSORTBY OPTIONAL
    !IV_SORTORDER TYPE /AWS1/ACMSORTORDER OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_acmlistcertsresponse
  RAISING
    /AWS1/CX_ACMINVALIDARGSEX
    /AWS1/CX_ACMVALIDATIONEX
    /AWS1/CX_ACMCLIENTEXC
    /AWS1/CX_ACMSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Optional arguments:

it_certificatestatuses TYPE /AWS1/CL_ACMCERTSTATUSES_W=>TT_CERTIFICATESTATUSES TT_CERTIFICATESTATUSES

Filter the certificate list by status value.

io_includes TYPE REF TO /AWS1/CL_ACMFILTERS /AWS1/CL_ACMFILTERS

Filter the certificate list. For more information, see the Filters structure.

iv_nexttoken TYPE /AWS1/ACMNEXTTOKEN /AWS1/ACMNEXTTOKEN

Use this parameter only when paginating results and only in a subsequent request after you receive a response with truncated results. Set it to the value of NextToken from the response you just received.

iv_maxitems TYPE /AWS1/ACMMAXITEMS /AWS1/ACMMAXITEMS

Use this parameter when paginating results to specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the NextToken element is sent in the response. Use this NextToken value in a subsequent request to retrieve additional items.

iv_sortby TYPE /AWS1/ACMSORTBY /AWS1/ACMSORTBY

Specifies the field to sort results by. If you specify SortBy, you must also specify SortOrder.

iv_sortorder TYPE /AWS1/ACMSORTORDER /AWS1/ACMSORTORDER

Specifies the order of sorted results. If you specify SortOrder, you must also specify SortBy.

RETURNING

oo_output TYPE REF TO /aws1/cl_acmlistcertsresponse /AWS1/CL_ACMLISTCERTSRESPONSE

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->listcertificates(
  io_includes = new /aws1/cl_acmfilters(
    it_extendedkeyusage = VALUE /aws1/cl_acmextendedkeyusage00=>tt_extendedkeyusagefilterlist(
      ( new /aws1/cl_acmextendedkeyusage00( |string| ) )
    )
    it_keytypes = VALUE /aws1/cl_acmkeyalgorithmlist_w=>tt_keyalgorithmlist(
      ( new /aws1/cl_acmkeyalgorithmlist_w( |string| ) )
    )
    it_keyusage = VALUE /aws1/cl_acmkeyusagefiltlist_w=>tt_keyusagefilterlist(
      ( new /aws1/cl_acmkeyusagefiltlist_w( |string| ) )
    )
    iv_exportoption = |string|
    iv_managedby = |string|
  )
  it_certificatestatuses = VALUE /aws1/cl_acmcertstatuses_w=>tt_certificatestatuses(
    ( new /aws1/cl_acmcertstatuses_w( |string| ) )
  )
  iv_maxitems = 123
  iv_nexttoken = |string|
  iv_sortby = |string|
  iv_sortorder = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_nexttoken = lo_result->get_nexttoken( ).
  LOOP AT lo_result->get_certificatesummarylist( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_arn = lo_row_1->get_certificatearn( ).
      lv_domainnamestring = lo_row_1->get_domainname( ).
      LOOP AT lo_row_1->get_subjectalternativename00( ) into lo_row_2.
        lo_row_3 = lo_row_2.
        IF lo_row_3 IS NOT INITIAL.
          lv_domainnamestring = lo_row_3->get_value( ).
        ENDIF.
      ENDLOOP.
      lv_nullableboolean = lo_row_1->get_hasaddlsubjectalternat00( ).
      lv_certificatestatus = lo_row_1->get_status( ).
      lv_certificatetype = lo_row_1->get_type( ).
      lv_keyalgorithm = lo_row_1->get_keyalgorithm( ).
      LOOP AT lo_row_1->get_keyusages( ) into lo_row_4.
        lo_row_5 = lo_row_4.
        IF lo_row_5 IS NOT INITIAL.
          lv_keyusagename = lo_row_5->get_value( ).
        ENDIF.
      ENDLOOP.
      LOOP AT lo_row_1->get_extendedkeyusages( ) into lo_row_6.
        lo_row_7 = lo_row_6.
        IF lo_row_7 IS NOT INITIAL.
          lv_extendedkeyusagename = lo_row_7->get_value( ).
        ENDIF.
      ENDLOOP.
      lv_certificateexport = lo_row_1->get_exportoption( ).
      lv_nullableboolean = lo_row_1->get_inuse( ).
      lv_nullableboolean = lo_row_1->get_exported( ).
      lv_renewaleligibility = lo_row_1->get_renewaleligibility( ).
      lv_tstamp = lo_row_1->get_notbefore( ).
      lv_tstamp = lo_row_1->get_notafter( ).
      lv_tstamp = lo_row_1->get_createdat( ).
      lv_tstamp = lo_row_1->get_issuedat( ).
      lv_tstamp = lo_row_1->get_importedat( ).
      lv_tstamp = lo_row_1->get_revokedat( ).
      lv_certificatemanagedby = lo_row_1->get_managedby( ).
    ENDIF.
  ENDLOOP.
ENDIF.