Associating, disassociating and assigning opportunities

Opportunities can be associated or disassociated with Partner Solutions, AWS Products, AWS Marketplace Solutions, AWS Marketplace Products, AWS Marketplace Offers, and AWS Marketplace Offer Sets at any stage of the opportunity lifecycle.

Associating opportunities with other entities

The associated entities are retrieved from the GetOpportunity method within the RelatedEntityIdentifiers object. The RelatedEntityIdentifiers can be updated using AssociateOpportunity. Note that this field cannot be updated using the UpdateOpportunity or CreateOpportunity method.

Solutions

Before an engagement with AWS is started using the StartEngagementFromOpportunityTask action, it is mandatory to associate at least one and up to ten Partner Solutions. An AWS Referral may or may not contain a Partner Solution.

To view your existing solutions, use the ListSolutions action.

Partners can create, update, and manage their solutions in the Build section on AWS Partner Central.

AWS products

Up to 20 AWS Products can be associated with an opportunity. To view a list of available AWS Products, use the list of AWS Products hosted on GitHub. Association with AWS Products is exclusively done using the AssociateOpportunity action. To replace or remove a Product, use the DisassociateOpportunity action.

Solutions

Opportunities can be associated with solutions from your seller account. Use the AssociateOpportunity action with RelatedEntityType set to AwsMarketplaceSolutions.

The entity must be in Public or Limited status. The service rejects draft or inactive entities.

For associating a solution, an ARN is required. The following example shows the ARN format for a solution:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Solution/soln-ab1c2de3fgh4i

You can also associate solutions from a subsidiary AWS Marketplace account connected to your primary account through Partner Account Connection. Enter the full ARN, including the subsidiary account ID.

The ListSolutions action returns AwsMarketplaceSolutionArn on each solution summary, and supports filtering by ARN.

AWS Marketplace Products

Opportunities can be associated with AWS Marketplace Products from your seller account. Use the AssociateOpportunity action with RelatedEntityType set to AwsMarketplaceProducts.

The entity must be in Public or Limited status. The service rejects draft or inactive entities.

For associating a product, an ARN is required. The ARN includes the product type (for example, AmiProduct, SaaSProduct, ContainerProduct). The following example shows the ARN format for an AMI product:

arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/AmiProduct/prod-ab1c2de3fgh4i

You can also associate products from a subsidiary AWS Marketplace account connected to your primary account through Partner Account Connection. Enter the full ARN, including the subsidiary account ID.

AWS Marketplace offers and offer sets

AWS Marketplace offers

Opportunities can be tied to an AWS Marketplace Private Offer. To view available offers, use the ListEntities from the AWS Marketplace Catalog API. Currently, you can only associate offers from the AWS Marketplace Seller account linked to AWS Partner Central.

For associating a private offer ARN is required. Sample:

arn:aws:aws-marketplace:us-east-1:123123123123:AWSMarketplace/Offer/offer-dtn3example1tg

AWS Marketplace offer sets

Opportunities can also be associated with AWS Marketplace Offer Sets. Offer sets enable the grouping of multiple related marketplace offers together for comprehensive solution packaging. To view available offer sets, use the ListEntities from the AWS Marketplace Catalog API.

For associating an offer set, an ARN is required. Sample:

arn:aws:aws-marketplace:us-east-1:123123123123:AWSMarketplace/OfferSet/offerset-dtn3example1tg

Important: An opportunity can be associated with either one Offer OR one Offer Set, but not both. Only one of these entity types can be associated with an opportunity at a time.

Disassociating opportunities from other entities

Use the DisassociateOpportunity action to unlink the opportunity from the following entity types:

Depending on the state of the opportunity, different validation rules apply when you unlink these related objects.

Assigning opportunities

Use AssignOpportunity to change the opportunity's owner. You can set any of your Partner Central users to be the opportunity owner.