/AWS1/IF_SHB=>GETRESOURCESV2()¶
About GetResourcesV2¶
Returns a list of resources.
You can use the Scopes parameter to define the data boundary for the query. Currently, Scopes supports AwsOrganizations, which lets you retrieve resources from your entire organization or from specific organizational units. Only the delegated administrator account can use Scopes.
You can use the Filters parameter to refine results based on resource attributes. You can use Scopes and Filters independently or together. When both are provided, Scopes narrows the data set first, and then Filters refines results within that scoped data set.
Method Signature¶
METHODS /AWS1/IF_SHB~GETRESOURCESV2
IMPORTING
!IO_FILTERS TYPE REF TO /AWS1/CL_SHBRESOURCESFILTERS OPTIONAL
!IO_SCOPES TYPE REF TO /AWS1/CL_SHBRESOURCESCOPES OPTIONAL
!IT_SORTCRITERIA TYPE /AWS1/CL_SHBSORTCRITERION=>TT_SORTCRITERIA OPTIONAL
!IV_NEXTTOKEN TYPE /AWS1/SHBNEXTTOKEN OPTIONAL
!IV_MAXRESULTS TYPE /AWS1/SHBMAXRESULTS OPTIONAL
RETURNING
VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_shbgetressv2response
RAISING
/AWS1/CX_SHBACCESSDENIEDEX
/AWS1/CX_SHBCONFLICTEXCEPTION
/AWS1/CX_SHBINTERNALSERVEREX
/AWS1/CX_SHBORGALUNITNOTFNDEX
/AWS1/CX_SHBORGNOTFOUNDEX
/AWS1/CX_SHBRESOURCENOTFOUNDEX
/AWS1/CX_SHBTHROTTLINGEX
/AWS1/CX_SHBVALIDATIONEX
/AWS1/CX_SHBCLIENTEXC
/AWS1/CX_SHBSERVEREXC
/AWS1/CX_RT_TECHNICAL_GENERIC
/AWS1/CX_RT_SERVICE_GENERIC.
IMPORTING¶
Optional arguments:¶
io_filters TYPE REF TO /AWS1/CL_SHBRESOURCESFILTERS /AWS1/CL_SHBRESOURCESFILTERS¶
Filters resources based on a set of criteria.
io_scopes TYPE REF TO /AWS1/CL_SHBRESOURCESCOPES /AWS1/CL_SHBRESOURCESCOPES¶
Limits the results to resources from specific organizational units or from the delegated administrator's organization. Only the delegated administrator account can use this parameter. Other accounts receive an
AccessDeniedException.This parameter is optional. If you omit it, the delegated administrator sees resources from all accounts across the entire organization. Other accounts see only their own resources.
You can specify up to 10 entries in
Scopes.AwsOrganizations. If multiple entries are specified, the entries are combined using OR logic.
it_sortcriteria TYPE /AWS1/CL_SHBSORTCRITERION=>TT_SORTCRITERIA TT_SORTCRITERIA¶
The resource attributes used to sort the list of returned resources.
iv_nexttoken TYPE /AWS1/SHBNEXTTOKEN /AWS1/SHBNEXTTOKEN¶
The token required for pagination. On your first call, set the value of this parameter to
NULL. For subsequent calls, to continue listing data, set the value of this parameter to the value returned in the previous response.
iv_maxresults TYPE /AWS1/SHBMAXRESULTS /AWS1/SHBMAXRESULTS¶
The maximum number of results to return.
RETURNING¶
oo_output TYPE REF TO /aws1/cl_shbgetressv2response /AWS1/CL_SHBGETRESSV2RESPONSE¶
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->getresourcesv2(
io_filters = new /aws1/cl_shbresourcesfilters(
it_compositefilters = VALUE /aws1/cl_shbresscompositefilt=>tt_resscompositefilterlist(
(
new /aws1/cl_shbresscompositefilt(
it_datefilters = VALUE /aws1/cl_shbressdatefilter=>tt_resourcesdatefilterlist(
(
new /aws1/cl_shbressdatefilter(
io_filter = new /aws1/cl_shbdatefilter(
io_daterange = new /aws1/cl_shbdaterange(
iv_unit = |string|
iv_value = 123
)
iv_end = |string|
iv_start = |string|
)
iv_fieldname = |string|
)
)
)
it_mapfilters = VALUE /aws1/cl_shbresourcesmapfilter=>tt_resourcesmapfilterlist(
(
new /aws1/cl_shbresourcesmapfilter(
io_filter = new /aws1/cl_shbmapfilter(
iv_comparison = |string|
iv_key = |string|
iv_value = |string|
)
iv_fieldname = |string|
)
)
)
it_nestedcompositefilters = VALUE /aws1/cl_shbresscompositefilt=>tt_resscompositefilterlist(
)
it_numberfilters = VALUE /aws1/cl_shbressnumberfilter=>tt_resourcesnumberfilterlist(
(
new /aws1/cl_shbressnumberfilter(
io_filter = new /aws1/cl_shbnumberfilter(
iv_eq = '0.1'
iv_gt = '0.1'
iv_gte = '0.1'
iv_lt = '0.1'
iv_lte = '0.1'
)
iv_fieldname = |string|
)
)
)
it_stringfilters = VALUE /aws1/cl_shbressstringfilter=>tt_resourcesstringfilterlist(
(
new /aws1/cl_shbressstringfilter(
io_filter = new /aws1/cl_shbstringfilter(
iv_comparison = |string|
iv_value = |string|
)
iv_fieldname = |string|
)
)
)
iv_operator = |string|
)
)
)
iv_compositeoperator = |string|
)
io_scopes = new /aws1/cl_shbresourcescopes(
it_awsorganizations = VALUE /aws1/cl_shbawsorgscope=>tt_awsorganizationscopelist(
(
new /aws1/cl_shbawsorgscope(
iv_organizationalunitid = |string|
iv_organizationid = |string|
)
)
)
)
it_sortcriteria = VALUE /aws1/cl_shbsortcriterion=>tt_sortcriteria(
(
new /aws1/cl_shbsortcriterion(
iv_field = |string|
iv_sortorder = |string|
)
)
)
iv_maxresults = 123
iv_nexttoken = |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_resources( ) into lo_row.
lo_row_1 = lo_row.
IF lo_row_1 IS NOT INITIAL.
lv_nonemptystring = lo_row_1->get_resourceguid( ).
lv_nonemptystring = lo_row_1->get_resourceid( ).
lv_nonemptystring = lo_row_1->get_accountid( ).
lv_nonemptystring = lo_row_1->get_region( ).
lv_resourcecategory = lo_row_1->get_resourcecategory( ).
lv_nonemptystring = lo_row_1->get_resourcetype( ).
lv_nonemptystring = lo_row_1->get_resourcename( ).
lv_nonemptystring = lo_row_1->get_resourcecreationtimedt( ).
lv_nonemptystring = lo_row_1->get_resdetailcapturetimedt( ).
LOOP AT lo_row_1->get_findingssummary( ) into lo_row_2.
lo_row_3 = lo_row_2.
IF lo_row_3 IS NOT INITIAL.
lv_nonemptystring = lo_row_3->get_findingtype( ).
lv_nonemptystring = lo_row_3->get_productname( ).
lv_integer = lo_row_3->get_totalfindings( ).
lo_resourceseveritybreakdo = lo_row_3->get_severities( ).
IF lo_resourceseveritybreakdo IS NOT INITIAL.
lv_integer = lo_resourceseveritybreakdo->get_other( ).
lv_integer = lo_resourceseveritybreakdo->get_fatal( ).
lv_integer = lo_resourceseveritybreakdo->get_critical( ).
lv_integer = lo_resourceseveritybreakdo->get_high( ).
lv_integer = lo_resourceseveritybreakdo->get_medium( ).
lv_integer = lo_resourceseveritybreakdo->get_low( ).
lv_integer = lo_resourceseveritybreakdo->get_informational( ).
lv_integer = lo_resourceseveritybreakdo->get_unknown( ).
ENDIF.
ENDIF.
ENDLOOP.
LOOP AT lo_row_1->get_resourcetags( ) into lo_row_4.
lo_row_5 = lo_row_4.
IF lo_row_5 IS NOT INITIAL.
lv_nonemptystring = lo_row_5->get_key( ).
lv_nonemptystring = lo_row_5->get_value( ).
ENDIF.
ENDLOOP.
lo_value = lo_row_1->get_resourceconfig( ).
IF lo_value IS NOT INITIAL.
ENDIF.
ENDIF.
ENDLOOP.
lv_nexttoken = lo_result->get_nexttoken( ).
ENDIF.