Skip to content

ResourceSet

Source code in docs_src/capo_fms/types/resource_set.py
class ResourceSet(TypedDict, closed=True):
    id: NotRequired["capo_fms.types.base62_id.Base62Id"]
    """<p>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.</p>"""
    name: "capo_fms.types.name.Name"
    """<p>The descriptive name of the resource set. You can't change the name of a resource set after you create it.</p>"""
    description: NotRequired["capo_fms.types.description.Description"]
    """<p>A description of the resource set.</p>"""
    update_token: NotRequired["capo_fms.types.update_token.UpdateToken"]
    """<p>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. </p> <p>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.</p> <p>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 <code>InvalidTokenException</code>. 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. </p>"""
    resource_type_list: "capo_fms.types.resource_type_list.ResourceTypeList"
    """<p>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.</p>"""
    last_update_time: NotRequired["capo_fms.types.time_stamp.TimeStamp"]
    """<p>The last time that the resource set was changed.</p>"""
    resource_set_status: NotRequired[
        "capo_fms.types.resource_set_status.ResourceSetStatus"
    ]
    """<p>Indicates whether the resource set is in or out of an admin's Region scope.</p> <ul> <li> <p> <code>ACTIVE</code> - The administrator can manage and delete the resource set.</p> </li> <li> <p> <code>OUT_OF_ADMIN_SCOPE</code> - 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.</p> </li> </ul>"""

description instance-attribute

description: NotRequired[Description]

A description of the resource set.

id instance-attribute

id: NotRequired[Base62Id]

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.

last_update_time instance-attribute

last_update_time: NotRequired[TimeStamp]

The last time that the resource set was changed.

name instance-attribute

name: Name

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

resource_set_status instance-attribute

resource_set_status: NotRequired[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.

resource_type_list instance-attribute

resource_type_list: 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.

update_token instance-attribute

update_token: NotRequired[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.