AgreementService / Paginator / SearchAgreements

SearchAgreements¶

class AgreementService.Paginator.SearchAgreements¶

paginator = client.get_paginator('search_agreements')

paginate(**kwargs)¶

Creates an iterator that will paginate through responses from AgreementService.Client.search_agreements().

Request Syntax

response_iterator = paginator.paginate(
    catalog='string',
    filters=[
        {
            'name': 'string',
            'values': [
                'string',
            ]
        },
    ],
    sort={
        'sortBy': 'string',
        'sortOrder': 'ASCENDING'|'DESCENDING'
    },
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

catalog (string) – The catalog in which the agreement was created.
filters (list) –
The filter name and value pair used to return a specific list of results.

The following filters are supported:
- ResourceIdentifier – The unique identifier of the resource.
- ResourceType – Type of the resource, which is the product ( AmiProduct, ContainerProduct, SaaSProduct, ProfessionalServicesProduct, or MachineLearningProduct).
- PartyType – The party type of the caller. Use Proposer or Acceptor.
- AcceptorAccountId – The AWS account ID of the party accepting the agreement terms.
- OfferId – The unique identifier of the offer in which the terms are registered in the agreement token.
- Status – The current status of the agreement. Values include ACTIVE, ARCHIVED, CANCELLED, EXPIRED, RENEWED, REPLACED, and TERMINATED.
- BeforeEndTime – A date used to filter agreements with a date before the endTime of an agreement.
- AfterEndTime – A date used to filter agreements with a date after the endTime of an agreement.
- AgreementType – The type of agreement. Supported value includes PurchaseAgreement.
- OfferSetId – A unique identifier for the offer set containing this offer. All agreements created from offers in this set include this identifier as context.
- (dict) –
  
  The filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria, such as offerId or productId.
  - name (string) –
    
    The name of the filter.
  - values (list) –
    
    The filter value.
    - (string) –
sort (dict) –
An object that contains the SortBy and SortOrder attributes. Only EndTime is supported for SearchAgreements. The default sort is EndTime descending.
- sortBy (string) –
  
  The attribute on which the data is grouped, which can be by StartTime and EndTime. The default value is EndTime.
- sortOrder (string) –
  
  The sorting order, which can be ASCENDING or DESCENDING. The default value is DESCENDING.
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

{
    'agreementViewSummaries': [
        {
            'agreementId': 'string',
            'acceptanceTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1),
            'endTime': datetime(2015, 1, 1),
            'agreementType': 'string',
            'acceptor': {
                'accountId': 'string'
            },
            'proposer': {
                'accountId': 'string'
            },
            'proposalSummary': {
                'resources': [
                    {
                        'id': 'string',
                        'type': 'string'
                    },
                ],
                'offerId': 'string',
                'offerSetId': 'string'
            },
            'status': 'ACTIVE'|'ARCHIVED'|'CANCELLED'|'EXPIRED'|'RENEWED'|'REPLACED'|'ROLLED_BACK'|'SUPERSEDED'|'TERMINATED'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- agreementViewSummaries (list) –
  
  A summary of the agreement, including top-level attributes (for example, the agreement ID, proposer, and acceptor).
  - (dict) –
    
    A summary of the agreement, including top-level attributes (for example, the agreement ID, proposer, and acceptor).
    - agreementId (string) –
      
      The unique identifier of the agreement.
    - acceptanceTime (datetime) –
      
      The date and time that the agreement was accepted.
    - startTime (datetime) –
      
      The date and time when the agreement starts.
    - endTime (datetime) –
      
      The date and time when the agreement ends. The field is null for pay-as-you-go agreements, which don’t have end dates.
    - agreementType (string) –
      
      The type of agreement.
    - acceptor (dict) –
      
      Details of the party accepting the agreement terms. This is commonly the buyer for PurchaseAgreement.
      - accountId (string) –
        
        The AWS account ID of the acceptor.
    - proposer (dict) –
      
      Details of the party proposing the agreement terms, most commonly the seller for PurchaseAgreement.
      - accountId (string) –
        
        The AWS account ID of the proposer.
    - proposalSummary (dict) –
      
      A summary of the proposal
      - resources (list) –
        
        The list of resources involved in the agreement.
        
        (dict) –
        
        The list of resources involved in the agreement.
        
        id (string) –
        
        The unique identifier of the resource.
        
        Note
        We mention the term resource, which is most commonly a product, so a resourceId is also a productId.
        
        type (string) –
        
        Type of the resource, which is the product (for example, SaaSProduct, AmiProduct, ContainerProduct).
      - offerId (string) –
        
        The unique identifier of the offer in AWS Marketplace.
      - offerSetId (string) –
        
        A unique identifier for the offer set containing this offer. All agreements created from offers in this set include this identifier as context.
    - status (string) –
      
      The current status of the agreement.
- NextToken (string) –
  
  A token to resume pagination.