/AWS1/IF_IOI=>UPDATEVEHICLE()

About UpdateVehicle

Updates a vehicle.

Access to certain Amazon Web Services IoT FleetWise features is currently gated. For more information, see Amazon Web Services Region and feature availability in the Amazon Web Services IoT FleetWise Developer Guide.

Method Signature

METHODS /AWS1/IF_IOI~UPDATEVEHICLE
  IMPORTING
    !IV_VEHICLENAME TYPE /AWS1/IOIVEHICLENAME OPTIONAL
    !IV_MODELMANIFESTARN TYPE /AWS1/IOIARN OPTIONAL
    !IV_DECODERMANIFESTARN TYPE /AWS1/IOIARN OPTIONAL
    !IT_ATTRIBUTES TYPE /AWS1/CL_IOIATTRIBUTESMAP_W=>TT_ATTRIBUTESMAP OPTIONAL
    !IV_ATTRIBUTEUPDATEMODE TYPE /AWS1/IOIUPDATEMODE OPTIONAL
    !IT_STATETEMPLATESTOADD TYPE /AWS1/CL_IOISTATETMPLASSOCIA00=>TT_STATETEMPLATEASSOCIATIONS OPTIONAL
    !IT_STATETEMPLATESTOREMOVE TYPE /AWS1/CL_IOISTATETMPLASSOCIA01=>TT_STATETEMPLATEASSOCIATIONIDS OPTIONAL
    !IT_STATETEMPLATESTOUPDATE TYPE /AWS1/CL_IOISTATETMPLASSOCIA00=>TT_STATETEMPLATEASSOCIATIONS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_ioiupdatevehiclersp
  RAISING
    /AWS1/CX_IOIINTERNALSERVEREX
    /AWS1/CX_IOIACCESSDENIEDEX
    /AWS1/CX_IOICONFLICTEXCEPTION
    /AWS1/CX_IOILIMITEXCEEDEDEX
    /AWS1/CX_IOIRESOURCENOTFOUNDEX
    /AWS1/CX_IOITHROTTLINGEX
    /AWS1/CX_IOIVALIDATIONEX
    /AWS1/CX_IOICLIENTEXC
    /AWS1/CX_IOISERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_vehiclename TYPE /AWS1/IOIVEHICLENAME /AWS1/IOIVEHICLENAME

The unique ID of the vehicle to update.

Optional arguments:

iv_modelmanifestarn TYPE /AWS1/IOIARN /AWS1/IOIARN

The ARN of a vehicle model (model manifest) associated with the vehicle.

iv_decodermanifestarn TYPE /AWS1/IOIARN /AWS1/IOIARN

The ARN of the decoder manifest associated with this vehicle.

it_attributes TYPE /AWS1/CL_IOIATTRIBUTESMAP_W=>TT_ATTRIBUTESMAP TT_ATTRIBUTESMAP

Static information about a vehicle in a key-value pair. For example:

"engineType" : "1.3 L R2"

iv_attributeupdatemode TYPE /AWS1/IOIUPDATEMODE /AWS1/IOIUPDATEMODE

The method the specified attributes will update the existing attributes on the vehicle. UseOverwite to replace the vehicle attributes with the specified attributes. Or use Merge to combine all attributes.

This is required if attributes are present in the input.

it_statetemplatestoadd TYPE /AWS1/CL_IOISTATETMPLASSOCIA00=>TT_STATETEMPLATEASSOCIATIONS TT_STATETEMPLATEASSOCIATIONS

Associate state templates with the vehicle.

it_statetemplatestoremove TYPE /AWS1/CL_IOISTATETMPLASSOCIA01=>TT_STATETEMPLATEASSOCIATIONIDS TT_STATETEMPLATEASSOCIATIONIDS

Remove state templates from the vehicle.

it_statetemplatestoupdate TYPE /AWS1/CL_IOISTATETMPLASSOCIA00=>TT_STATETEMPLATEASSOCIATIONS TT_STATETEMPLATEASSOCIATIONS

Change the stateTemplateUpdateStrategy of state templates already associated with the vehicle.

RETURNING

oo_output TYPE REF TO /aws1/cl_ioiupdatevehiclersp /AWS1/CL_IOIUPDATEVEHICLERSP

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->updatevehicle(
  it_attributes = VALUE /aws1/cl_ioiattributesmap_w=>tt_attributesmap(
    (
      VALUE /aws1/cl_ioiattributesmap_w=>ts_attributesmap_maprow(
        value = new /aws1/cl_ioiattributesmap_w( |string| )
        key = |string|
      )
    )
  )
  it_statetemplatestoadd = VALUE /aws1/cl_ioistatetmplassocia00=>tt_statetemplateassociations(
    (
      new /aws1/cl_ioistatetmplassocia00(
        io_statetmplupdatestrategy = new /aws1/cl_ioistatetmplupdstrag(
          io_onchange = new /aws1/cl_ioionchangestatetmp00( )
          io_periodic = new /aws1/cl_ioipericstatetmplup00(
            io_statetemplateupdaterate = new /aws1/cl_ioitimeperiod(
              iv_unit = |string|
              iv_value = 123
            )
          )
        )
        iv_identifier = |string|
      )
    )
  )
  it_statetemplatestoremove = VALUE /aws1/cl_ioistatetmplassocia01=>tt_statetemplateassociationids(
    ( new /aws1/cl_ioistatetmplassocia01( |string| ) )
  )
  it_statetemplatestoupdate = VALUE /aws1/cl_ioistatetmplassocia00=>tt_statetemplateassociations(
    (
      new /aws1/cl_ioistatetmplassocia00(
        io_statetmplupdatestrategy = new /aws1/cl_ioistatetmplupdstrag(
          io_onchange = new /aws1/cl_ioionchangestatetmp00( )
          io_periodic = new /aws1/cl_ioipericstatetmplup00(
            io_statetemplateupdaterate = new /aws1/cl_ioitimeperiod(
              iv_unit = |string|
              iv_value = 123
            )
          )
        )
        iv_identifier = |string|
      )
    )
  )
  iv_attributeupdatemode = |string|
  iv_decodermanifestarn = |string|
  iv_modelmanifestarn = |string|
  iv_vehiclename = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_vehiclename = lo_result->get_vehiclename( ).
  lv_arn = lo_result->get_arn( ).
ENDIF.