UPDATEACCOUNTSETTINGS()`¶

About UpdateAccountSettings¶

Transitions your account to use TCUs for query pricing and modifies the maximum query compute units that you've configured. If you reduce the value of MaxQueryTCU to a desired configuration, the new value can take up to 24 hours to be effective.

After you've transitioned your account to use TCUs for query pricing, you can't transition to using bytes scanned for query pricing.

Method Signature¶

METHODS /AWS1/IF_TSQ~UPDATEACCOUNTSETTINGS
  IMPORTING
    !IV_MAXQUERYTCU TYPE /AWS1/TSQMAXQUERYCAPACITY OPTIONAL
    !IV_QUERYPRICINGMODEL TYPE /AWS1/TSQQUERYPRICINGMODEL OPTIONAL
    !IO_QUERYCOMPUTE TYPE REF TO /AWS1/CL_TSQQUERYCOMPUTEREQ OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_tsqupdateacctstgsrsp
  RAISING
    /AWS1/CX_TSQACCESSDENIEDEX
    /AWS1/CX_TSQINTERNALSERVEREX
    /AWS1/CX_TSQINVALIDENDPOINTEX
    /AWS1/CX_TSQTHROTTLINGEX
    /AWS1/CX_TSQVALIDATIONEX
    /AWS1/CX_TSQCLIENTEXC
    /AWS1/CX_TSQSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Optional arguments:¶

`iv_maxquerytcu` `TYPE /AWS1/TSQMAXQUERYCAPACITY` `/AWS1/TSQMAXQUERYCAPACITY`¶

The maximum number of compute units the service will use at any point in time to serve your queries. To run queries, you must set a minimum capacity of 4 TCU. You can set the maximum number of TCU in multiples of 4, for example, 4, 8, 16, 32, and so on. The maximum value supported for MaxQueryTCU is 1000. To request an increase to this soft limit, contact Amazon Web Services Support. For information about the default quota for maxQueryTCU, see Default quotas. This configuration is applicable only for on-demand usage of Timestream Compute Units (TCUs).

The maximum value supported for MaxQueryTCU is 1000. To request an increase to this soft limit, contact Amazon Web Services Support. For information about the default quota for maxQueryTCU, see Default quotas.

`iv_querypricingmodel` `TYPE /AWS1/TSQQUERYPRICINGMODEL` `/AWS1/TSQQUERYPRICINGMODEL`¶

The pricing model for queries in an account.

The QueryPricingModel parameter is used by several Timestream operations; however, the UpdateAccountSettings API operation doesn't recognize any values other than COMPUTE_UNITS.

`io_querycompute` `TYPE REF TO /AWS1/CL_TSQQUERYCOMPUTEREQ` `/AWS1/CL_TSQQUERYCOMPUTEREQ`¶

Modifies the query compute settings configured in your account, including the query pricing model and provisioned Timestream Compute Units (TCUs) in your account.

This API is idempotent, meaning that making the same request multiple times will have the same effect as making the request once.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_tsqupdateacctstgsrsp` `/AWS1/CL_TSQUPDATEACCTSTGSRSP`¶

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->updateaccountsettings(
  io_querycompute = new /aws1/cl_tsqquerycomputereq(
    io_provisionedcapacity = new /aws1/cl_tsqprovcaprequest(
      io_notificationconfiguration = new /aws1/cl_tsqacctstgsnotifconf(
        io_snsconfiguration = new /aws1/cl_tsqsnsconfiguration( |string| )
        iv_rolearn = |string|
      )
      iv_targetquerytcu = 123
    )
    iv_computemode = |string|
  )
  iv_maxquerytcu = 123
  iv_querypricingmodel = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_maxquerycapacity = lo_result->get_maxquerytcu( ).
  lv_querypricingmodel = lo_result->get_querypricingmodel( ).
  lo_querycomputeresponse = lo_result->get_querycompute( ).
  IF lo_querycomputeresponse IS NOT INITIAL.
    lv_computemode = lo_querycomputeresponse->get_computemode( ).
    lo_provisionedcapacityresp = lo_querycomputeresponse->get_provisionedcapacity( ).
    IF lo_provisionedcapacityresp IS NOT INITIAL.
      lv_querytcu = lo_provisionedcapacityresp->get_activequerytcu( ).
      lo_accountsettingsnotifica = lo_provisionedcapacityresp->get_notificationconf( ).
      IF lo_accountsettingsnotifica IS NOT INITIAL.
        lo_snsconfiguration = lo_accountsettingsnotifica->get_snsconfiguration( ).
        IF lo_snsconfiguration IS NOT INITIAL.
          lv_amazonresourcename = lo_snsconfiguration->get_topicarn( ).
        ENDIF.
        lv_amazonresourcename = lo_accountsettingsnotifica->get_rolearn( ).
      ENDIF.
      lo_lastupdate = lo_provisionedcapacityresp->get_lastupdate( ).
      IF lo_lastupdate IS NOT INITIAL.
        lv_querytcu = lo_lastupdate->get_targetquerytcu( ).
        lv_lastupdatestatus = lo_lastupdate->get_status( ).
        lv_string = lo_lastupdate->get_statusmessage( ).
      ENDIF.
    ENDIF.
  ENDIF.
ENDIF.

/AWS1/IF_TSQ=>UPDATEACCOUNTSETTINGS()¶