Skip to content

/AWS1/CL_S3CMULTIREGIONACCPT04

A structure for a Multi-Region Access Point that indicates where Amazon S3 traffic can be routed. Routes can be either active or passive. Active routes can process Amazon S3 requests through the Multi-Region Access Point, but passive routes are not eligible to process Amazon S3 requests.

Each route contains the Amazon S3 bucket name and the Amazon Web Services Region that the bucket is located in. The route also includes the TrafficDialPercentage value, which shows whether the bucket and Region are active (indicated by a value of 100) or passive (indicated by a value of 0).

CONSTRUCTOR

IMPORTING

Required arguments:

IV_TRAFFICDIALPERCENTAGE TYPE /AWS1/S3CTRAFFICDIALPERCENTAGE /AWS1/S3CTRAFFICDIALPERCENTAGE

The traffic state for the specified bucket or Amazon Web Services Region.

A value of 0 indicates a passive state, which means that no new traffic will be routed to the Region.

A value of 100 indicates an active state, which means that traffic will be routed to the specified Region.

When the routing configuration for a Region is changed from active to passive, any in-progress operations (uploads, copies, deletes, and so on) to the formerly active Region will continue to run to until a final success or failure status is reached.

If all Regions in the routing configuration are designated as passive, you'll receive an InvalidRequest error.

Optional arguments:

IV_BUCKET TYPE /AWS1/S3CBUCKETNAME /AWS1/S3CBUCKETNAME

The name of the Amazon S3 bucket for which you'll submit a routing configuration change. Either the Bucket or the Region value must be provided. If both are provided, the bucket must be in the specified Region.

IV_REGION TYPE /AWS1/S3CREGIONNAME /AWS1/S3CREGIONNAME

The Amazon Web Services Region to which you'll be submitting a routing configuration change. Either the Bucket or the Region value must be provided. If both are provided, the bucket must be in the specified Region.

Queryable Attributes

Bucket

The name of the Amazon S3 bucket for which you'll submit a routing configuration change. Either the Bucket or the Region value must be provided. If both are provided, the bucket must be in the specified Region.

Accessible with the following methods

Method Description
GET_BUCKET() Getter for BUCKET, with configurable default
ASK_BUCKET() Getter for BUCKET w/ exceptions if field has no value
HAS_BUCKET() Determine if BUCKET has a value

Region

The Amazon Web Services Region to which you'll be submitting a routing configuration change. Either the Bucket or the Region value must be provided. If both are provided, the bucket must be in the specified Region.

Accessible with the following methods

Method Description
GET_REGION() Getter for REGION, with configurable default
ASK_REGION() Getter for REGION w/ exceptions if field has no value
HAS_REGION() Determine if REGION has a value

TrafficDialPercentage

The traffic state for the specified bucket or Amazon Web Services Region.

A value of 0 indicates a passive state, which means that no new traffic will be routed to the Region.

A value of 100 indicates an active state, which means that traffic will be routed to the specified Region.

When the routing configuration for a Region is changed from active to passive, any in-progress operations (uploads, copies, deletes, and so on) to the formerly active Region will continue to run to until a final success or failure status is reached.

If all Regions in the routing configuration are designated as passive, you'll receive an InvalidRequest error.

Accessible with the following methods

Method Description
GET_TRAFFICDIALPERCENTAGE() Getter for TRAFFICDIALPERCENTAGE, with configurable default
ASK_TRAFFICDIALPERCENTAGE() Getter for TRAFFICDIALPERCENTAGE w/ exceptions if field has
HAS_TRAFFICDIALPERCENTAGE() Determine if TRAFFICDIALPERCENTAGE has a value

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_ROUTELIST

TYPES TT_ROUTELIST TYPE STANDARD TABLE OF REF TO /AWS1/CL_S3CMULTIREGIONACCPT04 WITH DEFAULT KEY
.