Working with Listings

This topic describes how to work with listings in the Oracle Cloud Infrastructure Marketplace. You can do the following:

  • Search for listings to find what you want to deploy
  • Filter listings to refine application results
  • View a listing to learn about the product that it offers
  • Launch an instance from an image listing
  • Launch stack resources from a stack listing

By default, Oracle Cloud Infrastructure Marketplace displays all listings in its catalog. Image listings have a Launch Instance button. Stack listings have a Launch Stack button.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should work in.

For administrators, the following policies provide access to Marketplace. These policies specify different target groups as examples, but you can specify the same target group (for example, MarketplaceUsers) when applying the policies in your own tenancy.

  • The policy Let users list and subscribe to images from the Partner Image catalog gives the specified group the ability to list, read, and use Marketplace image listings.
  • The policy Let users launch Compute instances gives the specified group general access to managing instances and images, along with the required level of access to attach existing block volumes to the instances. Use this policy in conjunction with the preceding policy for users who need to launch instances from image listings. Use this policy in conjunction with the following policy for users who need to launch stacks from stack listings.
  • The policies described in Policies for Managing Stacks and Jobs grant access to stacks and jobs in the tenancy. Use the appropriate policy statements to give a group the ability to list, read, and use Marketplace stack listings. (Users do not need permission to run destroy jobs to launch a stack from a Marketplace listing, but they do need permissions to run plan jobs and apply jobs.)
  • If you need to write more restrictive policies for Marketplace, see Details for the Core Services and Details for Resource Manager, as needed.

If you're new to policies, see Getting Started with Policies and Common Policies.

Pricing for Listings

Marketplace listings belong to one of several pricing models available to and set by the publisher when the publisher creates the listing. Pricing models include:

  • Free: usage incurs no charge
  • BYOL: usage relies on software licenses that you already own
  • Paid: usage incurs charges based on hourly rates, either according to OCPU hours consumed or according to the number of instances (irrespective of OCPU hours consumed by each)

The listing price does not include any additional fees that you might incur for the use of infrastructure resources.

Using the Console

To find a listing
To filter listings
To view a listing's details
To launch an instance based on an image
To launch a stack

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use the following operations to work with listings: