Skip to content

/AWS1/IF_CEX=>GETCOSTCATEGORIES()

About GetCostCategories

Retrieves an array of Cost Category names and values incurred cost.

If some Cost Category names and values are not associated with any cost, they will not be returned by this API.

Method Signature

METHODS /AWS1/IF_CEX~GETCOSTCATEGORIES
  IMPORTING
    !IV_SEARCHSTRING TYPE /AWS1/CEXSEARCHSTRING OPTIONAL
    !IO_TIMEPERIOD TYPE REF TO /AWS1/CL_CEXDATEINTERVAL OPTIONAL
    !IV_COSTCATEGORYNAME TYPE /AWS1/CEXCOSTCATEGORYNAME OPTIONAL
    !IO_FILTER TYPE REF TO /AWS1/CL_CEXEXPRESSION OPTIONAL
    !IT_SORTBY TYPE /AWS1/CL_CEXSORTDEFINITION=>TT_SORTDEFINITIONS OPTIONAL
    !IV_BILLINGVIEWARN TYPE /AWS1/CEXBILLINGVIEWARN OPTIONAL
    !IV_MAXRESULTS TYPE /AWS1/CEXMAXRESULTS OPTIONAL
    !IV_NEXTPAGETOKEN TYPE /AWS1/CEXNEXTPAGETOKEN OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_cexgetcostcatsrsp
  RAISING
    /AWS1/CX_CEXBILLEXPIREXCEPTION
    /AWS1/CX_CEXBLLVIEWHLTHSTATEX
    /AWS1/CX_CEXDATAUNAVAILEX
    /AWS1/CX_CEXINVALIDNEXTTOKENEX
    /AWS1/CX_CEXLIMITEXCEEDEDEX
    /AWS1/CX_CEXREQUESTCHANGEDEX
    /AWS1/CX_CEXRESOURCENOTFOUNDEX
    /AWS1/CX_CEXCLIENTEXC
    /AWS1/CX_CEXSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

io_timeperiod TYPE REF TO /AWS1/CL_CEXDATEINTERVAL /AWS1/CL_CEXDATEINTERVAL

TimePeriod

Optional arguments:

iv_searchstring TYPE /AWS1/CEXSEARCHSTRING /AWS1/CEXSEARCHSTRING

The value that you want to search the filter values for.

If you don't specify a CostCategoryName, SearchString is used to filter Cost Category names that match the SearchString pattern. If you specify a CostCategoryName, SearchString is used to filter Cost Category values that match the SearchString pattern.

iv_costcategoryname TYPE /AWS1/CEXCOSTCATEGORYNAME /AWS1/CEXCOSTCATEGORYNAME

CostCategoryName

io_filter TYPE REF TO /AWS1/CL_CEXEXPRESSION /AWS1/CL_CEXEXPRESSION

Filter

it_sortby TYPE /AWS1/CL_CEXSORTDEFINITION=>TT_SORTDEFINITIONS TT_SORTDEFINITIONS

The value that you sort the data by.

The key represents the cost and usage metrics. The following values are supported:

  • BlendedCost

  • UnblendedCost

  • AmortizedCost

  • NetAmortizedCost

  • NetUnblendedCost

  • UsageQuantity

  • NormalizedUsageAmount

The supported key values for the SortOrder value are ASCENDING and DESCENDING.

When you use the SortBy value, the NextPageToken and SearchString key values aren't supported.

iv_billingviewarn TYPE /AWS1/CEXBILLINGVIEWARN /AWS1/CEXBILLINGVIEWARN

The Amazon Resource Name (ARN) that uniquely identifies a specific billing view. The ARN is used to specify which particular billing view you want to interact with or retrieve information from when making API calls related to Amazon Web Services Billing and Cost Management features. The BillingViewArn can be retrieved by calling the ListBillingViews API.

iv_maxresults TYPE /AWS1/CEXMAXRESULTS /AWS1/CEXMAXRESULTS

This field is only used when the SortBy value is provided in the request.

The maximum number of objects that are returned for this request. If MaxResults isn't specified with the SortBy value, the request returns 1000 results as the default value for this parameter.

For GetCostCategories, MaxResults has an upper quota of 1000.

iv_nextpagetoken TYPE /AWS1/CEXNEXTPAGETOKEN /AWS1/CEXNEXTPAGETOKEN

If the number of objects that are still available for retrieval exceeds the quota, Amazon Web Services returns a NextPageToken value in the response. To retrieve the next batch of objects, provide the NextPageToken from the previous call in your next request.

RETURNING

