SupportAuthZ / Client / list_support_permit_requests

list_support_permit_requests

SupportAuthZ.Client.list_support_permit_requests(**kwargs)

Lists permit requests from AWS support operators. Use pagination to ensure that the operation returns quickly and successfully.

See also: AWS API Documentation

Request Syntax

response = client.list_support_permit_requests(
    nextToken='string',
    maxResults=123,
    supportCaseDisplayId='string'
)

Parameters:

• nextToken (string) – The token for the next page of results.

• maxResults (integer) – The maximum number of results to return in a single call. Valid range is 1 to 100.

• supportCaseDisplayId (string) – Filters the results by support case display identifier.

Return type:

dict

Returns:

Response Syntax

{
    'supportPermitRequests': [
        {
            'requestArn': 'string',
            'permit': {
                'actions': {
                    'allActions': {},
                    'actions': [
                        'string',
                    ]
                },
                'resources': {
                    'allResourcesInRegion': {},
                    'resources': [
                        'string',
                    ]
                },
                'conditions': [
                    {
                        'allowAfter': datetime(2015, 1, 1),
                        'allowBefore': datetime(2015, 1, 1)
                    },
                ]
            },
            'supportCaseDisplayId': 'string',
            'status': 'PENDING'|'ACCEPTED'|'REJECTED'|'CANCELLED',
            'createdAt': datetime(2015, 1, 1),
            'updatedAt': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) –

  • supportPermitRequests (list) –

    The list of permit requests.

    • (dict) –

      A permit request from an AWS support operator.

      • requestArn (string) –

        The ARN of the permit request.

      • permit (dict) –

        The permit definition requested by the operator.

        • actions (dict) –

          The set of actions that the support operator is authorized to perform.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: allActions, actions. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          

          • allActions (dict) –

            Authorizes all available support actions.

          • actions (list) –

            A list of specific support actions to authorize. Maximum of 10 actions.

            • (string) –

        • resources (dict) –

          The set of resources that the support operator is authorized to act upon.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: allResourcesInRegion, resources. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

          'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
          

          • allResourcesInRegion (dict) –

            Authorizes the support operator to act on all resources in the Region.

          • resources (list) –

            A list of specific resource identifiers that the support operator is authorized to act upon. Maximum of 5 resources.

            • (string) –

        • conditions (list) –

          The time-window conditions that constrain when the permit is valid. Maximum of 2 conditions.

          • (dict) –

            A time-window condition that constrains when a support permit is valid.

            Note

            This is a Tagged Union structure. Only one of the following top level keys will be set: allowAfter, allowBefore. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

            'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
            

            • allowAfter (datetime) –

              The earliest time at which the permit becomes valid.

            • allowBefore (datetime) –

              The latest time at which the permit remains valid.

      • supportCaseDisplayId (string) –

        The display identifier of the support case associated with the request.

      • status (string) –

        The current status of the permit request.

      • createdAt (datetime) –

        The timestamp when the request was created.

      • updatedAt (datetime) –

        The timestamp when the request was last updated.

  • nextToken (string) –

    The token for the next page of results, or null if there are no more results.

Exceptions

• SupportAuthZ.Client.exceptions.ValidationException

• SupportAuthZ.Client.exceptions.AccessDeniedException

• SupportAuthZ.Client.exceptions.ThrottlingException

• SupportAuthZ.Client.exceptions.InternalServerException