1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Marketplace
  5. getListingPackages
Oracle Cloud Infrastructure v1.10.0 published on Thursday, Sep 7, 2023 by Pulumi

oci.Marketplace.getListingPackages

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v1.10.0 published on Thursday, Sep 7, 2023 by Pulumi

    This data source provides the list of Listing Packages in Oracle Cloud Infrastructure Marketplace service.

    Gets the list of packages for a listing.

    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

    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testListingPackages = Oci.Marketplace.GetListingPackages.Invoke(new()
        {
            ListingId = oci_marketplace_listing.Test_listing.Id,
            CompartmentId = @var.Compartment_id,
            PackageType = @var.Listing_package_package_type,
            PackageVersion = @var.Listing_package_package_version,
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/go/oci/Marketplace"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := Marketplace.GetListingPackages(ctx, &marketplace.GetListingPackagesArgs{
    			ListingId:      oci_marketplace_listing.Test_listing.Id,
    			CompartmentId:  pulumi.StringRef(_var.Compartment_id),
    			PackageType:    pulumi.StringRef(_var.Listing_package_package_type),
    			PackageVersion: pulumi.StringRef(_var.Listing_package_package_version),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.Marketplace.MarketplaceFunctions;
    import com.pulumi.oci.Marketplace.inputs.GetListingPackagesArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var testListingPackages = MarketplaceFunctions.getListingPackages(GetListingPackagesArgs.builder()
                .listingId(oci_marketplace_listing.test_listing().id())
                .compartmentId(var_.compartment_id())
                .packageType(var_.listing_package_package_type())
                .packageVersion(var_.listing_package_package_version())
                .build());
    
        }
    }
    
    import pulumi
    import pulumi_oci as oci
    
    test_listing_packages = oci.Marketplace.get_listing_packages(listing_id=oci_marketplace_listing["test_listing"]["id"],
        compartment_id=var["compartment_id"],
        package_type=var["listing_package_package_type"],
        package_version=var["listing_package_package_version"])
    
    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testListingPackages = oci.Marketplace.getListingPackages({
        listingId: oci_marketplace_listing.test_listing.id,
        compartmentId: _var.compartment_id,
        packageType: _var.listing_package_package_type,
        packageVersion: _var.listing_package_package_version,
    });
    
    variables:
      testListingPackages:
        fn::invoke:
          Function: oci:Marketplace:getListingPackages
          Arguments:
            listingId: ${oci_marketplace_listing.test_listing.id}
            compartmentId: ${var.compartment_id}
            packageType: ${var.listing_package_package_type}
            packageVersion: ${var.listing_package_package_version}
    

    Using getListingPackages

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getListingPackages(args: GetListingPackagesArgs, opts?: InvokeOptions): Promise<GetListingPackagesResult>
    function getListingPackagesOutput(args: GetListingPackagesOutputArgs, opts?: InvokeOptions): Output<GetListingPackagesResult>
    def get_listing_packages(compartment_id: Optional[str] = None,
                             filters: Optional[Sequence[_marketplace.GetListingPackagesFilter]] = None,
                             listing_id: Optional[str] = None,
                             package_type: Optional[str] = None,
                             package_version: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetListingPackagesResult
    def get_listing_packages_output(compartment_id: Optional[pulumi.Input[str]] = None,
                             filters: Optional[pulumi.Input[Sequence[pulumi.Input[_marketplace.GetListingPackagesFilterArgs]]]] = None,
                             listing_id: Optional[pulumi.Input[str]] = None,
                             package_type: Optional[pulumi.Input[str]] = None,
                             package_version: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetListingPackagesResult]
    func GetListingPackages(ctx *Context, args *GetListingPackagesArgs, opts ...InvokeOption) (*GetListingPackagesResult, error)
    func GetListingPackagesOutput(ctx *Context, args *GetListingPackagesOutputArgs, opts ...InvokeOption) GetListingPackagesResultOutput

    > Note: This function is named GetListingPackages in the Go SDK.

    public static class GetListingPackages 
    {
        public static Task<GetListingPackagesResult> InvokeAsync(GetListingPackagesArgs args, InvokeOptions? opts = null)
        public static Output<GetListingPackagesResult> Invoke(GetListingPackagesInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetListingPackagesResult> getListingPackages(GetListingPackagesArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: oci:Marketplace/getListingPackages:getListingPackages
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ListingId string

    The unique identifier for the listing.

    CompartmentId string

    The unique identifier for the compartment.

    Filters List<GetListingPackagesFilter>
    PackageType string

    A filter to return only packages that match the given package type exactly.

    PackageVersion string

    The version of the package. Package versions are unique within a listing.

    ListingId string

    The unique identifier for the listing.

    CompartmentId string

    The unique identifier for the compartment.

    Filters []GetListingPackagesFilter
    PackageType string

    A filter to return only packages that match the given package type exactly.

    PackageVersion string

    The version of the package. Package versions are unique within a listing.

    listingId String

    The unique identifier for the listing.

    compartmentId String

    The unique identifier for the compartment.

    filters List<GetListingPackagesFilter>
    packageType String

    A filter to return only packages that match the given package type exactly.

    packageVersion String

    The version of the package. Package versions are unique within a listing.

    listingId string

    The unique identifier for the listing.

    compartmentId string

    The unique identifier for the compartment.

    filters GetListingPackagesFilter[]
    packageType string

    A filter to return only packages that match the given package type exactly.

    packageVersion string

    The version of the package. Package versions are unique within a listing.

    listing_id str

    The unique identifier for the listing.

    compartment_id str

    The unique identifier for the compartment.

    filters GetListingPackagesFilter]
    package_type str

    A filter to return only packages that match the given package type exactly.

    package_version str

    The version of the package. Package versions are unique within a listing.

    listingId String

    The unique identifier for the listing.

    compartmentId String

    The unique identifier for the compartment.

    filters List<Property Map>
    packageType String

    A filter to return only packages that match the given package type exactly.

    packageVersion String

    The version of the package. Package versions are unique within a listing.

    getListingPackages Result

    The following output properties are available:

    Id string

    The provider-assigned unique ID for this managed resource.

    ListingId string

    The ID of the listing that the specified package belongs to.

    ListingPackages List<GetListingPackagesListingPackage>

    The list of listing_packages.

    CompartmentId string
    Filters List<GetListingPackagesFilter>
    PackageType string

    The specified package's type.

    PackageVersion string
    Id string

    The provider-assigned unique ID for this managed resource.

    ListingId string

    The ID of the listing that the specified package belongs to.

    ListingPackages []GetListingPackagesListingPackage

    The list of listing_packages.

    CompartmentId string
    Filters []GetListingPackagesFilter
    PackageType string

    The specified package's type.

    PackageVersion string
    id String

    The provider-assigned unique ID for this managed resource.

    listingId String

    The ID of the listing that the specified package belongs to.

    listingPackages List<GetListingPackagesListingPackage>

    The list of listing_packages.

    compartmentId String
    filters List<GetListingPackagesFilter>
    packageType String

    The specified package's type.

    packageVersion String
    id string

    The provider-assigned unique ID for this managed resource.

    listingId string

    The ID of the listing that the specified package belongs to.

    listingPackages GetListingPackagesListingPackage[]

    The list of listing_packages.

    compartmentId string
    filters GetListingPackagesFilter[]
    packageType string

    The specified package's type.

    packageVersion string
    id str

    The provider-assigned unique ID for this managed resource.

    listing_id str

    The ID of the listing that the specified package belongs to.

    listing_packages GetListingPackagesListingPackage]

    The list of listing_packages.

    compartment_id str
    filters GetListingPackagesFilter]
    package_type str

    The specified package's type.

    package_version str
    id String

    The provider-assigned unique ID for this managed resource.

    listingId String

    The ID of the listing that the specified package belongs to.

    listingPackages List<Property Map>

    The list of listing_packages.

    compartmentId String
    filters List<Property Map>
    packageType String

    The specified package's type.

    packageVersion String

    Supporting Types

    GetListingPackagesFilter

    Name string

    The name of the variable.

    Values List<string>
    Regex bool
    Name string

    The name of the variable.

    Values []string
    Regex bool
    name String

    The name of the variable.

    values List<String>
    regex Boolean
    name string

    The name of the variable.

    values string[]
    regex boolean
    name str

    The name of the variable.

    values Sequence[str]
    regex bool
    name String

    The name of the variable.

    values List<String>
    regex Boolean

    GetListingPackagesListingPackage

    ListingId string

    The unique identifier for the listing.

    OperatingSystems List<GetListingPackagesListingPackageOperatingSystem>

    The operating system used by the listing.

    PackageType string

    A filter to return only packages that match the given package type exactly.

    PackageVersion string

    The version of the package. Package versions are unique within a listing.

    Pricings List<GetListingPackagesListingPackagePricing>

    The model for pricing.

    Regions List<GetListingPackagesListingPackageRegion>

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    ResourceId string

    The unique identifier for the package resource.

    TimeCreated string

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    ListingId string

    The unique identifier for the listing.

    OperatingSystems []GetListingPackagesListingPackageOperatingSystem

    The operating system used by the listing.

    PackageType string

    A filter to return only packages that match the given package type exactly.

    PackageVersion string

    The version of the package. Package versions are unique within a listing.

    Pricings []GetListingPackagesListingPackagePricing

    The model for pricing.

    Regions []GetListingPackagesListingPackageRegion

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    ResourceId string

    The unique identifier for the package resource.

    TimeCreated string

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    listingId String

    The unique identifier for the listing.

    operatingSystems List<GetListingPackagesListingPackageOperatingSystem>

    The operating system used by the listing.

    packageType String

    A filter to return only packages that match the given package type exactly.

    packageVersion String

    The version of the package. Package versions are unique within a listing.

    pricings List<GetListingPackagesListingPackagePricing>

    The model for pricing.

    regions List<GetListingPackagesListingPackageRegion>

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    resourceId String

    The unique identifier for the package resource.

    timeCreated String

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    listingId string

    The unique identifier for the listing.

    operatingSystems GetListingPackagesListingPackageOperatingSystem[]

    The operating system used by the listing.

    packageType string

    A filter to return only packages that match the given package type exactly.

    packageVersion string

    The version of the package. Package versions are unique within a listing.

    pricings GetListingPackagesListingPackagePricing[]

    The model for pricing.

    regions GetListingPackagesListingPackageRegion[]

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    resourceId string

    The unique identifier for the package resource.

    timeCreated string

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    listing_id str

    The unique identifier for the listing.

    operating_systems GetListingPackagesListingPackageOperatingSystem]

    The operating system used by the listing.

    package_type str

    A filter to return only packages that match the given package type exactly.

    package_version str

    The version of the package. Package versions are unique within a listing.

    pricings GetListingPackagesListingPackagePricing]

    The model for pricing.

    regions GetListingPackagesListingPackageRegion]

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    resource_id str

    The unique identifier for the package resource.

    time_created str

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    listingId String

    The unique identifier for the listing.

    operatingSystems List<Property Map>

    The operating system used by the listing.

    packageType String

    A filter to return only packages that match the given package type exactly.

    packageVersion String

    The version of the package. Package versions are unique within a listing.

    pricings List<Property Map>

    The model for pricing.

    regions List<Property Map>

    The regions where you can deploy the listing package. (Some packages have restrictions that limit their deployment to United States regions only.)

    resourceId String

    The unique identifier for the package resource.

    timeCreated String

    The date and time this listing package was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

    GetListingPackagesListingPackageOperatingSystem

    Name string

    The name of the variable.

    Name string

    The name of the variable.

    name String

    The name of the variable.

    name string

    The name of the variable.

    name str

    The name of the variable.

    name String

    The name of the variable.

    GetListingPackagesListingPackagePricing

    Currency string

    The currency of the pricing model.

    InternationalMarketPrices List<GetListingPackagesListingPackagePricingInternationalMarketPrice>

    The model for international market pricing.

    PayGoStrategy string

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    Rate double

    The pricing rate.

    Type string

    The type of the pricing model.

    Currency string

    The currency of the pricing model.

    InternationalMarketPrices []GetListingPackagesListingPackagePricingInternationalMarketPrice

    The model for international market pricing.

    PayGoStrategy string

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    Rate float64

    The pricing rate.

    Type string

    The type of the pricing model.

    currency String

    The currency of the pricing model.

    internationalMarketPrices List<GetListingPackagesListingPackagePricingInternationalMarketPrice>

    The model for international market pricing.

    payGoStrategy String

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    rate Double

    The pricing rate.

    type String

    The type of the pricing model.

    currency string

    The currency of the pricing model.

    internationalMarketPrices GetListingPackagesListingPackagePricingInternationalMarketPrice[]

    The model for international market pricing.

    payGoStrategy string

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    rate number

    The pricing rate.

    type string

    The type of the pricing model.

    currency str

    The currency of the pricing model.

    international_market_prices GetListingPackagesListingPackagePricingInternationalMarketPrice]

    The model for international market pricing.

    pay_go_strategy str

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    rate float

    The pricing rate.

    type str

    The type of the pricing model.

    currency String

    The currency of the pricing model.

    internationalMarketPrices List<Property Map>

    The model for international market pricing.

    payGoStrategy String

    The type of pricing for a PAYGO model, eg PER_OCPU_LINEAR, PER_OCPU_MIN_BILLING, PER_INSTANCE. Null if type is not PAYGO.

    rate Number

    The pricing rate.

    type String

    The type of the pricing model.

    GetListingPackagesListingPackagePricingInternationalMarketPrice

    CurrencyCode string

    The currency of the pricing model.

    CurrencySymbol string

    The symbol of the currency

    Rate double

    The pricing rate.

    CurrencyCode string

    The currency of the pricing model.

    CurrencySymbol string

    The symbol of the currency

    Rate float64

    The pricing rate.

    currencyCode String

    The currency of the pricing model.

    currencySymbol String

    The symbol of the currency

    rate Double

    The pricing rate.

    currencyCode string

    The currency of the pricing model.

    currencySymbol string

    The symbol of the currency

    rate number

    The pricing rate.

    currency_code str

    The currency of the pricing model.

    currency_symbol str

    The symbol of the currency

    rate float

    The pricing rate.

    currencyCode String

    The currency of the pricing model.

    currencySymbol String

    The symbol of the currency

    rate Number

    The pricing rate.

    GetListingPackagesListingPackageRegion

    Code string

    A code assigned to the item.

    Countries List<GetListingPackagesListingPackageRegionCountry>

    Countries in the region.

    Name string

    The name of the variable.

    Code string

    A code assigned to the item.

    Countries []GetListingPackagesListingPackageRegionCountry

    Countries in the region.

    Name string

    The name of the variable.

    code String

    A code assigned to the item.

    countries List<GetListingPackagesListingPackageRegionCountry>

    Countries in the region.

    name String

    The name of the variable.

    code string

    A code assigned to the item.

    countries GetListingPackagesListingPackageRegionCountry[]

    Countries in the region.

    name string

    The name of the variable.

    code str

    A code assigned to the item.

    countries GetListingPackagesListingPackageRegionCountry]

    Countries in the region.

    name str

    The name of the variable.

    code String

    A code assigned to the item.

    countries List<Property Map>

    Countries in the region.

    name String

    The name of the variable.

    GetListingPackagesListingPackageRegionCountry

    Code string

    A code assigned to the item.

    Name string

    The name of the variable.

    Code string

    A code assigned to the item.

    Name string

    The name of the variable.

    code String

    A code assigned to the item.

    name String

    The name of the variable.

    code string

    A code assigned to the item.

    name string

    The name of the variable.

    code str

    A code assigned to the item.

    name str

    The name of the variable.

    code String

    A code assigned to the item.

    name String

    The name of the variable.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes

    This Pulumi package is based on the oci Terraform Provider.

    oci logo
    Oracle Cloud Infrastructure v1.10.0 published on Thursday, Sep 7, 2023 by Pulumi