Single-AMI products - AWS Marketplace

Single-AMI products

This section discusses how you can work with product listings in AWS Marketplace for single-AMI products. Customers can use Amazon Machine Images (AMIs) to create Amazon EC2 instances with your product already installed and configured.

The AMI self-service experience guides you as you create your product listing and make change requests. By using the self-service experience, you can update your product listing directly with less time needed for processing by the AWS Marketplace Seller Operations team. Many steps of the self-service experience align with the catalog system in AWS Marketplace, which facilitates direct validation instead of waiting for processing and validation from the AWS Marketplace Seller Operations team.

Note

For a few tasks, you can choose from two procedures: A procedure that is appropriate only for the self-service experience and an older procedure that isn't relevant to the self-service experience. You can use either procedure during the current transition period. The older procedure displays a banner with information about when it will no longer be available.

Prerequisites

Before you create an AMI product listing, you must complete the following prerequisites:

  1. Have access to the AWS Marketplace Management Portal. This is the tool that you use to register as a seller and manage the products that you sell on AWS Marketplace. To learn more about getting access to the AWS Marketplace Management Portal, see Policies and permissions for AWS Marketplace sellers.

  2. Register as a seller and, if you want to charge for your products, submit your tax and banking information. To learn more about becoming a seller, see Getting started as a seller.

  3. Have a product that you want to sell. For AMI-based products, this typically means you have created or modified your server software, and have created an AMI for your customers to use. To learn more about preparing an AMI for use in AWS Marketplace, see Best practices for building AMIs.

Understand the self-service experience

The self-service experience guides you through creating your product on AWS Marketplace. As you proceed through the steps, you specify product information and AMI deployment settings, such as AWS Region, instance types, and AMI details. You also configure transaction details including the pricing, country availability, EULA, and refund policy. As an option, you can specify an allowlist of AWS account IDs to access and test the product while it is in the Limited status.

Before you get started, review the following key aspects of the self-service experience:

  • You can only go to the next step after you complete the required fields in the current step. This requirement is because there is page-level validation at the end of each step. You can't save or submit an incomplete step.

  • If you need to end your session before completing all the steps in the process, you can choose Save and exit to submit the steps that you completed to the staging area.

  • A step that is incomplete and doesn't pass validation isn't submitted to the system. A partially completed step isn't valid and can't be saved.

  • When you choose Save and exit, the Save and exit dialog box shows the steps that passed validation checks. You can review and choose to save up to the last completed and validated steps. If there is a validation error or missing details, you can choose Fix it to go back to that step.

  • After you Save and exit, the request is under review while it's processing. It could take a few minutes or hours to finish processing. You can't continue the steps or make changes until the request has succeeded. For the first Save and exit, the request is creating the product in parallel with the steps that you have completed.

    • After the request has Succeeded, you have completed the save. To resume changes on the Product overview page, choose Resume product creation or use Request changes to update the details you have previously submitted in the last session. When you resume, notice that the steps you have completed are marked with a green Succeeded label. To update a previously submitted step, use Request changes. The previous Save and exit request must be completed before you can continue this step.

  • When you’ve completed all the steps, you can choose Next to see a review. Choose Submit which requests that the system perform a final validation. After you receive a Succeeded response, the product moves to a Limited status. You can see on the detail page that the product is now available to anyone on the allowlist. If the request fails, the product remains in the Staging status and requires you to make corrections before resubmitting.

Create your single-AMI product

This section provides the procedures that you can use to create a listing for a single-AMI product in AWS Marketplace, including the option to use the self-service experience.

Create a single-AMI product by using self-service

You can use the following process that guides you through creating your single-AMI product in AWS Marketplace.

Note

You can only go to the next step when you complete the required fields in the current step. You can't save or submit an incomplete step If you need to end your session before completing all the steps in the process, use the Save and exit function to submit the steps that you completed to the staging area. For more information, see Understand the self-service experience.

To create a single-AMI product using self-service
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. From the Products menu, choose Server. Or, you can go directly to the Server Products page.

  3. From the Server products tab, select Create server product, select Amazon Machine Image (AMI), and then select one of the licensing types for single-AMI products:

    • Bring your own license (BYOL) – A product that the user gets a license from you outside of AWS Marketplace. It can be either a paid or free license.

    • Free – A product that is free for your subscribers to use. (They will still pay charges for any associated Amazon Elastic Compute Cloud (Amazon EC2) instance, or other AWS resources.)

    • Paid hourly or hourly-annual – A product that the buyer pays for either on an hourly basis or hourly with an annual contract. AWS does the metering based on the product code on the AMI.

    • Paid monthly – A product that the buyer is billed for monthly by AWS.

    • Paid usage – Software is directly charged for the value you provide, along with one of four usage categories: users, data, bandwidth, or hosts. You can define up to 24 dimensions for the product. All charges are still incurred by the customer.

    • AMI with contract pricing – A Single-AMI product or Single-AMI with an AWS CloudFormation stack that the buyer pays an upfront fee for.

  4. The self-service experience guides you through the steps to create an AWS Marketplace listing. You must enter product information (metadata), product deployment details (AWS Region, instances, and AMI details), and public offer details (price, EULA, availability by country, EULA, refund). As an option, you can add accounts to the allowlist to test the product. Complete each step to move to the next step in the process.

    Note

    If you need to end your session before completing all steps in the process, you can use the Save and exit function to submit the steps you completed to the staging area. This creates a request for the information you provided to be validated. While the request is processing, you can't edit the product. After the request succeeds, you can continue creating your product by choosing Resume product creation.

    A failed request means no update was made to the product because of a validation error. This will be visible on the request log for your product. You can select the request to view the error, use Copy to new under Actions to correct the error, and resubmit the request. When you resume the steps, you can continue from the step after the step that you saved in the last session. To update previous steps, go to the product overview page and submit a Change request to update steps that you submitted previously.

  5. After entering required information for all of the change request steps, choose Submit. This submittal creates a request to the AWS Marketplace catalog system to validate the information and release the product to a Limited state, if the validation passes. While the request is processing, you can't continue to edit the product. After the request succeeds, the product is moved to a Limited state.

    • When your product is initially published, it's only accessible to your AWS account (the one you used to create the product) and the AWS Marketplace Seller Operations team's test account. If you view the product from the Server products page, you can choose View on AWS Marketplace to view the product details as they will appear in AWS Marketplace for buyers. This detail listing isn't visible to other AWS Marketplace users.

    • This capability allows you to test your product (and even publish multiple versions for testing) before releasing it publicly.

  6. Test your product in the Limited state and make sure that it follows AWS Marketplace AMI-based product requirements and the product checklist. Then, to request that your product be published to Public, choose Update visibility. The AWS Marketplace Seller Operations team must review your product before approving it to go Public.

    Note

    Product verification and publication is a manual process, which is handled by the AWS Marketplace Seller Operations team. It can take 7–10 business days to publish your initial product version, if there are no errors. For more details about timing, see Timing and expectations.

For more information about preparing and submitting both your single-AMI product and your product information, see Additional resources.

Create a single-AMI product

Important

On July 14, 2023, AWS Marketplace will discontinue the following procedure. After July 14, 2023, use the Create a single-AMI product by using self-service procedure.

To create a single-AMI product (Legacy)
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. From the Products menu, choose Server. Or, you can go directly to the Server products page.

  3. From the Server products tab, select Create server product, select Amazon Machine Image (AMI) (Legacy experience), and then select one of the licensing types for single-AMI products:

    • Bring your own license (BYOL) – A product that the user gets a license from you outside of AWS Marketplace. It can be either a paid or free license.

    • Free – A product that is free for your subscribers to use. (They will still pay charges for any associated Amazon Elastic Compute Cloud (Amazon EC2) instance or other AWS resources.)

    • Paid hourly or hourly-annual – A product that the buyer pays for either on an hourly basis or hourly with an annual contract. AWS does the metering based on the product code on the AMI.

    • Paid monthly – A product that the buyer is billed for monthly by AWS. If you select Paid monthly, you are asked to download a Product Load Form (PLF).

    • Paid usage – Software is directly charged for the value you provide, along with one of four usage categories: users, data, bandwidth, or hosts. You can define up to 24 dimensions for the product. All charges are still incurred by the customer.

    • AMI with contract pricing – A Single-AMI product or Single-AMI with an AWS CloudFormation stack that the buyer pays an upfront fee for.

    Note

    There are additional types of non self-service based pricing models for AMI-based products. These pricing types apply when your product integrates with the AWS Marketplace Metering Service to provide custom metering based on your customers' usage. To create a product that has usage-based pricing, you must download, complete, and upload a Product Load Form (PLF). For more information, see Custom metering pricing for AMI products

    For more information about PLFs, see Product Load Forms.

    For more information about the different types of licensing, see AMI pricing models.

  4. Based on your selection, fill out the information for the new product, and choose Submit.

  5. Verify that the request appears on the Requests tab with the Under review status. You can return to this page to see the status of your request as it is processed.

    Note

    Product verification and publication is a manual process, handled by the AWS Marketplace Seller Operations team. It can take 7–10 business days to publish your initial product version, if there are no errors. For more details about timing, see Timing and expectations.

When your product is initially published, it's only accessible to your AWS account (the one you used to create the product). If you view the product from the Server products page, you can select View on AWS Marketplace to view the product details as it will appear in AWS Marketplace for buyers. This detail listing isn't visible to other AWS Marketplace users.

This capability allows you to test your product (and even publish multiple versions for testing) before releasing it publicly. If you need to make the product available to additional test accounts, or to publish your product publicly, contact the AWS Marketplace Seller Operations team.

For more information about preparing and submitting both your single-AMI product and your product information, see Additional resources.

Additional resources

For more information about preparing your product information and submitting it for publication, see the following resources:

For more information about preparing your single-AMI product for submission to AWS Marketplace, see the following resources:

Create a change request

This section provides the procedures that you can use to create a change request for a single-AMI product in AWS Marketplace, including the option to use the self-service experience. You create a change request for the following situations:

  • You saved your in-progress steps, but didn't complete the entire process, while using the self-service experience to create a single-AMI product listing. To complete the remaining steps, you create a change request.

  • You want to make modifications to the product information for your product that is in either a Limited or Public state. To update the information, you create a change request. For more information about the types of changes that you can request for AMI-based products, see Change requests.

Note

In addition to the AWS Marketplace Management Portal, you can also create change requests by using the AWS Marketplace Catalog API.

Create a change request

Important

On June 15, 2023, AWS Marketplace will discontinue the following procedure. After June 15, 2023, use the Create a change request by using self-service procedure.

To make modifications to versions or the product information, you create a change request in the AWS Marketplace Management Portal.

To create a change request
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and sign in to your seller account, then go to the Server products page.

  2. On the Server products tab, select the product that you want to modify.

  3. Choose an option from the Request changes dropdown list.

    For most change requests, you simply fill out the form in the user interface and submit it. However, for certain changes, you must download, complete, and then upload a Product Load Form (PLF). This is a spreadsheet that contains a form for you to fill out with the required information. When you choose one of these change requests, you are prompted to download the correct PLF for the request you are attempting to create. The PLF is pre-populated with information from your existing product details. You can upload your completed PLF to the AWS Marketplace Management Portal File upload page.

    Note

    We strongly recommend that you download and use the most recent PLF. The form is regularly updated with new information, including instance types and AWS Regions as they become available. You can find the latest PLF for a product from the Server products page, by selecting the product and then choosing Download Product Load Form.

For more information about the status of a change request, see Get the status of a change request. For insight into potential issues with change requests, see Troubleshooting common errors when submitting change requests.

Create a change request by using self-service

To make modifications to versions or the product information, you create a change request in the AWS Marketplace Management Portal. Change requests are the building blocks of a self-service listing that you use to make changes to your product. Each time you select Save and exit from the steps or select Submit for any update, you are making a change request. You can find your requests on the AWS Marketplace Management Portal Request tab.

To create a change request using self-service
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and sign in to your seller account, then go to the Server products page.

  2. On the Server products tab, select the product that you want to modify.

  3. Choose an option from the Request changes dropdown.

  4. After you make a change request, there is a wait time for the system to process your request, reflected Under Review. When the request completes, it will result in either Succeeded or Failed.

    • After the request is submitted, it begins processing through these statuses: Under review, Preparing changes, and Applying changes.

    • Succeeded means that the requested change has been processed and changes reflect in the system.

    • Failed means that something went wrong with the request, so the changes were not processed. If the status is Failed, you can select the request to find error codes that provide recommendations on how to correct the error. At this point, you can troubleshoot the errors and create a new request for the change. To make the process faster, you can choose Copy to new request to copy the details of the failed request. Then, you can make the adjustment and resubmit the request.

