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
- 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.
Listings are either image listings or stack listings. Image listings have a Launch Instance button. Stack listings have a Launch Stack 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.
| Country | Currency |
|---|---|
| Brazil | BRL, USD |
| Canada | CAD, USD |
| United Kingdom | GBP, USD |
| United States | USD |
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.
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 listing or a stack listing.
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 from stack listings, 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.)
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
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 and stacks from listings:
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 and stacks from listings:
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 image or stack from a listing 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.