Oracle Cloud Infrastructure Documentation

Working with Listings

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

  • Filter listings to find what you want
  • 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 An IAM document that specifies who has what type of access to your resources. It is used in different ways: to mean an individual statement written in the policy language; to mean a collection of statements in a single, named "policy" document (which has an Oracle Cloud ID (OCID) assigned to it); and to mean the overall body of policies your organization uses to control access to resources. 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 A collection of related resources that can be accessed only by certain groups that have been given permission by an administrator in your organization. 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 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.

Using the Console

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: