2026/09/01 - AWS Marketplace Discovery - 4 updated api methods
Changes GetOfferTerms now returns renewalTerm for offers with pre-authorized renewals, exposing maxRenewals, lockoutPeriod, adjustmentDeadline, priceIncrease (fixed percentage or percentage range), and termTemplates (renewal payment schedules). Enables buyers to view renewal pricing and terms.
{'badges': {'badgeType': {'AUTO_RENEW'}}}
Provides details about an offer, such as the pricing model, seller of record, availability dates, badges, and associated products.
See also: AWS API Documentation
Request Syntax
client.get_offer(
offerId='string'
)
string
[REQUIRED]
The unique identifier of the offer to retrieve.
dict
Response Syntax
{
'offerId': 'string',
'catalog': 'string',
'offerName': 'string',
'expirationTime': datetime(2015, 1, 1),
'availableFromTime': datetime(2015, 1, 1),
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
},
'associatedEntities': [
{
'product': {
'productId': 'string',
'productName': 'string',
'manufacturer': {
'sellerProfileId': 'string',
'displayName': 'string'
}
},
'offerSet': {
'offerSetId': 'string',
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
}
}
},
],
'agreementProposalId': 'string',
'replacementAgreementId': 'string',
'pricingModel': {
'pricingModelType': 'USAGE'|'CONTRACT'|'BYOL'|'FREE',
'displayName': 'string'
},
'badges': [
{
'displayName': 'string',
'badgeType': 'PRIVATE_PRICING'|'FUTURE_DATED'|'REPLACEMENT_OFFER'|'AUTO_RENEW'
},
]
}
Response Structure
(dict) --
offerId (string) --
The unique identifier of the offer.
catalog (string) --
The name of the catalog that the offer belongs to.
offerName (string) --
The display name of the offer. This is free-form text provided by the seller.
expirationTime (datetime) --
The date and time until when the offer can be procured. This value is null for offers that never expire.
availableFromTime (datetime) --
The date and time when the offer became available to the buyer.
sellerOfRecord (dict) --
The entity responsible for selling the product under this offer.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
associatedEntities (list) --
The products and offer sets associated with this offer.
(dict) --
A product and optional offer set associated with an offer.
product (dict) --
Information about the product associated with the offer.
productId (string) --
The unique identifier of the product.
productName (string) --
The human-readable display name of the product.
manufacturer (dict) --
The entity who manufactured the product.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
offerSet (dict) --
Information about the offer set, if the offer is part of a bundled offer set.
offerSetId (string) --
The unique identifier of the offer set.
sellerOfRecord (dict) --
The entity responsible for selling the products under this offer set.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
agreementProposalId (string) --
An encoded string to be passed by the acceptor of the terms when creating an agreement.
replacementAgreementId (string) --
The identifier of the existing agreement that this offer would replace. Enables agreement-based offer functionality.
pricingModel (dict) --
The pricing model that determines how buyers are charged, such as usage-based, contract, BYOL, or free.
pricingModelType (string) --
The machine-readable type of the pricing model.
displayName (string) --
The human-readable name of the pricing model.
badges (list) --
Badges indicating special attributes of the offer, such as private pricing, future dated, or replacement offer.
(dict) --
A badge indicating a special attribute of a purchase option, such as private pricing or future dated.
displayName (string) --
The human-readable name of the badge.
badgeType (string) --
The machine-readable type of the badge.
{'badges': {'badgeType': {'AUTO_RENEW'}}}
Provides details about an offer set, which is a bundle of offers across multiple products. Includes the seller, availability dates, buyer notes, and associated product-offer pairs.
See also: AWS API Documentation
Request Syntax
client.get_offer_set(
offerSetId='string'
)
string
[REQUIRED]
The unique identifier of the offer set to retrieve.
dict
Response Syntax
{
'offerSetId': 'string',
'catalog': 'string',
'offerSetName': 'string',
'availableFromTime': datetime(2015, 1, 1),
'expirationTime': datetime(2015, 1, 1),
'buyerNotes': 'string',
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
},
'badges': [
{
'displayName': 'string',
'badgeType': 'PRIVATE_PRICING'|'FUTURE_DATED'|'REPLACEMENT_OFFER'|'AUTO_RENEW'
},
],
'associatedEntities': [
{
'product': {
'productId': 'string',
'productName': 'string',
'manufacturer': {
'sellerProfileId': 'string',
'displayName': 'string'
}
},
'offer': {
'offerId': 'string',
'offerName': 'string',
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
}
}
},
]
}
Response Structure
(dict) --
offerSetId (string) --
The unique identifier of the offer set.
catalog (string) --
The name of the catalog that the offer set belongs to.
offerSetName (string) --
The display name of the offer set.
availableFromTime (datetime) --
The date and time when the offer set became available to the buyer.
expirationTime (datetime) --
The date and time when the offer set expires and is no longer available for procurement.
buyerNotes (string) --
Detailed information about the offer set that helps buyers understand its purpose and contents.
sellerOfRecord (dict) --
The entity responsible for selling the products under this offer set.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
badges (list) --
Badges indicating special attributes of the offer set, such as private pricing or future dated.
(dict) --
A badge indicating a special attribute of a purchase option, such as private pricing or future dated.
displayName (string) --
The human-readable name of the badge.
badgeType (string) --
The machine-readable type of the badge.
associatedEntities (list) --
The products and offers included in this offer set.
(dict) --
A product and offer associated with an offer set.
product (dict) --
Information about the product associated with the offer set.
productId (string) --
The unique identifier of the product.
productName (string) --
The human-readable display name of the product.
manufacturer (dict) --
The entity who manufactured the product.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
offer (dict) --
Information about the offer associated with the offer set.
offerId (string) --
The unique identifier of the offer.
offerName (string) --
The display name of the offer.
sellerOfRecord (dict) --
The entity responsible for selling the product under this offer.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
{'offerTerms': {'renewalTerm': {'adjustmentDeadline': 'string',
'lockoutPeriod': 'string',
'maxRenewals': 'integer',
'priceIncrease': {'fixedPercentage': {'percentageValue': 'string'},
'percentageRange': {'defaultValue': 'string',
'maximumValue': 'string',
'minimumValue': 'string'}},
'termTemplates': [{'paymentScheduleTermTemplate': {'schedule': [{'chargeDateOffset': 'string',
'chargePercentage': 'string',
'dayOfMonth': 'integer'}]}}]}}}
Returns the terms attached to an offer, such as pricing terms (usage-based, contract, BYOL, free trial), legal terms, payment schedules, validity terms, support terms, and renewal terms.
See also: AWS API Documentation
Request Syntax
client.get_offer_terms(
offerId='string',
maxResults=123,
nextToken='string'
)
string
[REQUIRED]
The unique identifier of the offer whose terms to retrieve.
integer
The maximum number of results that are returned per call. You can use nextToken to get more results.
string
If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page.
dict
Response Syntax
{
'offerTerms': [
{
'byolPricingTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm'
},
'configurableUpfrontPricingTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'rateCards': [
{
'selector': {
'type': 'Duration',
'value': 'string'
},
'constraints': {
'multipleDimensionSelection': 'Allowed'|'Disallowed',
'quantityConfiguration': 'Allowed'|'Disallowed'
},
'rateCard': [
{
'dimensionKey': 'string',
'displayName': 'string',
'description': 'string',
'dimensionLabels': [
{
'labelType': 'Region'|'SagemakerOption',
'labelValue': 'string',
'displayName': 'string'
},
],
'unit': 'string',
'price': 'string'
},
]
},
]
},
'fixedUpfrontPricingTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'duration': 'string',
'price': 'string',
'grants': [
{
'dimensionKey': 'string',
'displayName': 'string',
'description': 'string',
'dimensionLabels': [
{
'labelType': 'Region'|'SagemakerOption',
'labelValue': 'string',
'displayName': 'string'
},
],
'unit': 'string',
'maxQuantity': 123
},
]
},
'freeTrialPricingTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'duration': 'string',
'grants': [
{
'dimensionKey': 'string',
'displayName': 'string',
'description': 'string',
'dimensionLabels': [
{
'labelType': 'Region'|'SagemakerOption',
'labelValue': 'string',
'displayName': 'string'
},
],
'unit': 'string',
'maxQuantity': 123
},
]
},
'legalTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'documents': [
{
'type': 'CustomEula'|'CustomDsa'|'EnterpriseEula'|'StandardEula'|'StandardDsa',
'url': 'string',
'version': 'string'
},
]
},
'paymentScheduleTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'schedule': [
{
'chargeDate': datetime(2015, 1, 1),
'chargeAmount': 'string'
},
]
},
'recurringPaymentTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'billingPeriod': 'Monthly',
'price': 'string'
},
'renewalTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'maxRenewals': 123,
'lockoutPeriod': 'string',
'adjustmentDeadline': 'string',
'priceIncrease': {
'fixedPercentage': {
'percentageValue': 'string'
},
'percentageRange': {
'minimumValue': 'string',
'maximumValue': 'string',
'defaultValue': 'string'
}
},
'termTemplates': [
{
'paymentScheduleTermTemplate': {
'schedule': [
{
'chargeDateOffset': 'string',
'chargePercentage': 'string',
'dayOfMonth': 123
},
]
}
},
]
},
'supportTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'refundPolicy': 'string'
},
'usageBasedPricingTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'rateCards': [
{
'rateCard': [
{
'dimensionKey': 'string',
'displayName': 'string',
'description': 'string',
'dimensionLabels': [
{
'labelType': 'Region'|'SagemakerOption',
'labelValue': 'string',
'displayName': 'string'
},
],
'unit': 'string',
'price': 'string'
},
]
},
]
},
'validityTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'agreementDuration': 'string',
'agreementEndDate': datetime(2015, 1, 1),
'agreementStartDate': datetime(2015, 1, 1)
},
'variablePaymentTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'currencyCode': 'string',
'maxTotalChargeAmount': 'string'
},
'netPaymentTerm': {
'id': 'string',
'type': 'ByolPricingTerm'|'ConfigurableUpfrontPricingTerm'|'FixedUpfrontPricingTerm'|'UsageBasedPricingTerm'|'FreeTrialPricingTerm'|'LegalTerm'|'PaymentScheduleTerm'|'RecurringPaymentTerm'|'RenewalTerm'|'SupportTerm'|'ValidityTerm'|'VariablePaymentTerm'|'NetPaymentTerm',
'paymentDuePeriod': 'string'
}
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
offerTerms (list) --
The terms attached to the offer. Each element contains exactly one term type.
(dict) --
A term attached to an offer. Each element contains exactly one term type, such as a pricing term, legal term, or payment schedule term.
byolPricingTerm (dict) --
Defines a Bring Your Own License (BYOL) pricing term, where buyers use their existing license for the product.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
configurableUpfrontPricingTerm (dict) --
Defines a configurable upfront pricing term with selectable rate cards, where buyers choose from predefined pricing configurations.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
rateCards (list) --
The rate cards available for selection, each with a selector, constraints, and per-unit rates.
(dict) --
A rate card item within a configurable upfront pricing term, including a selector for choosing the configuration and per-unit rates.
selector (dict) --
The selector criteria for this rate card, such as duration.
type (string) --
The category of the selector, such as Duration.
value (string) --
The value of the selector.
constraints (dict) --
Constraints on how the buyer can configure this rate card, such as whether multiple dimensions can be selected.
multipleDimensionSelection (string) --
Whether the buyer can select multiple dimensions. Values are Allowed or Disallowed.
quantityConfiguration (string) --
Whether the buyer can configure quantities. Values are Allowed or Disallowed.
rateCard (list) --
The per-unit rates for this configuration.
(dict) --
A per-unit rate within a rate card, defining the price for a specific dimension.
dimensionKey (string) --
The machine-readable key identifying the dimension being priced.
displayName (string) --
The human-readable name of the dimension.
description (string) --
A description of the dimension being priced.
dimensionLabels (list) --
Labels used to categorize this dimension, such as by region.
(dict) --
A label used to group or categorize pricing dimensions, such as by region or SageMaker option.
labelType (string) --
The type of the dimension label, such as Region or SagemakerOption.
labelValue (string) --
The value used to group dimensions together.
displayName (string) --
The human-readable display name of the label.
unit (string) --
The unit of measurement for the dimension.
price (string) --
The price per unit for the dimension.
fixedUpfrontPricingTerm (dict) --
Defines a fixed upfront pricing term with a pre-paid amount and granted entitlements.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
duration (string) --
The duration of the fixed pricing term, in ISO 8601 format.
price (string) --
The price charged upfront for this term.
grants (list) --
The entitlements granted to the buyer as part of this term.
(dict) --
An entitlement granted to the buyer as part of a pricing term.
dimensionKey (string) --
The machine-readable key identifying the entitlement dimension.
displayName (string) --
The human-readable name of the entitlement dimension.
description (string) --
A description of the entitlement.
dimensionLabels (list) --
Labels used to categorize this entitlement, such as by region.
(dict) --
A label used to group or categorize pricing dimensions, such as by region or SageMaker option.
labelType (string) --
The type of the dimension label, such as Region or SagemakerOption.
labelValue (string) --
The value used to group dimensions together.
displayName (string) --
The human-readable display name of the label.
unit (string) --
The unit of measurement for the entitlement.
maxQuantity (integer) --
The maximum quantity of the entitlement that can be granted.
freeTrialPricingTerm (dict) --
Defines a free trial pricing term that enables customers to try the product before purchasing.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
duration (string) --
The duration of the free trial period.
grants (list) --
The entitlements granted to the buyer during the free trial.
(dict) --
An entitlement granted to the buyer as part of a pricing term.
dimensionKey (string) --
The machine-readable key identifying the entitlement dimension.
displayName (string) --
The human-readable name of the entitlement dimension.
description (string) --
A description of the entitlement.
dimensionLabels (list) --
Labels used to categorize this entitlement, such as by region.
(dict) --
A label used to group or categorize pricing dimensions, such as by region or SageMaker option.
labelType (string) --
The type of the dimension label, such as Region or SagemakerOption.
labelValue (string) --
The value used to group dimensions together.
displayName (string) --
The human-readable display name of the label.
unit (string) --
The unit of measurement for the entitlement.
maxQuantity (integer) --
The maximum quantity of the entitlement that can be granted.
legalTerm (dict) --
Defines a legal term containing documents proposed to buyers, such as EULAs and data subscription agreements.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
documents (list) --
The legal documents proposed to the buyer as part of this term.
(dict) --
A legal document associated with a legal term, such as a EULA or data subscription agreement.
type (string) --
The category of the legal document, such as StandardEula or CustomEula.
url (string) --
The URL where the legal document can be accessed.
version (string) --
The version of the standard contract, if applicable.
paymentScheduleTerm (dict) --
Defines a payment schedule term with installment payments at specified dates.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
schedule (list) --
The payment schedule installments, each with a charge date and amount.
(dict) --
A payment installment within a payment schedule term.
chargeDate (datetime) --
The date when the payment is due.
chargeAmount (string) --
The amount to be charged on the charge date.
recurringPaymentTerm (dict) --
Defines a recurring payment term with fixed charges at regular billing intervals.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
billingPeriod (string) --
The billing period frequency, such as Monthly.
price (string) --
The amount charged each billing period.
renewalTerm (dict) --
Defines a renewal term that enables automatic agreement renewal.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
maxRenewals (integer) --
The maximum number of renewals allowed on this offer. Absent means unlimited renewals.
lockoutPeriod (string) --
The duration before the agreement end date when the lockout window begins, in ISO 8601 format (for example, P30D). Absent means no lockout.
adjustmentDeadline (string) --
The duration before the agreement end date by which the renewal price is finalized, represented in ISO 8601 format (for example, P30D). Only applicable with PercentageRange.
priceIncrease (dict) --
The price increase applied at each renewal cycle. Absent means identical pricing on renewal.
fixedPercentage (dict) --
A single fixed percentage applied uniformly at every renewal cycle.
percentageValue (string) --
The percentage value applied at each renewal cycle.
percentageRange (dict) --
A percentage band with minimum, maximum, and default values that bound the price increase at each renewal cycle.
minimumValue (string) --
The minimum percentage by which the price can increase at each renewal cycle.
maximumValue (string) --
The maximum percentage by which the price can increase at each renewal cycle.
defaultValue (string) --
The percentage increase applied by default when no other value is finalized before the adjustment deadline. Falls between minimumValue and maximumValue.
termTemplates (list) --
Structural templates defining how specific terms are reshaped on each renewal cycle. Absent for upfront-only offers.
(dict) --
A structural template defining how a specific term type is reshaped on each renewal cycle. Exactly one variant is present.
paymentScheduleTermTemplate (dict) --
The installment schedule used to structure payments on the renewal offer.
schedule (list) --
An ordered list of installment entries for the renewal payment schedule.
(dict) --
A single installment entry in the renewal payment schedule.
chargeDateOffset (string) --
The relative offset from the renewal agreement start date when this installment is due, in ISO 8601 duration format. The offset uses months only or days only (for example, P1M or P30D); mixed units are not supported, and every offset in a schedule uses the same unit.
chargePercentage (string) --
The percentage of the increased TCV to charge in this installment. All entries in a schedule sum to 100.00.
dayOfMonth (integer) --
The optional calendar day of month on which the charge occurs. When absent, the charge day is derived from chargeDateOffset, and this field does not apply when chargeDateOffset is expressed in days. For months with fewer days than the specified day, the charge occurs on the last day of the month. For example, if dayOfMonth is 31, the charge in April occurs on April 30.
supportTerm (dict) --
Defines a support term that includes the refund policy for the offer.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
refundPolicy (string) --
The refund policy description for the offer.
usageBasedPricingTerm (dict) --
Defines a usage-based pricing term (typically pay-as-you-go), where buyers are charged based on product usage.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
rateCards (list) --
The rate cards containing per-unit rates for usage-based pricing.
(dict) --
A rate card within a usage-based pricing term, containing per-unit rates.
rateCard (list) --
The per-unit rates for this usage-based rate card.
(dict) --
A per-unit rate within a rate card, defining the price for a specific dimension.
dimensionKey (string) --
The machine-readable key identifying the dimension being priced.
displayName (string) --
The human-readable name of the dimension.
description (string) --
A description of the dimension being priced.
dimensionLabels (list) --
Labels used to categorize this dimension, such as by region.
(dict) --
A label used to group or categorize pricing dimensions, such as by region or SageMaker option.
labelType (string) --
The type of the dimension label, such as Region or SagemakerOption.
labelValue (string) --
The value used to group dimensions together.
displayName (string) --
The human-readable display name of the label.
unit (string) --
The unit of measurement for the dimension.
price (string) --
The price per unit for the dimension.
validityTerm (dict) --
Defines a validity term that specifies the duration or date range of an agreement.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
agreementDuration (string) --
The duration of the agreement, in ISO 8601 format.
agreementEndDate (datetime) --
The date when the agreement ends.
agreementStartDate (datetime) --
The date when the agreement starts.
variablePaymentTerm (dict) --
Defines a variable payment term with a maximum total charge amount.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
currencyCode (string) --
Defines the currency for the prices in this term.
maxTotalChargeAmount (string) --
The maximum total amount that can be charged under this term.
netPaymentTerm (dict) --
A net payment term.
id (string) --
The unique identifier of the term.
type (string) --
The category of the term.
paymentDuePeriod (string) --
The duration after invoice date by which payment is due.
nextToken (string) --
If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page.
{'purchaseOptions': {'badges': {'badgeType': {'AUTO_RENEW'}}}}
Returns the purchase options (offers and offer sets) available to the buyer. You can filter results by product, seller, purchase option type, visibility scope, and availability status.
See also: AWS API Documentation
Request Syntax
client.list_purchase_options(
filters=[
{
'filterType': 'PRODUCT_ID'|'SELLER_OF_RECORD_PROFILE_ID'|'PURCHASE_OPTION_TYPE'|'VISIBILITY_SCOPE'|'AVAILABILITY_STATUS',
'filterValues': [
'string',
]
},
],
maxResults=123,
nextToken='string'
)
list
Filters to narrow the results. Multiple filters are combined with AND logic. Multiple values within the same filter are combined with OR logic.
(dict) --
A filter used to narrow purchase option results by product, seller, type, visibility, or availability.
filterType (string) -- [REQUIRED]
The type of filter to apply, such as PRODUCT_ID, VISIBILITY_SCOPE, or PURCHASE_OPTION_TYPE.
filterValues (list) -- [REQUIRED]
The values to filter by. Multiple values within the same filter are combined with OR logic.
(string) --
integer
The maximum number of results that are returned per call. You can use nextToken to get more results.
string
If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page.
dict
Response Syntax
{
'purchaseOptions': [
{
'purchaseOptionId': 'string',
'catalog': 'string',
'purchaseOptionType': 'OFFER'|'OFFERSET',
'purchaseOptionName': 'string',
'availableFromTime': datetime(2015, 1, 1),
'expirationTime': datetime(2015, 1, 1),
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
},
'badges': [
{
'displayName': 'string',
'badgeType': 'PRIVATE_PRICING'|'FUTURE_DATED'|'REPLACEMENT_OFFER'|'AUTO_RENEW'
},
],
'associatedEntities': [
{
'product': {
'productId': 'string',
'productName': 'string',
'manufacturer': {
'sellerProfileId': 'string',
'displayName': 'string'
}
},
'offer': {
'offerId': 'string',
'offerName': 'string',
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
}
},
'offerSet': {
'offerSetId': 'string',
'sellerOfRecord': {
'sellerProfileId': 'string',
'displayName': 'string'
}
}
},
]
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
purchaseOptions (list) --
The purchase options available to the buyer. Each option is either an offer for a single product or an offer set spanning multiple products.
(dict) --
Summary information about a purchase option (offer or offer set) available to the buyer, including the seller, badges, and associated products.
purchaseOptionId (string) --
The unique identifier of the purchase option.
catalog (string) --
The name of the catalog that the purchase option belongs to.
purchaseOptionType (string) --
The type of purchase option. Values are OFFER for a single-product offer or OFFERSET for a bundled offer set.
purchaseOptionName (string) --
The display name of the purchase option.
availableFromTime (datetime) --
The date and time when the purchase option became available to the buyer.
expirationTime (datetime) --
The date and time when the purchase option expires and is no longer available for procurement.
sellerOfRecord (dict) --
The entity responsible for selling the product under this purchase option.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
badges (list) --
Badges indicating special attributes of the purchase option, such as private pricing or future dated.
(dict) --
A badge indicating a special attribute of a purchase option, such as private pricing or future dated.
displayName (string) --
The human-readable name of the badge.
badgeType (string) --
The machine-readable type of the badge.
associatedEntities (list) --
The products, offers, and offer sets associated with this purchase option.
(dict) --
A product, offer, and optional offer set associated with a purchase option.
product (dict) --
Information about the product associated with the purchase option.
productId (string) --
The unique identifier of the product.
productName (string) --
The human-readable display name of the product.
manufacturer (dict) --
The entity who manufactured the product.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
offer (dict) --
Information about the offer associated with the purchase option.
offerId (string) --
The unique identifier of the offer.
offerName (string) --
The display name of the offer.
sellerOfRecord (dict) --
The entity responsible for selling the product under this offer.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
offerSet (dict) --
Information about the offer set, if the purchase option is part of a bundled offer set.
offerSetId (string) --
The unique identifier of the offer set.
sellerOfRecord (dict) --
The entity responsible for selling the products under this offer set.
sellerProfileId (string) --
The unique identifier of the seller profile.
displayName (string) --
The human-readable name of the seller.
nextToken (string) --
If nextToken is returned, there are more results available. Make the call again using the returned token to retrieve the next page.