Skip to content

/AWS1/CL_FMSRESOURCESET

A set of resources to include in a policy.

CONSTRUCTOR

IMPORTING

Required arguments:

IV_NAME TYPE /AWS1/FMSNAME /AWS1/FMSNAME

The descriptive name of the resource set. You can't change the name of a resource set after you create it.

IT_RESOURCETYPELIST TYPE /AWS1/CL_FMSRESOURCETYPELIST_W=>TT_RESOURCETYPELIST TT_RESOURCETYPELIST

Determines the resources that can be associated to the resource set. Depending on your setting for max results and the number of resource sets, a single call might not return the full list.

Optional arguments:

IV_ID TYPE /AWS1/FMSBASE62ID /AWS1/FMSBASE62ID

A unique identifier for the resource set. This ID is returned in the responses to create and list commands. You provide it to operations like update and delete.

IV_DESCRIPTION TYPE /AWS1/FMSDESCRIPTION /AWS1/FMSDESCRIPTION

A description of the resource set.

IV_UPDATETOKEN TYPE /AWS1/FMSUPDATETOKEN /AWS1/FMSUPDATETOKEN

An optional token that you can use for optimistic locking. Firewall Manager returns a token to your requests that access the resource set. The token marks the state of the resource set resource at the time of the request. Update tokens are not allowed when creating a resource set. After creation, each subsequent update call to the resource set requires the update token.

To make an unconditional change to the resource set, omit the token in your update request. Without the token, Firewall Manager performs your updates regardless of whether the resource set has changed since you last retrieved it.

To make a conditional change to the resource set, provide the token in your update request. Firewall Manager uses the token to ensure that the resource set hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the resource set again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

IV_LASTUPDATETIME TYPE /AWS1/FMSTIMESTAMP /AWS1/FMSTIMESTAMP

The last time that the resource set was changed.

IV_RESOURCESETSTATUS TYPE /AWS1/FMSRESOURCESETSTATUS /AWS1/FMSRESOURCESETSTATUS

Indicates whether the resource set is in or out of an admin's Region scope.

  • ACTIVE - The administrator can manage and delete the resource set.

  • OUT_OF_ADMIN_SCOPE - The administrator can view the resource set, but they can't edit or delete the resource set. Existing protections stay in place. Any new resource that come into scope of the resource set won't be protected.


Queryable Attributes

Id

A unique identifier for the resource set. This ID is returned in the responses to create and list commands. You provide it to operations like update and delete.

Accessible with the following methods

Method Description
GET_ID() Getter for ID, with configurable default
ASK_ID() Getter for ID w/ exceptions if field has no value
HAS_ID() Determine if ID has a value

Name

The descriptive name of the resource set. You can't change the name of a resource set after you create it.

Accessible with the following methods

Method Description
GET_NAME() Getter for NAME, with configurable default
ASK_NAME() Getter for NAME w/ exceptions if field has no value
HAS_NAME() Determine if NAME has a value

Description

A description of the resource set.

Accessible with the following methods

Method Description
GET_DESCRIPTION() Getter for DESCRIPTION, with configurable default
ASK_DESCRIPTION() Getter for DESCRIPTION w/ exceptions if field has no value
HAS_DESCRIPTION() Determine if DESCRIPTION has a value

UpdateToken

An optional token that you can use for optimistic locking. Firewall Manager returns a token to your requests that access the resource set. The token marks the state of the resource set resource at the time of the request. Update tokens are not allowed when creating a resource set. After creation, each subsequent update call to the resource set requires the update token.

To make an unconditional change to the resource set, omit the token in your update request. Without the token, Firewall Manager performs your updates regardless of whether the resource set has changed since you last retrieved it.

To make a conditional change to the resource set, provide the token in your update request. Firewall Manager uses the token to ensure that the resource set hasn't changed since you last retrieved it. If it has changed, the operation fails with an InvalidTokenException. If this happens, retrieve the resource set again to get a current copy of it with a new token. Reapply your changes as needed, then try the operation again using the new token.

Accessible with the following methods

Method Description
GET_UPDATETOKEN() Getter for UPDATETOKEN, with configurable default
ASK_UPDATETOKEN() Getter for UPDATETOKEN w/ exceptions if field has no value
HAS_UPDATETOKEN() Determine if UPDATETOKEN has a value

ResourceTypeList

Determines the resources that can be associated to the resource set. Depending on your setting for max results and the number of resource sets, a single call might not return the full list.

Accessible with the following methods

Method Description
GET_RESOURCETYPELIST() Getter for RESOURCETYPELIST, with configurable default
ASK_RESOURCETYPELIST() Getter for RESOURCETYPELIST w/ exceptions if field has no va
HAS_RESOURCETYPELIST() Determine if RESOURCETYPELIST has a value

LastUpdateTime

The last time that the resource set was changed.

Accessible with the following methods

Method Description
GET_LASTUPDATETIME() Getter for LASTUPDATETIME, with configurable default
ASK_LASTUPDATETIME() Getter for LASTUPDATETIME w/ exceptions if field has no valu
HAS_LASTUPDATETIME() Determine if LASTUPDATETIME has a value

ResourceSetStatus

Indicates whether the resource set is in or out of an admin's Region scope.

  • ACTIVE - The administrator can manage and delete the resource set.

  • OUT_OF_ADMIN_SCOPE - The administrator can view the resource set, but they can't edit or delete the resource set. Existing protections stay in place. Any new resource that come into scope of the resource set won't be protected.

Accessible with the following methods

Method Description
GET_RESOURCESETSTATUS() Getter for RESOURCESETSTATUS, with configurable default
ASK_RESOURCESETSTATUS() Getter for RESOURCESETSTATUS w/ exceptions if field has no v
HAS_RESOURCESETSTATUS() Determine if RESOURCESETSTATUS has a value