Working with Listings

Learn about the ways in which you can work with Oracle Cloud Infrastructure (OCI) Marketplace listings in the Marketplace catalog.

To work with listings in the OCI Marketplace catalog, 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 a listing with additional currencies
  • Launch an instance from an image listing
  • Launch stack resources from a stack listing
  • Export a container image or helm chart to your tenancy
  • Download Terraform configuration files from stack listings to update deployed applications
By default, Marketplace displays all listings in its catalog. However, an individual's ability to see or launch particular listings varies by tenancy, according to what permissions the individual has, and the pricing model for the listing.
Note

If you launch a listing through CLI or API, ensure that you subscribe to the listing. When you launch a listing through the console, accept the agreement check box to continue. For information on how to subscribe to the listing, see API GetListing.

Listings are either images, stacks, container images, or helm charts. Image listings have a Launch Instance button. Stack listings have a Launch Stack button. Container and helm charts have a Export Package button.

For information about pricing and how it affects whether you can see a listing, see Pricing for Listings.

Pricing for Listings

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

  • Free: Listings usage incurs no charge.
  • BYOL: Listings usage relies on software licenses that you already own.
  • Paid: Listings usage incurs charges based on hourly rates. The charges are 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.

For information about supported countries and currencies for paid listings, see the Territory for Paid Publisher Listings of Marketplace Content section under Oracle Cloud Marketplace Territory and Export Compliance Policy.

If you do not find your country, and/or the currency details in the following table, then we currently do not support them.
Note

Subscribed Region and Subscription Region in your Oracle Cloud Account are two different entities.Subscribed Region is the region to which your Oracle Cloud Account is subscribed. You can launch other Oracle Cloud Resources in different regions from your subscribed region. Whereas, Subscription Region is where the country or currency of your Oracle Cloud Account's subscription is subscribed to pay. Subscription region entitles customers on how they get billed by Oracle.

For example, if the partner enables a listing for your country, you can launch that listing in any region to which your Oracle Cloud Account is subscribed.

For a cloud subscription to access paid listings, it must have a United States, United Kingdom, Canada, or Brazil to bill address. The form of payment provided when the subscription was created must support payment in United States dollar, British pound sterling, Canadian dollar, or Brazilian real. Users in United Kingdom government tenancies do not have access to any paid listings.

Required IAM Policy

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

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

For administrators, the policies you need to create to provide users with access to Marketplace depend on whether the tenancy is in a commercial region, the United Kingdom Government Cloud region, or the United States Government Cloud realm.

Note

In commercial regions and the United Kingdom Government Cloud region, administrators do not need to write policies to grant users the ability to list or read listings. In these regions, you can see individual listings and lists of listings by default. Furthermore, to reduce the scope of access to a particular compartment, specify the specific compartment instead of the tenancy in the policy statement.

For a Tenancy in a Commercial Region or the United Kingdom Government Cloud

  • The following policy gives the specified example group, MarketplaceUsers, the ability to list accepted terms of use agreements. However, it does not include the ability to accept a terms of use agreement. The terms of use agreement for a given listing must be viewed and accepted prior to launch. For a policy that includes the ability to use listings, see the policy statements later in this section that grant access to the type of listing you want to launch, whether an image, stack, container image, or a helm chart.

    Allow group MarketplaceUsers to inspect compartments in tenancy
    
    Allow group MarketplaceUsers to read app-catalog-listing in tenancy
  • The following policy gives the specified example group, MarketplaceUsers, the ability to not only list and read, but also use Marketplace listings. It does not include the ability to create instances using images from listings. (For that, see the next set of policy statements.)

    Allow group MarketplaceUsers to inspect compartments in tenancy
    Allow group MarketplaceUsers to manage app-catalog-listing in tenancy
    
  • The following policy gives the specified example group, MarketplaceUsers, 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. For users who need to launch stacks, container images, and helm charts, use this policy in conjunction with the next set of policy statements.

    Allow group MarketplaceUsers to manage instance-family in compartment ABC
    
    Allow group MarketplaceUsers to read app-catalog-listing in tenancy
    
    Allow group MarketplaceUsers to use volume-family in compartment ABC
    
    Allow group MarketplaceUsers to use virtual-network-family in compartment XYZ
    
  • The policies described in IAM Policies 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.)
  • The following policy gives the specified example group, MarketplaceUser, the ability to manage container images or repositories in the specified example compartment in any possible way.
    Allow group MarketplaceUser to manage repos in
    compartment ABC

If you need to write more restrictive policies, see the policy references on which these policies were based, Details for the Core Services and Details for the Resource Manager, as needed.

For a Tenancy in the US Government Cloud Realm

Note

The following policies assume you already have existing policies for the specified groups to address the ability to inspect anything in the tenancy, including all compartments.
  • The following policy gives the specified example group, MarketplaceUsers, the ability to view all listings in the specified example compartment:

    Allow group MarketplaceUsers to read marketplace-listings in compartment ABC
  • The following policy gives the specified example group, MarketplaceUsers, the ability to work with all listings in the specified example compartment in any way possible. The statements include the ability to accept terms of use agreements, view listings, and create images, stacks, containers, and helm charts:

    Allow group MarketplaceUsers to manage app-catalog-listings in compartment ABC
    Allow group MarketplaceUsers to use marketplace-listings in compartment ABC
    Allow group MarketplaceUsers to manage instance-family in compartment ABC
    Allow group MarketplaceUsers to use volume-family in compartment ABC
    Allow group MarketplaceUsers to manage virtual-network-family in compartment ABC
    Allow group MarketplaceUsers to manage orm-stack in compartment ABC
    Allow group MarketplaceUsers to manage orm-job in compartment ABC
  • The following policy gives the specified example group, MarketplaceUsers, the ability to work with specific listings in the specified example compartment in any way possible. The statements include the ability to list and subscribe to images and the ability to create images, stacks, containers, and helm charts:

    Allow group MarketplaceUsers to manage app-catalog-listings in compartment ABC
    Allow group MarketplaceUsers to use marketplace-listings in compartment ABC where any {listing.id='123456', listing.id='987654'}
    Allow group MarketplaceUsers to manage instance-family in compartment ABC
    Allow group MarketplaceUsers to use volume-family in compartment ABC
    Allow group MarketplaceUsers to manage virtual-network-family in compartment ABC
    Allow group MarketplaceUsers to manage orm-stack in compartment ABC
    Allow group MarketplaceUsers to manage orm-job in compartment ABC
  • The following policy gives the specified example group, AgreementAcceptors, the ability to accept the terms of use agreement for any listing in the specified example compartment. The statements make it possible for anyone with the appropriate permissions to launch an images, listings, stacks, containers, and helm charts without having the permission to accept the terms of use agreement themselves:

    Allow group AgreementAcceptors to read marketplace-listings in compartment ABC
    Allow group AgreementAcceptors to manage app-catalog-listings in compartment ABC

If you need to write more restrictive policies, see the policy reference on which policies for tenancies in the US Government Cloud realm were based, Details for the Marketplace Service.