Additional resources

For more details about change requests for specific types of updates, see the following resources:

Get the status of a change request

Important

On June 15, 2023, AWS Marketplace will discontinue the following procedure. This procedure is no longer needed for the self-service experience.

After you submit a change request, you can see the status of your request from the Requests tab of the Server products page of the AWS Marketplace Management Portal. The status could be any of the following:

  • Under review means that your request is being reviewed. Some requests require manual review by the AWS Marketplace team but most are reviewed automatically in the system.

  • Succeeded means that your request is complete. Your product or version has been updated as you requested.

  • Action required means that you need to update your request to fix an issue or answer a question about the request. Select the request to see the details, including any issues.

  • Failed means that something went wrong with the request, and you should create a new request for the change, with the same data.

Update product information

After you have created your product, you might want to change some of the information associated with it in AWS Marketplace. For example, if a new version modifies the description or highlights of the product, you can edit the product information with the new data.

To update product information
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Server products tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Update product information.

  4. Update any of the following fields that you need to change:

    • Product title

    • SKU

    • Short description

    • Long description

    • Product logo image URL

    • Highlights

    • Product categories

    • Keywords

    • Product video URL

    • Resources

    • Support information

    Note

    For details about the logo format, see Company and product logo requirements.

  5. Select Submit.

  6. Verify that the request appears on the Requests tab with the Under review status. You might need to refresh the page to see the request on the list.

You can check the status of your request at any time from the Requests tab of the Server Products page. For more information, see Get the status of a change request.

Update the allowlist (preview accounts)

To change the list of AWS account IDs that can see your product in a Limited state, use Update allowlist.

To update the allowlist
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Update allowlist. The current list is provided with the list of accounts that are currently allowlisted.

  4. Add the AWS account IDs that are preferred for visibility and separate the IDs with commas.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Update product visibility

To change which buyers can view your product in AWS Marketplace, you can use Update visibility.

To update visibility
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Update visibility.

    Note

    You can request that the product be moved from a Limited status to a Public status by using this change request. However, the change request must go through an AWS Marketplace Seller Operations team approval process to be moved to Public.

  4. Choose Submit change request to submit your request for review.

  5. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Add an AWS Region

You can add an Region where buyers can use your product.

To add a Region
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Add Region.

  4. Select the Region that you want to add from the list of available Regions.

  5. Choose Submit request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Note

When you add support for a new AWS Region, customers already subscribed to private offers for your product won't be able to access the newly added Region automatically. You must create another private offer with the Region you want customers to access. After accepting the new offer, customers can access the newly added Region. Customers who subscribe to your product at a future date can also access the Region, as long as the Region is included in the private offer. For more information about how to create a new private offer, see Private offer upgrades, renewals, and amendments.

Restrict an AWS Region

To prevent new buyers from using your product in a specific AWS Region, you can restrict the Region. You can add the Region back at a later time. Existing subscribers of the product in the Region can continue using the product from the Region as long as they're subscribed.

To restrict a Region
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Restrict Region.

  4. Select the dropdown menu to view the list of Regions in which your product is currently available.

  5. Select the Regions that you want to restrict.

  6. The Regions you have selected appear as tokens. Review the list of Regions that you're restricting, and enter X for Regions that you don't want to restrict.

  7. Choose Submit change request to submit your request for review.

  8. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

If your request is successful, your existing users receive the following email message notifying them of the Region to be restricted. They can continue using your product as long as they remain subscribed, but they can’t re-subscribe if they cancel the subscription.

