FMS / Client / get_resource_set

get_resource_set#

FMS.Client.get_resource_set(**kwargs)#

Gets information about a specific resource set.

See also: AWS API Documentation

Request Syntax

response = client.get_resource_set(
    Identifier='string'
)
Parameters:

Identifier (string) –

[REQUIRED]

A unique identifier for the resource set, used in a request to refer to the resource set.

Return type:

dict

Returns:

Response Syntax

{
    'ResourceSet': {
        'Id': 'string',
        'Name': 'string',
        'Description': 'string',
        'UpdateToken': 'string',
        'ResourceTypeList': [
            'string',
        ],
        'LastUpdateTime': datetime(2015, 1, 1),
        'ResourceSetStatus': 'ACTIVE'|'OUT_OF_ADMIN_SCOPE'
    },
    'ResourceSetArn': 'string'
}

Response Structure

  • (dict) –

    • ResourceSet (dict) –

      Information about the specified resource set.

      • Id (string) –

        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.

      • Name (string) –

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

      • Description (string) –

        A description of the resource set.

      • UpdateToken (string) –

        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.

      • ResourceTypeList (list) –

        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.

        • (string) –

      • LastUpdateTime (datetime) –

        The last time that the resource set was changed.

      • ResourceSetStatus (string) –

        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.

    • ResourceSetArn (string) –

      The Amazon Resource Name (ARN) of the resource set.

Exceptions

  • FMS.Client.exceptions.InvalidOperationException

  • FMS.Client.exceptions.InvalidInputException

  • FMS.Client.exceptions.ResourceNotFoundException

  • FMS.Client.exceptions.InternalErrorException