PartnerCentralSellingAPI / Paginator / ListEngagementByAcceptingInvitationTasks

ListEngagementByAcceptingInvitationTasks

class PartnerCentralSellingAPI.Paginator.ListEngagementByAcceptingInvitationTasks

paginator = client.get_paginator('list_engagement_by_accepting_invitation_tasks')

paginate(**kwargs)

Creates an iterator that will paginate through responses from PartnerCentralSellingAPI.Client.list_engagement_by_accepting_invitation_tasks().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Catalog='string',
    EngagementInvitationIdentifier=[
        'string',
    ],
    OpportunityIdentifier=[
        'string',
    ],
    Sort={
        'SortBy': 'StartTime',
        'SortOrder': 'ASCENDING'|'DESCENDING'
    },
    TaskIdentifier=[
        'string',
    ],
    TaskStatus=[
        'IN_PROGRESS'|'COMPLETE'|'FAILED',
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

• Catalog (string) –

  [REQUIRED]

  Specifies the catalog related to the request. Valid values are:

  • AWS: Retrieves the request from the production AWS environment.

  • Sandbox: Retrieves the request from a sandbox environment used for testing or development purposes.

• EngagementInvitationIdentifier (list) –

  Filters tasks by the identifiers of the engagement invitations they are processing.

  • (string) –

• OpportunityIdentifier (list) –

  Filters tasks by the identifiers of the opportunities they created or are associated with.

  • (string) –

• Sort (dict) –

  Specifies the sorting criteria for the returned results. This allows you to order the tasks based on specific attributes.

  • SortBy (string) – [REQUIRED]

    Specifies the field by which the task list should be sorted.

  • SortOrder (string) – [REQUIRED]

    Determines the order in which the sorted results are presented.

• TaskIdentifier (list) –

  Filters tasks by their unique identifiers. Use this when you want to retrieve information about specific tasks.

  • (string) –

• TaskStatus (list) –

  Filters the tasks based on their current status. This allows you to focus on tasks in specific states.

  • (string) –

• PaginationConfig (dict) –

  A dictionary that provides parameters to control pagination.

  • MaxItems (integer) –

    The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

  • PageSize (integer) –

    The size of each page.

  • StartingToken (string) –

    A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'TaskSummaries': [
        {
            'EngagementInvitationId': 'string',
            'Message': 'string',
            'OpportunityId': 'string',
            'ReasonCode': 'InvitationAccessDenied'|'InvitationValidationFailed'|'EngagementAccessDenied'|'OpportunityAccessDenied'|'ResourceSnapshotJobAccessDenied'|'ResourceSnapshotJobValidationFailed'|'ResourceSnapshotJobConflict'|'EngagementValidationFailed'|'EngagementConflict'|'OpportunitySubmissionFailed'|'EngagementInvitationConflict'|'InternalError'|'OpportunityValidationFailed'|'OpportunityConflict'|'ResourceSnapshotAccessDenied'|'ResourceSnapshotValidationFailed'|'ResourceSnapshotConflict'|'ServiceQuotaExceeded'|'RequestThrottled',
            'ResourceSnapshotJobId': 'string',
            'StartTime': datetime(2015, 1, 1),
            'TaskArn': 'string',
            'TaskId': 'string',
            'TaskStatus': 'IN_PROGRESS'|'COMPLETE'|'FAILED'
        },
    ]
}

Response Structure

• (dict) –

  • TaskSummaries (list) –

    An array of EngagementByAcceptingInvitationTaskSummary objects, each representing a task that matches the specified filters. The array may be empty if no tasks match the criteria.

    • (dict) –

      Specifies a subset of fields associated with tasks related to accepting an engagement invitation.

      • EngagementInvitationId (string) –

        The unique identifier of the engagement invitation that was accepted.

      • Message (string) –

        Detailed message describing the failure and possible recovery steps.

      • OpportunityId (string) –

        Unique identifier of opportunity that was created.

      • ReasonCode (string) –

        A code pointing to the specific reason for the failure.

      • ResourceSnapshotJobId (string) –

        Unique identifier of the resource snapshot job that was created.

      • StartTime (datetime) –

        Task start timestamp.

      • TaskArn (string) –

        The Amazon Resource Name (ARN) that uniquely identifies the task.

      • TaskId (string) –

        Unique identifier of the task.

      • TaskStatus (string) –

        Status of the task.