Launch an Amazon Web Services Marketplace instance - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Launch an Amazon Web Services Marketplace instance

You can subscribe to an Amazon Web Services Marketplace product and launch an instance from the product's AMI using the Amazon EC2 launch wizard. For more information about paid AMIs, see Paid AMIs. To cancel your subscription after launch, you first have to terminate all instances running from it. For more information, see Manage your Amazon Web Services Marketplace subscriptions.

New console
To launch an instance from the Amazon Web Services Marketplace using the launch wizard
  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

  2. From the Amazon EC2 console dashboard, choose Launch instance.

  3. (Optional) Under Name and tags, for Name, enter a descriptive name for your instance.

  4. Under Application and OS Images (Amazon Machine Image), choose Browse more AMIs, and then choose the Amazon Web Services Marketplace AMIs tab. Find a suitable AMI by browsing the categories or using the search functionality. To choose a product, choose Select.

  5. A window opens with an overview of the product you've selected. You can view the pricing information, as well as any other information that the vendor has provided. When you're ready, choose one of the following buttons:

    • Subscribe on instance launch – Your subscription starts when you choose Launch instance (at Step 10).

    • Subscribe now – Your subscription starts immediately. While the subscription is underway, you can configure the instance by continuing with the steps in this procedure. If there are any problems with your credit card details, you will be asked to update your account details.

    Note

    You're not charged for using the product until you have launched an instance with the AMI. Take note of the pricing for each supported instance type when you select an instance type. Additional taxes might also apply to the product.

  6. For Instance type, select an instance type for your instance. The instance type defines the hardware configuration and size of the instance to launch.

  7. Under Key pair (login), for Key pair name, choose an existing key pair or create a new one.

  8. Under Network settings, Firewall (security groups), take note of the new security group that was created according to the vendor's specifications for the product. The security group might include rules that allow all IPv4 addresses (0.0.0.0/0) access on SSH (port 22) on Linux or RDP (port 3389) on Windows. We recommend that you adjust these rules to allow only a specific address or range of addresses to access your instance over those ports.

  9. You can use the other fields on the screen to configure your instance, add storage, and add tags. For information about the different options that you can configure, see Launch an instance using defined parameters.

  10. In the Summary panel, under Software Image (AMI), check the details of the AMI from which you're about to launch the instance. Also check the other configuration details that you specified. When you're ready to launch your instance, choose Launch instance.

  11. Depending on the product you've subscribed to, the instance might take a few minutes or more to launch. If you chose Subscribe on instance launch at Step 5, you are first subscribed to the product before your instance can launch. If there are any problems with your credit card details, you will be asked to update your account details. When the launch confirmation page displays, choose View all instances to go to the Instances page.

    Note

    You are charged the subscription price as long as your instance is in the running state, even if it is idle. If your instance is stopped, you might still be charged for storage.

  12. When your instance is in the running state, you can connect to it. To do this, select your instance in the list, choose Connect, and choose a connection option. For more information about connecting to your instance, see Connect to your Linux instance.

    Important

    Check the vendor's usage instructions carefully, as you might need to use a specific user name to connect to your instance. For information about accessing your subscription details, see Manage your Amazon Web Services Marketplace subscriptions.

  13. If the instance fails to launch or the state immediately goes to terminated instead of running, see Troubleshoot instance launch issues.

Old console
To launch an instance from the Amazon Web Services Marketplace using the launch wizard
  1. Open the Amazon EC2 console at https://console.amazonaws.cn/ec2/.

  2. From the Amazon EC2 dashboard, choose Launch instance.

  3. On the Choose an Amazon Machine Image (AMI) page, choose the Amazon Web Services Marketplace category on the left. Find a suitable AMI by browsing the categories, or using the search functionality. Choose Select to choose your product.

  4. A dialog displays an overview of the product you've selected. You can view the pricing information, as well as any other information that the vendor has provided. When you're ready, choose Continue.

    Note

    You are not charged for using the product until you have launched an instance with the AMI. Take note of the pricing for each supported instance type, as you will be prompted to select an instance type on the next page of the wizard. Additional taxes may also apply to the product.

  5. On the Choose an Instance Type page, select the hardware configuration and size of the instance to launch. When you're done, choose Next: Configure Instance Details.

  6. On the next pages of the wizard, you can configure your instance, add storage, and add tags. For more information about the different options you can configure, see Launch an instance using the old launch instance wizard. Choose Next until you reach the Configure Security Group page.

    The wizard creates a new security group according to the vendor's specifications for the product. The security group may include rules that allow all IPv4 addresses (0.0.0.0/0) access on SSH (port 22) on Linux or RDP (port 3389) on Windows. We recommend that you adjust these rules to allow only a specific address or range of addresses to access your instance over those ports.

    When you are ready, choose Review and Launch.

  7. On the Review Instance Launch page, check the details of the AMI from which you're about to launch the instance, as well as the other configuration details you set up in the wizard. When you're ready, choose Launch to select or create a key pair, and launch your instance.

  8. Depending on the product you've subscribed to, the instance may take a few minutes or more to launch. You are first subscribed to the product before your instance can launch. If there are any problems with your credit card details, you will be asked to update your account details. When the launch confirmation page displays, choose View Instances to go to the Instances page.

    Note

    You are charged the subscription price as long as your instance is running, even if it is idle. If your instance is stopped, you may still be charged for storage.

  9. When your instance is in the running state, you can connect to it. To do this, select your instance in the list and choose Connect. Follow the instructions in the dialog. For more information about connecting to your instance, see Connect to your Linux instance.

    Important

    Check the vendor's usage instructions carefully, as you may need to use a specific user name to log in to the instance. For more information about accessing your subscription details, see Manage your Amazon Web Services Marketplace subscriptions.

  10. If the instance fails to launch or the state immediately goes to terminated instead of running, see Troubleshoot instance launch issues.

Launch an Amazon Web Services Marketplace AMI instance using the API and CLI

To launch instances from Amazon Web Services Marketplace products using the API or command line tools, first ensure that you are subscribed to the product. You can then launch an instance with the product's AMI ID using the following methods:

Method Documentation

Amazon CLI

Use the run-instances command, or see the following topic for more information: Launching an Instance.

Amazon Tools for Windows PowerShell

Use the New-EC2Instance command, or see the following topic for more information: Launch an Amazon EC2 Instance Using Windows PowerShell

Query API Use the RunInstances request.