offers
Creates, updates, deletes, gets or lists an offers resource.
Overview
| Name | offers |
| Type | Resource |
| Id | aws.marketplace_discovery.offers |
Fields
The following fields are returned by SELECT queries:
- get_offer
| Name | Datatype | Description |
|---|---|---|
agreement_proposal_id | string | An encoded string to be passed by the acceptor of the terms when creating an agreement. (pattern: <code>[A-Za-z0-9_/-]+</code>) |
associated_entities | array | The products and offer sets associated with this offer. |
available_from_time | string (date-time) | The date and time when the offer became available to the buyer. |
badges | array | Badges indicating special attributes of the offer, such as private pricing, future dated, or replacement offer. |
catalog | string | The name of the catalog that the offer belongs to. (pattern: <code>[\w-]+</code>) |
expiration_time | string (date-time) | The date and time until when the offer can be procured. This value is null for offers that never expire. |
offer_id | string | The unique identifier of the offer. (pattern: <code>[\w-]+</code>) |
offer_name | string | The display name of the offer. This is free-form text provided by the seller. |
pricing_model | object | A pricing model that determines how buyers are charged for a listing, such as usage-based, contract, BYOL, or free. |
replacement_agreement_id | string | The identifier of the existing agreement that this offer would replace. Enables agreement-based offer functionality. (pattern: <code>[A-Za-z0-9_/-]+</code>) |
seller_of_record | object | The entity responsible for selling the product under this offer. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_offer | select | region | Provides details about an offer, such as the pricing model, seller of record, availability dates, badges, and associated products. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
region | string | AWS region (default: us-east-1) |
SELECT examples
- get_offer
Provides details about an offer, such as the pricing model, seller of record, availability dates, badges, and associated products.
SELECT
agreement_proposal_id,
associated_entities,
available_from_time,
badges,
catalog,
expiration_time,
offer_id,
offer_name,
pricing_model,
replacement_agreement_id,
seller_of_record
FROM aws.marketplace_discovery.offers
WHERE region = '{{ region }}' -- required
;