Data Source: oci_marketplace_listing

This data source provides details about a specific Listing resource in Oracle Cloud Infrastructure Marketplace service.

Gets detailed information about a listing, including the listing’s name, version, description, and resources.

If you plan to launch an instance from an image listing, you must first subscribe to the listing. When you launch the instance, you also need to provide the image ID of the listing resource version that you want.

Subscribing to the listing requires you to first get a signature from the terms of use agreement for the listing resource version. To get the signature, issue a GetAppCatalogListingAgreements API call. The AppCatalogListingResourceVersionAgreements object, including its signature, is returned in the response. With the signature for the terms of use agreement for the desired listing resource version, create a subscription by issuing a CreateAppCatalogSubscription API call.

To get the image ID to launch an instance, issue a GetAppCatalogListingResourceVersion API call. Lastly, to launch the instance, use the image ID of the listing resource version to issue a LaunchInstance API call.

Example Usage

data "oci_marketplace_listing" "test_listing" {
	#Required
	listing_id = oci_marketplace_listing.test_listing.id

	#Optional
	compartment_id = var.compartment_id
}

Argument Reference

The following arguments are supported:

• compartment_id - (Optional) The unique identifier for the compartment. It is mandatory when used in non-commercial realms.
• listing_id - (Required) The unique identifier for the listing.

Attributes Reference

The following attributes are exported:

• banner - The model for upload data for images and icons.
  • content_url - The content URL of the upload data.
  • file_extension - The file extension of the upload data.
  • mime_type - The MIME type of the upload data.
  • name - The name used to refer to the upload data.
• categories - Product categories that the listing belongs to.
• compatible_architectures - The list of compatible architectures supported by the listing
• default_package_version - The default package version.
• documentation_links - Links to additional documentation provided by the publisher specifically for the listing.
  • document_category - The category that the document belongs to.
  • name - Text that describes the resource.
  • url - The URL of the resource.
• icon - The model for upload data for images and icons.
  • content_url - The content URL of the upload data.
  • file_extension - The file extension of the upload data.
  • mime_type - The MIME type of the upload data.
  • name - The name used to refer to the upload data.
• id - The unique identifier for the listing in Marketplace.
• is_featured - Indicates whether the listing is included in Featured Listings.
• keywords - Keywords associated with the listing.
• languages - Languages supported by the listing.
  • code - A code assigned to the item.
  • name - The name of the item.
• license_model_description - A description of the publisher’s licensing model for the listing.
• links - Links to reference material.
  • href - The anchor tag.
  • rel - Reference links to the previous page, next page, and other pages.
• listing_type - The publisher category to which the listing belongs. The publisher category informs where the listing appears for use.
• long_description - A long description of the listing.
• name - The name of the listing.
• package_type - The listing’s package type.
• publisher - Summary details about the publisher of the listing.
  • contact_email - The email address of the publisher.
  • contact_phone - The phone number of the publisher.
  • description - A description of the publisher.
  • hq_address - The address of the publisher’s headquarters.
  • id - The unique identifier for the publisher.
  • links - Reference links.
    • href - The anchor tag.
    • rel - Reference links to the previous page, next page, and other pages.
  • logo - The model for upload data for images and icons.
    • content_url - The content URL of the upload data.
    • file_extension - The file extension of the upload data.
    • mime_type - The MIME type of the upload data.
    • name - The name used to refer to the upload data.
  • name - The name of the publisher.
  • website_url - The publisher’s website.
  • year_founded - The year the publisher’s company or organization was founded.
• regions - The regions where the listing is eligible to be deployed.
  • code - The code of the region.
  • countries - Countries in the region.
    • code - A code assigned to the item.
    • name - The name of the item.
  • name - The name of the region.
• release_notes - Release notes for the listing.
• screenshots - Screenshots of the listing.
  • content_url - The content URL of the screenshot.
  • description - A description of the screenshot.
  • file_extension - The file extension of the screenshot.
  • mime_type - The MIME type of the screenshot.
  • name - The name of the screenshot.
• short_description - A short description of the listing.
• support_contacts - Contact information to use to get support from the publisher for the listing.
  • email - The email of the contact.
  • name - The name of the contact.
  • phone - The phone number of the contact.
  • subject - The email subject line to use when contacting support.
• support_links - Links to support resources for the listing.
  • name - Text that describes the resource.
  • url - The URL of the resource.
• supported_operating_systems - The list of operating systems supported by the listing.
  • name - The name of the operating system.
• system_requirements - System requirements for the listing.
• tagline - The tagline of the listing.
• time_released - The release date of the listing.
• usage_information - Usage information for the listing.
• version - The version of the listing.
• videos - Videos of the listing.
  • name - Text that describes the resource.
  • url - The URL of the resource.