Greetings from AWS Marketplace, This message is a notification detailing a recent change for <ProductName>. {{{sellerName}}} has opted to restrict the <ProductType> product in <Restricted Region(s)> beginning <DateOfChange>. This impacts you in the following ways: 1. As long as you're subscribed to the product, you can continue using the software product in the restricted Region. 2. You can't begin new instances of the software product in the restricted Region. 3. You can continue using the software product in all available AWS Regions. Regards, The AWS Marketplace Team Amazon Web Services, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com (http://amazon.com/) is a registered trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210.

Update support for future AWS Regions

If you want your product to be onboarded to newly launched AWS Regions, you can use Update future Region support.

To update future Region support
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Update future Region support.

  4. You can choose to activate future Region support to allow AWS Marketplace to onboard your product to newly launched AWS Regions on your behalf.

  5. After activating the feature, you can choose between all future Regions or limit to US Regions only.

  6. Choose Submit change request to submit your request for review.

  7. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Add an instance

You can add a new instance for which buyers can use a single-AMI.

To add an instance
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Add instance.

  4. Select the instances that you want to add from the list of available instances. .

  5. Choose Submit request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

    Note

    If your current pricing model is not free or uses a Bring Your Own License (BYOL) model, there is an additional step to add prices.

    If you created an Add instance with a price for the new instance or Update pricing to increase price, you can’t use self-service to Add instance in the 90 days starting from the day you made the change. To make these changes, contact the AWS Marketplace Seller Operations team.

    When you add support for a new instance type, customers already subscribed to private offers for your product won't be able to launch the newly added instance automatically. You must create another private offer with the instance you want customers to access. After accepting the new offer, customers can launch the newly added instance. Customers who subscribe to your product at a future date can also launch the instance, as long as the instance is included in the private offer. For more information about how to create a new private offer, see Private offer upgrades, renewals, and amendments.

Restrict an instance

If you want to prevent new buyers from using your single AMI product from a specific instance, you can restrict the instance. You can add the instance back at a later time, if needed. Existing users of the single AMI on the restricted instance can continue to use the product from the Region as long as they're subscribed.

To restrict an instance
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, and on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Restrict instance.

  4. Select the instances that you want to restrict, and choose Restrict.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

    Note

    If the check box is shaded, this means the instance is associated with one to several versions as a recommended instance type. To restrict such instances, use Update versions to choose a different recommended instance type. After the change requests complete and the instance you want to restrict is no longer a recommended instance type, you can return to Restrict instance to restrict your chosen instance.

Update version information

After a version is created, it can be helpful to provide updated information to your buyers by modifying the information associated with the version. For example, if you plan to restrict version 1.0 after version 1.1 is released, you can update the description of version 1.0 to direct buyers to version 1.1, with the date that the version will be restricted. You update the version information from the AWS Marketplace Management Portal.

To update version information
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Current server product page, on the Server products tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Update version information.

  4. On the Update version page, select the version that you want to update.

  5. Update any of the following information that you need to modify:

    • Release notes

    • Usage instructions

    • 64-bit (x86) Amazon Machine Image (AMI) – Details on usage and security group

  6. Select Submit.

  7. Verify that the request appears on the Requests tab with the Under review status.

Note

You can't use this procedure to update the version title, or the AMI associated with the version. Instead, create a new version and restrict the previous version.

You can check the status of your request at any time from the Requests tab of the Server Products page. For more information, see Get the status of a change request.

Add a new version

You can add a new version of your product when you make changes to the product, the base image, or any other time you need to modify the AMI for the product. Add a new version of your product from the AWS Marketplace Management Portal.

Note

For information about creating an AMI for AWS Marketplace, see Best practices for building AMIs.

To add a new version
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Add new version. The Add a new version form appears, pre-populated with the information from your most recent version.

  4. In the Version information section, provide the following information:

    • Version title – Enter a valid string (for example 1.1 or Version 2.0). It must be unique across the product.

    • Release notes – Enter text to describe details about this version.

  5. In the New Amazon Machine Image (AMI) section, provide the following information:

    • Amazon Machine Image ID – Enter the AMI ID for the AMI that you want to use for this version. You can find the AMI ID from the list of AMIs in the console. The AMI must exist in the US East (N. Virginia) Region, and in your AWS Marketplace Seller account. The snapshot associated with this AMI can't be encrypted.

    • IAM access role ARN – Enter the Amazon Resource Name (ARN) for an AWS Identity and Access Management (IAM) role that allows AWS Marketplace to gain access to your AMI. For instructions on how to create the IAM role, see Give AWS Marketplace access to your AMI. Use the standard format for an IAM ARN, for example: arn:aws:iam::123456789012:role/RoleName. The ARN must exist in your AWS Marketplace Seller account.

    • OS user name – For Linux-based AMIs, enter the name of a user that can be used to sign into the instance. We recommend using ec2-user.

    • Scanning port – Enter the port number that can be used to log into the operating system: the SSH port for a Linux AMI or the RDP port for a Windows AMI.

  6. If it is not already, expand the Configuration settings to publish the AMI to the AWS Marketplace customer website section, then provide the following information:

    • Usage instructions – Enter instructions for using the AMI or a link to more information about using the AMI. For example: To get started with the product, navigate to https://example.com/usage.htm.

    • Endpoint URL – Provide information about how the buyer can access the software after they create an instance. Enter the Protocol (https or http), the Relative URL (for example, /index.html), and the Port (for example, 443) that buyers can use to access your product. (The host name depends on the EC2 instance, so you only need to provide the relative path).

    • Operating system (OS) – Enter the name of the OS used by the AMI (for example, Amazon Linux).

    • OS version – Enter the specific version of the OS in the AMI.

    • Recommended instance type– Choose the instance type that buyers get by default.

    • Security group recommendations – Enter the information for one or more recommendations, including the protocol (TCP or UDP), range of ports to allow, and list of IPv4 CIDR IPs (in the form xxx.xxx.xxx.xxx/nn, for example, 192.0.2.0/24).

  7. Select Submit to submit the request to add your new version.

  8. Verify that the request appears on the Requests tab with the Under review status. If there are errors to fix, the page displays the errors in a table at the top of the page, and the specific fields that need to be updated display in red.

You can check the status of your request at any time from the Requests tab of the Server products page. The new version will be reviewed and, if successful, published as a new public version of your product. If there is an issue, the status might be Action required. Select the request to see details, including any issues.

If your request is successful, your existing users receive the following email message. The message notifies them that the new version is available, links to the version's release notes, and suggests that they upgrade to the latest version. As the AWS account root user, you also receive a copy of the email message in the email account that's associated with your AWS account.

Greetings from AWS Marketplace, Thank you for subscribing to <product-title> We are writing to inform you that <seller-name> has added a new version to <product-title> on AWS Marketplace. As an existing customer, your subscription to the product, any running instances and access to previous versions are unaffected. However, <seller-name> does recommend you to update to the latest version, <product-title>/<version-title> by visiting <product-detail-page-of-new-listing>. For additional questions or upgrade information, please contact <seller-name> directly. Click here <link of seller page on MP> to visit the seller’s profile page on AWS Marketplace. Release notes for <product-title>/<version-title>: <release-notes> Thank you, The AWS Marketplace Team https://aws.amazon.com/marketplace Amazon Web Services, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210

Restrict a version

If you want to prevent buyers from accessing a specific version of your public product, you can restrict that version.

Note

All subscribers can use the current version regardless of the restriction status. AWS Marketplace guidelines require that you continue to offer support to existing buyers for 90 days after restricting the version. Your AMI will be marked as deprecated after the version is restricted. For more information, see Deprecate an AMI in the Amazon Elastic Compute Cloud User Guide for Windows Instances.

To restrict a version
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Restrict version.

  4. On the Restrict version page, select the version (or versions) that you want to restrict.

  5. Select Submit to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status is Succeeded.

Note

You can't restrict all versions of a product. If you try to restrict the last remaining public version of a product, you will receive an error. To completely remove a product, see Remove a product from AWS Marketplace.

You can check the status of your request at any time from the Requests tab of the Server products page. For more information, see Get the status of a change request.

Note

Restricting a version can take up to 3 days to complete.

If your request is successful, your existing users receive the following email message that notifies them of the version restriction and suggests they use the most recent version available. As the AWS account root user, you also receive a copy of the email message in the email account that's associated with your AWS account.

Greetings from AWS Marketplace, Thank you for subscribing to <product-title>. We are writing to inform you that, as of <Version-Restriction-Date>, <Seller Name> will no longer offer version(s) "<version-title>" to new subscribers. Your use and subscription is unaffected for this version(s), however it is recommended that users upgrade to the latest version on AWS Marketplace. For additional questions or upgrade information, please contact <seller-name> directly. Click here<link of seller page on MP> to visit the seller’s profile page on AWS Marketplace. Thank you, The AWS Marketplace Team https://aws.amazon.com/marketplace Amazon Web Services, Inc. is a subsidiary of Amazon.com, Inc. Amazon.com is a registered trademark of Amazon.com, Inc. This message was produced and distributed by Amazon Web Services Inc., 410 Terry Ave. North, Seattle, WA 98109-5210

Update pricing

If you want to change the pricing per instance type on your single-AMI product, then you can update pricing.

Note

If you made an Add instance change request with a price for the new instance or Update pricing to increase price (not decrease price), you can’t use self-service to make pricing updates in the 90-days starting from the day you made the change. For additional support, contact the AWS Marketplace Seller Operations team to make these changes.

To update product pricing
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Update pricing.

  4. Text boxes are pre-populated with the current pricing information. You can delete the current price and then enter your new price. We recommend that you review the prices you’re requesting to verify correct pricing.

    Note

    A pricing increase for any instance will result in Add Instance and Update Pricing being locked for the next 90-days.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

    Note

    If you created an Add instance with a price for the new instance or Update pricing to increase price (not decrease price), you can’t use self-service to make pricing updates in the 90 days starting from the day you made the change. For additional support, contact the AWS Marketplace Seller Operations team to make these changes.

Update availability by country

If you want to change the countries in which your product can be subscribed to and offered, you can use Update availability.

To update availability by country
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Update availability.

  4. Choose one of the following options:

    1. All countries – Available in all supported countries.

    2. All countries with exclusions – Available in all supported countries except in selected countries.

    3. Custom list – Specific list of countries where the product is available.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Update your EULA

If you want to change your end user license agreement (EULA), you can use Update EULA. This action updates the EULA for new users subscribing to your product and for product renewals.

To update a EULA
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Choose the Server products tab, on the Current server product tab, select the product that you want to modify.

  3. From the Request changes dropdown, choose Update end-user license agreement.

  4. You can select the Standard Contract for AWS Marketplace (SCMP) or submit your own custom EULA. For a custom EULA, you must provide the URL for your custom contract from an Amazon S3 bucket.

    Note

    Public accessibility must be enabled on your Amazon S3 bucket.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Update the refund policy

If you want to change the refund policy for your product, you can use Update refund policy.

To update the refund policy
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Go to the Server products page, on the Current server product tab, then select the product that you want to modify.

  3. From the Request changes dropdown, choose Update refund policy.

  4. The current refund policy details are provided in the text box for you to edit. Submitting the request overwrites the current refund policy.

  5. Choose Submit change request to submit your request for review.

  6. Verify that the Requests tab shows the Request status as Under review. When the request completes, the status becomes Succeeded.

Give AWS Marketplace access to your AMI

When you create a request that includes adding a new AMI to AWS Marketplace, the AMI must be copied into the AWS Marketplace system and then scanned for security issues. You must give AWS Marketplace access to the AMI by creating an AWS Identity and Access Management (IAM) role with permissions to perform actions on your AMI and a trust policy that allows AWS Marketplace to assume the role. You only need to create the IAM role once.

To create a role for AWS Marketplace AMI assets ingestion
  1. Sign in to the AWS Management Console, open the IAM console and go to the Roles page.

  2. Select Create role.

  3. On the Create role page, make the following selections:

    • Select type of trusted entity – Choose AWS Service.

    • Choose a use case – Choose AWS Marketplace.

    • Select your use case – Choose Marketplace – AMI Assets Ingestion.

    • To move to the next page, select Next: Permissions.

  4. Select the AWSMarketplaceAmiIngestion policy. Add a permissions boundary if required, and then select Next: Tags to continue.

    Note

    You can use permissions boundaries to limit the access that you give AWS Marketplace with this role. For more information, see Permissions boundaries for IAM entities in the AWS Identity and Access Management User Guide.

  5. To continue, select Next: Review.

  6. Provide a name for the role, and select Create role.

  7. You should see "The role rolename has been created" at the top of the page, and the role should appear in the list of roles.

On this page, when you select the role that you just created, you can see its ARN in the form arn:aws:iam::123456789012:role/exampleRole. Use the ARN for the IAM access role ARN when you create change requests, for example, when adding a new version to your product.

Remove a product from AWS Marketplace

After your product is published, you can remove (also referred to as sunset) it from AWS Marketplace. To remove a product, identify the product and submit a request to remove it, along with a reason for removal and a contact email address for you. You can also provide a replacement product ID if you're replacing the current product with a new one. After you request product removal, new customers will no longer be able to subscribe to the product. You're required to support any existing customers for a minimum of 90 days. We process requests for product removal from AWS Marketplace with the following conditions:

  • The product is removed from AWS Marketplace search, browse, and other discovery tools. Any Subscribe button or functionality is disabled, and messaging on the page clearly indicates the product is no longer available. The product detail page is still accessible using the URL and might be indexed in public search engines.

  • A reason for removal must be specified (for example, end of support, end of product updates, or replacement product). For the requirements for continuing support for removed products, see Terms and Conditions for AWS Marketplace Sellers.

  • AWS Marketplace contacts current buyers through an email message informing them of the product removal, reasons for the removal, and to provide seller contact information.

  • Current buyers do retain access to the software until they cancel their subscription. They aren't affected in any way by the product's removal.

To remove a product created using the AWS Marketplace Management Portal
  1. Open the AWS Marketplace Management Portal at https://aws.amazon.com/marketplace/management/tour/, and then sign in to your seller account.

  2. Choose the Products tab, and then choose Server.

  3. On your product page, under Server products, locate the product that you want to remove. From the Request changes dropdown list, choose Update product visibility.

  4. On the Update product visibility page, select Restricted.

  5. (Optional) Provide a Replacement Product ID, if there is another product that will take the place of the product you are removing.

  6. Review the information for accuracy, and then choose Submit.

A What’s next informational page displays after you submit the product removal request. The AWS Marketplace Seller Operations reviews and processes your request. Check the status of your submission by viewing Requests.

After your product is removed, the product appears in the Current Products list in the AWS Marketplace Management Portal. In Current Products, the only action that you can perform is downloading the spreadsheet for the product. You can't edit or submit another sunset request.

If you have questions about product removals, contact the AWS Marketplace Seller Operations team.

Troubleshooting common errors when submitting change requests

When you make changes to your product's information, you might run into errors. Following are some common issues and suggestions for how to fix them:

  • Scanning your AMI – Several issues could happen when scanning your AMI:

    • You have not granted AWS Marketplace permissions to scan your AMI. Grant AWS Marketplace permissions to access it. Or you have granted permissions, but the permissions boundary is too restrictive. For more information, see Give AWS Marketplace access to your AMI.

    • If scanning finds security issues or Common Vulnerabilities and Exposures (CVEs) in your AMI, make sure you're using the latest patches for the operating system in your image. For more information, see AMI-based product requirements.

    For general guidelines about building an AMI, see Best practices for building AMIs.

  • AWS Marketplace Management Portal fields – Some fields in the AWS Marketplace Management Portal require very specific information:

    • If you are unsure about what the field is requesting, try checking the details in the console. Most fields have text descriptions above the field, and formatting requirements below the field.

    • If you try to submit a form with one or more invalid fields, a list of issues is shown. A recommended action is provided to help you fix the issue.

    • If you're asked to provide an ARN, you will typically find it elsewhere in the console. For example, the ARN for the IAM role that you created to give AWS Marketplace access to your AMI is found on the Roles page in the IAM console. ARNs all have a similar format. For example, an IAM role ARN is in the form arn:aws:iam::123456789012:role/exampleRole.

    • Your logos and videos must be provided as a URL directly to the content. For more information about logo formats, see Company and product logo requirements.

    For more information about submitting products and version change requests, see Submitting your product for publication.

  • Product Load Form (PLF) issues – PLFs contain instructions that are included in the spreadsheet. Overall instructions are provided in the Instructions table. Each field has instructions for how to fill it out—select the field to reveal the instructions.

  • Request in Progress – Some requests can't happen in parallel. You can only have one request to update specific information in progress for a product at a time. You can see all of your requests still under review on the Requests tab of the Server products page in AWS Marketplace Management Portal. If you have a pending request that you did not intend, you can cancel it and then submit a new request with the change that you want to make.

    • You can't update version information when an update (to add or restrict) a version is ongoing.

    • If there is a request pending from the AWS Marketplace Seller Operations team, you can't submit any new changes.

  • Unexplained error – If your submission fails with no explanation, try again. Occasionally, server load causes a submission to fail.

If you're still having problems with a change request, contact the AWS Marketplace Seller Operations team.