ASSOCIATERESOURCE()`¶

About AssociateResource¶

Associates a resource with an application. The resource can be specified by its ARN or name. The application can be specified by ARN, ID, or name.

Minimum permissions

You must have the following permissions to associate a resource using the OPTIONS parameter set to APPLY_APPLICATION_TAG.

tag:GetResources
tag:TagResources

You must also have these additional permissions if you don't use the AWSServiceCatalogAppRegistryFullAccess policy. For more information, see AWSServiceCatalogAppRegistryFullAccess in the AppRegistry Administrator Guide.

resource-groups:AssociateResource
cloudformation:UpdateStack
cloudformation:DescribeStacks

In addition, you must have the tagging permission defined by the Amazon Web Services service that creates the resource. For more information, see TagResources in the Resource Groups Tagging API Reference.

Method Signature¶

METHODS /AWS1/IF_SCA~ASSOCIATERESOURCE
  IMPORTING
    !IV_APPLICATION TYPE /AWS1/SCAAPPLICATIONSPECIFIER OPTIONAL
    !IV_RESOURCETYPE TYPE /AWS1/SCARESOURCETYPE OPTIONAL
    !IV_RESOURCE TYPE /AWS1/SCARESOURCESPECIFIER OPTIONAL
    !IT_OPTIONS TYPE /AWS1/CL_SCAOPTIONS_W=>TT_OPTIONS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_scaassocresourcersp
  RAISING
    /AWS1/CX_SCACONFLICTEXCEPTION
    /AWS1/CX_SCAINTERNALSERVEREX
    /AWS1/CX_SCARESOURCENOTFOUNDEX
    /AWS1/CX_SCASERVICEQUOTAEXCDEX
    /AWS1/CX_SCATHROTTLINGEX
    /AWS1/CX_SCAVALIDATIONEX
    /AWS1/CX_SCACLIENTEXC
    /AWS1/CX_SCASERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_application` `TYPE /AWS1/SCAAPPLICATIONSPECIFIER` `/AWS1/SCAAPPLICATIONSPECIFIER`¶

The name, ID, or ARN of the application.

`iv_resourcetype` `TYPE /AWS1/SCARESOURCETYPE` `/AWS1/SCARESOURCETYPE`¶

The type of resource of which the application will be associated.

`iv_resource` `TYPE /AWS1/SCARESOURCESPECIFIER` `/AWS1/SCARESOURCESPECIFIER`¶

The name or ID of the resource of which the application will be associated.

Optional arguments:¶

`it_options` `TYPE /AWS1/CL_SCAOPTIONS_W=>TT_OPTIONS` `TT_OPTIONS`¶

Determines whether an application tag is applied or skipped.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_scaassocresourcersp` `/AWS1/CL_SCAASSOCRESOURCERSP`¶

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->associateresource(
  it_options = VALUE /aws1/cl_scaoptions_w=>tt_options(
    ( new /aws1/cl_scaoptions_w( |string| ) )
  )
  iv_application = |string|
  iv_resource = |string|
  iv_resourcetype = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_applicationarn = lo_result->get_applicationarn( ).
  lv_arn = lo_result->get_resourcearn( ).
  LOOP AT lo_result->get_options( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_associationoption = lo_row_1->get_value( ).
    ENDIF.
  ENDLOOP.
ENDIF.

/AWS1/IF_SCA=>ASSOCIATERESOURCE()¶