REMOVESTREAMGROUPLOCATIONS()`¶

About RemoveStreamGroupLocations¶

Removes a set of remote locations from this stream group. To remove a location, the stream group must be in ACTIVE status. When you remove a location, Amazon GameLift Streams releases allocated compute resources in that location. Stream sessions can no longer start from removed locations in a stream group. Amazon GameLift Streams also deletes the content files of all associated applications that were in Amazon GameLift Streams's internal Amazon S3 bucket at this location.

You cannot remove the Amazon Web Services Region location where you initially created this stream group, known as the primary location. However, you can set the stream capacity to zero to avoid incurring costs for allocated compute resources in that location.

Method Signature¶

METHODS /AWS1/IF_GMZ~REMOVESTREAMGROUPLOCATIONS
  IMPORTING
    !IV_IDENTIFIER TYPE /AWS1/GMZIDENTIFIER OPTIONAL
    !IT_LOCATIONS TYPE /AWS1/CL_GMZLOCATIONSLIST_W=>TT_LOCATIONSLIST OPTIONAL
  RAISING
    /AWS1/CX_GMZACCESSDENIEDEX
    /AWS1/CX_GMZINTERNALSERVEREX
    /AWS1/CX_GMZRESOURCENOTFOUNDEX
    /AWS1/CX_GMZTHROTTLINGEX
    /AWS1/CX_GMZVALIDATIONEX
    /AWS1/CX_GMZCLIENTEXC
    /AWS1/CX_GMZSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_identifier` `TYPE /AWS1/GMZIDENTIFIER` `/AWS1/GMZIDENTIFIER`¶

A stream group to remove the specified locations from.

This value is an Amazon Resource Name (ARN) or ID that uniquely identifies the stream group resource. Example ARN: arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4. Example ID: sg-1AB2C3De4.

`it_locations` `TYPE /AWS1/CL_GMZLOCATIONSLIST_W=>TT_LOCATIONSLIST` `TT_LOCATIONSLIST`¶

A set of locations to remove this stream group. For example, us-east-1.

For a complete list of locations that Amazon GameLift Streams supports, refer to Regions, quotas, and limitations in the Amazon GameLift Streams Developer Guide.

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.

lo_client->removestreamgrouplocations(
  it_locations = VALUE /aws1/cl_gmzlocationslist_w=>tt_locationslist(
    ( new /aws1/cl_gmzlocationslist_w( |string| ) )
  )
  iv_identifier = |string|
).

/AWS1/IF_GMZ=>REMOVESTREAMGROUPLOCATIONS()¶