SearchAgreementsInput
¶
Source code in docs_src/capo_marketplace_agreement/types/search_agreements_input.py
catalog
instance-attribute
¶
catalog: NotRequired[Catalog]
The catalog in which the agreement was created.
filters
instance-attribute
¶
filters: NotRequired[FilterList]
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, orMachineLearningProduct). -
PartyType– The party type of the caller. UseProposerorAcceptor. -
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 includeACTIVE,CANCELLED,EXPIRED,RENEWED,REPLACED, andTERMINATED. -
BeforeEndTime– A date used to filter agreements with a date before theendTimeof an agreement. -
AfterEndTime– A date used to filter agreements with a date after theendTimeof an agreement. -
BeforeStartTime– A date used to filter agreements with a date before thestartTimeof an agreement. -
AfterStartTime– A date used to filter agreements with a date after thestartTimeof an agreement. -
BeforeLastUpdateTime– A date used to filter agreements with a date before thelastUpdateTimeof an agreement. -
AfterLastUpdateTime– A date used to filter agreements with a date after thelastUpdateTimeof an agreement. -
AgreementType– The type of agreement. Supported value includesPurchaseAgreement. -
OfferSetId– A unique identifier for the offer set containing this offer. All agreements created from offers in this set include this identifier as context. -
EndTimeBehaviorType– What happens to the agreement when it reaches its end date. Values includeRENEW,REPLACE, andEXPIRE. -
EndTimeBehaviorReasonCode– The reason why the agreement doesn't renew at its end date. Values includePROPOSER_RENEW_OPTED_OUT,ACCEPTOR_RENEW_OPTED_OUT,NO_RENEWAL_TERM, andRENEWAL_LIMIT_EXHAUSTED. -
InitialAgreementId– The unique identifier of the very first agreement in a chain of related agreements. Use this filter to return every agreement in the same chain. -
LicenseArn– The Amazon Resource Name (ARN) of the AWS License Manager license associated with an entitlement granted by the agreement.
A proposer can use any combination of the preceding filters along with AgreementType, which is required.
The following filter combinations are supported when the PartyType is Acceptor:
-
AgreementType -
AgreementType+Status -
AgreementType+EndTime -
AgreementType+Status+EndTime -
AgreementType+ResourceIdentifier -
AgreementType+ResourceIdentifier+EndTime -
AgreementType+ResourceIdentifier+Status -
AgreementType+ResourceIdentifier+Status+EndTime -
AgreementType+ResourceType -
AgreementType+ResourceType+EndTime -
AgreementType+OfferId -
AgreementType+OfferId+EndTime -
AgreementType+OfferId+Status -
AgreementType+OfferId+Status+EndTime -
AgreementType+OfferSetId -
AgreementType+OfferSetId+EndTime -
AgreementType+OfferSetId+Status -
AgreementType+OfferSetId+Status+EndTime
To filter by EndTime, you can use BeforeEndTime, AfterEndTime, or both.
max_results
instance-attribute
¶
max_results: NotRequired[MaxResults]
The maximum number of agreements to return in the response.