oo_output TYPE REF TO /aws1/cl_cexgetcostcatsrsp /AWS1/CL_CEXGETCOSTCATSRSP

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->getcostcategories(
  io_filter = new /aws1/cl_cexexpression(
    io_costcategories = new /aws1/cl_cexcostcategoryvalues(
      it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
        ( new /aws1/cl_cexmatchoptions_w( |string| ) )
      )
      it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
        ( new /aws1/cl_cexvalues_w( |string| ) )
      )
      iv_key = |string|
    )
    io_dimensions = new /aws1/cl_cexdimensionvalues(
      it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
        ( new /aws1/cl_cexmatchoptions_w( |string| ) )
      )
      it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
        ( new /aws1/cl_cexvalues_w( |string| ) )
      )
      iv_key = |string|
    )
    io_not = new /aws1/cl_cexexpression(
      io_costcategories = new /aws1/cl_cexcostcategoryvalues(
        it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
          ( new /aws1/cl_cexmatchoptions_w( |string| ) )
        )
        it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
          ( new /aws1/cl_cexvalues_w( |string| ) )
        )
        iv_key = |string|
      )
      io_dimensions = new /aws1/cl_cexdimensionvalues(
        it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
          ( new /aws1/cl_cexmatchoptions_w( |string| ) )
        )
        it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
          ( new /aws1/cl_cexvalues_w( |string| ) )
        )
        iv_key = |string|
      )
      io_tags = new /aws1/cl_cextagvalues(
        it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
          ( new /aws1/cl_cexmatchoptions_w( |string| ) )
        )
        it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
          ( new /aws1/cl_cexvalues_w( |string| ) )
        )
        iv_key = |string|
      )
      it_and = VALUE /aws1/cl_cexexpression=>tt_expressions(
        (
          new /aws1/cl_cexexpression(
            io_costcategories = new /aws1/cl_cexcostcategoryvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_dimensions = new /aws1/cl_cexdimensionvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_tags = new /aws1/cl_cextagvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            it_or = VALUE /aws1/cl_cexexpression=>tt_expressions(
            )
          )
        )
      )
      it_or = VALUE /aws1/cl_cexexpression=>tt_expressions(
        (
          new /aws1/cl_cexexpression(
            io_costcategories = new /aws1/cl_cexcostcategoryvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_dimensions = new /aws1/cl_cexdimensionvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_tags = new /aws1/cl_cextagvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            it_and = VALUE /aws1/cl_cexexpression=>tt_expressions(
            )
          )
        )
      )
    )
    io_tags = new /aws1/cl_cextagvalues(
      it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
        ( new /aws1/cl_cexmatchoptions_w( |string| ) )
      )
      it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
        ( new /aws1/cl_cexvalues_w( |string| ) )
      )
      iv_key = |string|
    )
    it_and = VALUE /aws1/cl_cexexpression=>tt_expressions(
      (
        new /aws1/cl_cexexpression(
          io_costcategories = new /aws1/cl_cexcostcategoryvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          io_dimensions = new /aws1/cl_cexdimensionvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          io_not = new /aws1/cl_cexexpression(
            io_costcategories = new /aws1/cl_cexcostcategoryvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_dimensions = new /aws1/cl_cexdimensionvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_tags = new /aws1/cl_cextagvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            it_or = VALUE /aws1/cl_cexexpression=>tt_expressions(
            )
          )
          io_tags = new /aws1/cl_cextagvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          it_or = VALUE /aws1/cl_cexexpression=>tt_expressions(
          )
        )
      )
    )
    it_or = VALUE /aws1/cl_cexexpression=>tt_expressions(
      (
        new /aws1/cl_cexexpression(
          io_costcategories = new /aws1/cl_cexcostcategoryvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          io_dimensions = new /aws1/cl_cexdimensionvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          io_not = new /aws1/cl_cexexpression(
            io_costcategories = new /aws1/cl_cexcostcategoryvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_dimensions = new /aws1/cl_cexdimensionvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            io_tags = new /aws1/cl_cextagvalues(
              it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
                ( new /aws1/cl_cexmatchoptions_w( |string| ) )
              )
              it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
                ( new /aws1/cl_cexvalues_w( |string| ) )
              )
              iv_key = |string|
            )
            it_and = VALUE /aws1/cl_cexexpression=>tt_expressions(
            )
          )
          io_tags = new /aws1/cl_cextagvalues(
            it_matchoptions = VALUE /aws1/cl_cexmatchoptions_w=>tt_matchoptions(
              ( new /aws1/cl_cexmatchoptions_w( |string| ) )
            )
            it_values = VALUE /aws1/cl_cexvalues_w=>tt_values(
              ( new /aws1/cl_cexvalues_w( |string| ) )
            )
            iv_key = |string|
          )
          it_and = VALUE /aws1/cl_cexexpression=>tt_expressions(
          )
        )
      )
    )
  )
  io_timeperiod = new /aws1/cl_cexdateinterval(
    iv_end = |string|
    iv_start = |string|
  )
  it_sortby = VALUE /aws1/cl_cexsortdefinition=>tt_sortdefinitions(
    (
      new /aws1/cl_cexsortdefinition(
        iv_key = |string|
        iv_sortorder = |string|
      )
    )
  )
  iv_billingviewarn = |string|
  iv_costcategoryname = |string|
  iv_maxresults = 123
  iv_nextpagetoken = |string|
  iv_searchstring = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_nextpagetoken = lo_result->get_nextpagetoken( ).
  LOOP AT lo_result->get_costcategorynames( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_costcategoryname = lo_row_1->get_value( ).
    ENDIF.
  ENDLOOP.
  LOOP AT lo_result->get_costcategoryvalues( ) into lo_row_2.
    lo_row_3 = lo_row_2.
    IF lo_row_3 IS NOT INITIAL.
      lv_costcategoryvalue = lo_row_3->get_value( ).
    ENDIF.
  ENDLOOP.
  lv_pagesize = lo_result->get_returnsize( ).
  lv_pagesize = lo_result->get_totalsize( ).
ENDIF.