Skip to content

/AWS1/IF_SGM=>LISTIMAGEVERSIONS()

About ListImageVersions

Lists the versions of a specified image and their properties. The list can be filtered by creation time or modified time.

Method Signature

METHODS /AWS1/IF_SGM~LISTIMAGEVERSIONS
  IMPORTING
    !IV_CREATIONTIMEAFTER TYPE /AWS1/SGMTIMESTAMP OPTIONAL
    !IV_CREATIONTIMEBEFORE TYPE /AWS1/SGMTIMESTAMP OPTIONAL
    !IV_IMAGENAME TYPE /AWS1/SGMIMAGENAME OPTIONAL
    !IV_LASTMODIFIEDTIMEAFTER TYPE /AWS1/SGMTIMESTAMP OPTIONAL
    !IV_LASTMODIFIEDTIMEBEFORE TYPE /AWS1/SGMTIMESTAMP OPTIONAL
    !IV_MAXRESULTS TYPE /AWS1/SGMMAXRESULTS OPTIONAL
    !IV_NEXTTOKEN TYPE /AWS1/SGMNEXTTOKEN OPTIONAL
    !IV_SORTBY TYPE /AWS1/SGMIMAGEVERSIONSORTBY OPTIONAL
    !IV_SORTORDER TYPE /AWS1/SGMIMAGEVERSIONSORTORDER OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_sgmlistimagevrssrsp
  RAISING
    /AWS1/CX_SGMRESOURCENOTFOUND
    /AWS1/CX_SGMCLIENTEXC
    /AWS1/CX_SGMSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_imagename TYPE /AWS1/SGMIMAGENAME /AWS1/SGMIMAGENAME

The name of the image to list the versions of.

Optional arguments:

iv_creationtimeafter TYPE /AWS1/SGMTIMESTAMP /AWS1/SGMTIMESTAMP

A filter that returns only versions created on or after the specified time.

iv_creationtimebefore TYPE /AWS1/SGMTIMESTAMP /AWS1/SGMTIMESTAMP

A filter that returns only versions created on or before the specified time.

iv_lastmodifiedtimeafter TYPE /AWS1/SGMTIMESTAMP /AWS1/SGMTIMESTAMP

A filter that returns only versions modified on or after the specified time.

iv_lastmodifiedtimebefore TYPE /AWS1/SGMTIMESTAMP /AWS1/SGMTIMESTAMP

A filter that returns only versions modified on or before the specified time.

iv_maxresults TYPE /AWS1/SGMMAXRESULTS /AWS1/SGMMAXRESULTS

The maximum number of versions to return in the response. The default value is 10.

iv_nexttoken TYPE /AWS1/SGMNEXTTOKEN /AWS1/SGMNEXTTOKEN

If the previous call to ListImageVersions didn't return the full set of versions, the call returns a token for getting the next set of versions.

iv_sortby TYPE /AWS1/SGMIMAGEVERSIONSORTBY /AWS1/SGMIMAGEVERSIONSORTBY

The property used to sort results. The default value is CREATION_TIME.

iv_sortorder TYPE /AWS1/SGMIMAGEVERSIONSORTORDER /AWS1/SGMIMAGEVERSIONSORTORDER

The sort order. The default value is DESCENDING.

RETURNING

oo_output TYPE REF TO /aws1/cl_sgmlistimagevrssrsp /AWS1/CL_SGMLISTIMAGEVRSSRSP

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->listimageversions(
  iv_creationtimeafter = '20150101000000.0000000'
  iv_creationtimebefore = '20150101000000.0000000'
  iv_imagename = |string|
  iv_lastmodifiedtimeafter = '20150101000000.0000000'
  iv_lastmodifiedtimebefore = '20150101000000.0000000'
  iv_maxresults = 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.
  LOOP AT lo_result->get_imageversions( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_timestamp = lo_row_1->get_creationtime( ).
      lv_failurereason = lo_row_1->get_failurereason( ).
      lv_imagearn = lo_row_1->get_imagearn( ).
      lv_imageversionarn = lo_row_1->get_imageversionarn( ).
      lv_imageversionstatus = lo_row_1->get_imageversionstatus( ).
      lv_timestamp = lo_row_1->get_lastmodifiedtime( ).
      lv_imageversionnumber = lo_row_1->get_version( ).
    ENDIF.
  ENDLOOP.
  lv_nexttoken = lo_result->get_nexttoken( ).
ENDIF.