1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. LicenseManager
  5. ProductLicense
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

oci.LicenseManager.ProductLicense

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

    This resource provides the Product License resource in Oracle Cloud Infrastructure License Manager service.

    Creates a new product license.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testProductLicense = new oci.licensemanager.ProductLicense("test_product_license", {
        compartmentId: compartmentId,
        displayName: productLicenseDisplayName,
        isVendorOracle: productLicenseIsVendorOracle,
        licenseUnit: productLicenseLicenseUnit,
        definedTags: {
            "foo-namespace.bar-key": "value",
        },
        freeformTags: {
            "bar-key": "value",
        },
        images: [{
            listingId: testListing.id,
            packageVersion: productLicenseImagesPackageVersion,
        }],
        vendorName: productLicenseVendorName,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_product_license = oci.license_manager.ProductLicense("test_product_license",
        compartment_id=compartment_id,
        display_name=product_license_display_name,
        is_vendor_oracle=product_license_is_vendor_oracle,
        license_unit=product_license_license_unit,
        defined_tags={
            "foo-namespace.bar-key": "value",
        },
        freeform_tags={
            "bar-key": "value",
        },
        images=[{
            "listing_id": test_listing["id"],
            "package_version": product_license_images_package_version,
        }],
        vendor_name=product_license_vendor_name)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/LicenseManager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := LicenseManager.NewProductLicense(ctx, "test_product_license", &LicenseManager.ProductLicenseArgs{
    			CompartmentId:  pulumi.Any(compartmentId),
    			DisplayName:    pulumi.Any(productLicenseDisplayName),
    			IsVendorOracle: pulumi.Any(productLicenseIsVendorOracle),
    			LicenseUnit:    pulumi.Any(productLicenseLicenseUnit),
    			DefinedTags: pulumi.StringMap{
    				"foo-namespace.bar-key": pulumi.String("value"),
    			},
    			FreeformTags: pulumi.StringMap{
    				"bar-key": pulumi.String("value"),
    			},
    			Images: licensemanager.ProductLicenseImageArray{
    				&licensemanager.ProductLicenseImageArgs{
    					ListingId:      pulumi.Any(testListing.Id),
    					PackageVersion: pulumi.Any(productLicenseImagesPackageVersion),
    				},
    			},
    			VendorName: pulumi.Any(productLicenseVendorName),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testProductLicense = new Oci.LicenseManager.ProductLicense("test_product_license", new()
        {
            CompartmentId = compartmentId,
            DisplayName = productLicenseDisplayName,
            IsVendorOracle = productLicenseIsVendorOracle,
            LicenseUnit = productLicenseLicenseUnit,
            DefinedTags = 
            {
                { "foo-namespace.bar-key", "value" },
            },
            FreeformTags = 
            {
                { "bar-key", "value" },
            },
            Images = new[]
            {
                new Oci.LicenseManager.Inputs.ProductLicenseImageArgs
                {
                    ListingId = testListing.Id,
                    PackageVersion = productLicenseImagesPackageVersion,
                },
            },
            VendorName = productLicenseVendorName,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.LicenseManager.ProductLicense;
    import com.pulumi.oci.LicenseManager.ProductLicenseArgs;
    import com.pulumi.oci.LicenseManager.inputs.ProductLicenseImageArgs;
    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) {
            var testProductLicense = new ProductLicense("testProductLicense", ProductLicenseArgs.builder()
                .compartmentId(compartmentId)
                .displayName(productLicenseDisplayName)
                .isVendorOracle(productLicenseIsVendorOracle)
                .licenseUnit(productLicenseLicenseUnit)
                .definedTags(Map.of("foo-namespace.bar-key", "value"))
                .freeformTags(Map.of("bar-key", "value"))
                .images(ProductLicenseImageArgs.builder()
                    .listingId(testListing.id())
                    .packageVersion(productLicenseImagesPackageVersion)
                    .build())
                .vendorName(productLicenseVendorName)
                .build());
    
        }
    }
    
    resources:
      testProductLicense:
        type: oci:LicenseManager:ProductLicense
        name: test_product_license
        properties:
          compartmentId: ${compartmentId}
          displayName: ${productLicenseDisplayName}
          isVendorOracle: ${productLicenseIsVendorOracle}
          licenseUnit: ${productLicenseLicenseUnit}
          definedTags:
            foo-namespace.bar-key: value
          freeformTags:
            bar-key: value
          images:
            - listingId: ${testListing.id}
              packageVersion: ${productLicenseImagesPackageVersion}
          vendorName: ${productLicenseVendorName}
    

    Create ProductLicense Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ProductLicense(name: string, args: ProductLicenseArgs, opts?: CustomResourceOptions);
    @overload
    def ProductLicense(resource_name: str,
                       args: ProductLicenseArgs,
                       opts: Optional[ResourceOptions] = None)
    
    @overload
    def ProductLicense(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       compartment_id: Optional[str] = None,
                       display_name: Optional[str] = None,
                       is_vendor_oracle: Optional[bool] = None,
                       license_unit: Optional[str] = None,
                       defined_tags: Optional[Mapping[str, str]] = None,
                       freeform_tags: Optional[Mapping[str, str]] = None,
                       images: Optional[Sequence[_licensemanager.ProductLicenseImageArgs]] = None,
                       vendor_name: Optional[str] = None)
    func NewProductLicense(ctx *Context, name string, args ProductLicenseArgs, opts ...ResourceOption) (*ProductLicense, error)
    public ProductLicense(string name, ProductLicenseArgs args, CustomResourceOptions? opts = null)
    public ProductLicense(String name, ProductLicenseArgs args)
    public ProductLicense(String name, ProductLicenseArgs args, CustomResourceOptions options)
    
    type: oci:LicenseManager:ProductLicense
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ProductLicenseArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ProductLicenseArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ProductLicenseArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ProductLicenseArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ProductLicenseArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var productLicenseResource = new Oci.LicenseManager.ProductLicense("productLicenseResource", new()
    {
        CompartmentId = "string",
        DisplayName = "string",
        IsVendorOracle = false,
        LicenseUnit = "string",
        DefinedTags = 
        {
            { "string", "string" },
        },
        FreeformTags = 
        {
            { "string", "string" },
        },
        Images = new[]
        {
            new Oci.LicenseManager.Inputs.ProductLicenseImageArgs
            {
                ListingId = "string",
                PackageVersion = "string",
                Id = "string",
                ListingName = "string",
                Publisher = "string",
            },
        },
        VendorName = "string",
    });
    
    example, err := LicenseManager.NewProductLicense(ctx, "productLicenseResource", &LicenseManager.ProductLicenseArgs{
    	CompartmentId:  pulumi.String("string"),
    	DisplayName:    pulumi.String("string"),
    	IsVendorOracle: pulumi.Bool(false),
    	LicenseUnit:    pulumi.String("string"),
    	DefinedTags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	FreeformTags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Images: licensemanager.ProductLicenseImageArray{
    		&licensemanager.ProductLicenseImageArgs{
    			ListingId:      pulumi.String("string"),
    			PackageVersion: pulumi.String("string"),
    			Id:             pulumi.String("string"),
    			ListingName:    pulumi.String("string"),
    			Publisher:      pulumi.String("string"),
    		},
    	},
    	VendorName: pulumi.String("string"),
    })
    
    var productLicenseResource = new ProductLicense("productLicenseResource", ProductLicenseArgs.builder()
        .compartmentId("string")
        .displayName("string")
        .isVendorOracle(false)
        .licenseUnit("string")
        .definedTags(Map.of("string", "string"))
        .freeformTags(Map.of("string", "string"))
        .images(ProductLicenseImageArgs.builder()
            .listingId("string")
            .packageVersion("string")
            .id("string")
            .listingName("string")
            .publisher("string")
            .build())
        .vendorName("string")
        .build());
    
    product_license_resource = oci.license_manager.ProductLicense("productLicenseResource",
        compartment_id="string",
        display_name="string",
        is_vendor_oracle=False,
        license_unit="string",
        defined_tags={
            "string": "string",
        },
        freeform_tags={
            "string": "string",
        },
        images=[{
            "listing_id": "string",
            "package_version": "string",
            "id": "string",
            "listing_name": "string",
            "publisher": "string",
        }],
        vendor_name="string")
    
    const productLicenseResource = new oci.licensemanager.ProductLicense("productLicenseResource", {
        compartmentId: "string",
        displayName: "string",
        isVendorOracle: false,
        licenseUnit: "string",
        definedTags: {
            string: "string",
        },
        freeformTags: {
            string: "string",
        },
        images: [{
            listingId: "string",
            packageVersion: "string",
            id: "string",
            listingName: "string",
            publisher: "string",
        }],
        vendorName: "string",
    });
    
    type: oci:LicenseManager:ProductLicense
    properties:
        compartmentId: string
        definedTags:
            string: string
        displayName: string
        freeformTags:
            string: string
        images:
            - id: string
              listingId: string
              listingName: string
              packageVersion: string
              publisher: string
        isVendorOracle: false
        licenseUnit: string
        vendorName: string
    

    ProductLicense Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The ProductLicense resource accepts the following input properties:

    CompartmentId string
    The compartment OCID where product licenses are created.
    DisplayName string
    Name of the product license.
    IsVendorOracle bool
    Specifies if the product license vendor is Oracle or a third party.
    LicenseUnit string
    The product license unit.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Images List<ProductLicenseImage>
    (Updatable) The image details associated with the product license.
    VendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    CompartmentId string
    The compartment OCID where product licenses are created.
    DisplayName string
    Name of the product license.
    IsVendorOracle bool
    Specifies if the product license vendor is Oracle or a third party.
    LicenseUnit string
    The product license unit.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Images []ProductLicenseImageArgs
    (Updatable) The image details associated with the product license.
    VendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    compartmentId String
    The compartment OCID where product licenses are created.
    displayName String
    Name of the product license.
    isVendorOracle Boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit String
    The product license unit.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images List<ProductLicenseImage>
    (Updatable) The image details associated with the product license.
    vendorName String

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    compartmentId string
    The compartment OCID where product licenses are created.
    displayName string
    Name of the product license.
    isVendorOracle boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit string
    The product license unit.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images ProductLicenseImage[]
    (Updatable) The image details associated with the product license.
    vendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    compartment_id str
    The compartment OCID where product licenses are created.
    display_name str
    Name of the product license.
    is_vendor_oracle bool
    Specifies if the product license vendor is Oracle or a third party.
    license_unit str
    The product license unit.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images Sequence[licensemanager.ProductLicenseImageArgs]
    (Updatable) The image details associated with the product license.
    vendor_name str

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    compartmentId String
    The compartment OCID where product licenses are created.
    displayName String
    Name of the product license.
    isVendorOracle Boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit String
    The product license unit.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images List<Property Map>
    (Updatable) The image details associated with the product license.
    vendorName String

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ProductLicense resource produces the following output properties:

    ActiveLicenseRecordCount int
    The number of active license records associated with the product license.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsOverSubscribed bool
    Specifies whether or not the product license is oversubscribed.
    IsUnlimited bool
    Specifies if the license unit count is unlimited.
    State string
    The current product license state.
    Status string
    The current product license status.
    StatusDescription string
    Status description for the current product license status.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    TimeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    TotalActiveLicenseUnitCount int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    TotalLicenseRecordCount int
    The number of license records associated with the product license.
    TotalLicenseUnitsConsumed double
    The number of license units consumed. Updated after each allocation run.
    ActiveLicenseRecordCount int
    The number of active license records associated with the product license.
    Id string
    The provider-assigned unique ID for this managed resource.
    IsOverSubscribed bool
    Specifies whether or not the product license is oversubscribed.
    IsUnlimited bool
    Specifies if the license unit count is unlimited.
    State string
    The current product license state.
    Status string
    The current product license status.
    StatusDescription string
    Status description for the current product license status.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    TimeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    TotalActiveLicenseUnitCount int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    TotalLicenseRecordCount int
    The number of license records associated with the product license.
    TotalLicenseUnitsConsumed float64
    The number of license units consumed. Updated after each allocation run.
    activeLicenseRecordCount Integer
    The number of active license records associated with the product license.
    id String
    The provider-assigned unique ID for this managed resource.
    isOverSubscribed Boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited Boolean
    Specifies if the license unit count is unlimited.
    state String
    The current product license state.
    status String
    The current product license status.
    statusDescription String
    Status description for the current product license status.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated String
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount Integer
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount Integer
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed Double
    The number of license units consumed. Updated after each allocation run.
    activeLicenseRecordCount number
    The number of active license records associated with the product license.
    id string
    The provider-assigned unique ID for this managed resource.
    isOverSubscribed boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited boolean
    Specifies if the license unit count is unlimited.
    state string
    The current product license state.
    status string
    The current product license status.
    statusDescription string
    Status description for the current product license status.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount number
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount number
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed number
    The number of license units consumed. Updated after each allocation run.
    active_license_record_count int
    The number of active license records associated with the product license.
    id str
    The provider-assigned unique ID for this managed resource.
    is_over_subscribed bool
    Specifies whether or not the product license is oversubscribed.
    is_unlimited bool
    Specifies if the license unit count is unlimited.
    state str
    The current product license state.
    status str
    The current product license status.
    status_description str
    Status description for the current product license status.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The time the product license was created. An RFC 3339-formatted datetime string.
    time_updated str
    The time the product license was updated. An RFC 3339-formatted datetime string.
    total_active_license_unit_count int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    total_license_record_count int
    The number of license records associated with the product license.
    total_license_units_consumed float
    The number of license units consumed. Updated after each allocation run.
    activeLicenseRecordCount Number
    The number of active license records associated with the product license.
    id String
    The provider-assigned unique ID for this managed resource.
    isOverSubscribed Boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited Boolean
    Specifies if the license unit count is unlimited.
    state String
    The current product license state.
    status String
    The current product license status.
    statusDescription String
    Status description for the current product license status.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated String
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount Number
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount Number
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed Number
    The number of license units consumed. Updated after each allocation run.

    Look up Existing ProductLicense Resource

    Get an existing ProductLicense resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ProductLicenseState, opts?: CustomResourceOptions): ProductLicense
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            active_license_record_count: Optional[int] = None,
            compartment_id: Optional[str] = None,
            defined_tags: Optional[Mapping[str, str]] = None,
            display_name: Optional[str] = None,
            freeform_tags: Optional[Mapping[str, str]] = None,
            images: Optional[Sequence[_licensemanager.ProductLicenseImageArgs]] = None,
            is_over_subscribed: Optional[bool] = None,
            is_unlimited: Optional[bool] = None,
            is_vendor_oracle: Optional[bool] = None,
            license_unit: Optional[str] = None,
            state: Optional[str] = None,
            status: Optional[str] = None,
            status_description: Optional[str] = None,
            system_tags: Optional[Mapping[str, str]] = None,
            time_created: Optional[str] = None,
            time_updated: Optional[str] = None,
            total_active_license_unit_count: Optional[int] = None,
            total_license_record_count: Optional[int] = None,
            total_license_units_consumed: Optional[float] = None,
            vendor_name: Optional[str] = None) -> ProductLicense
    func GetProductLicense(ctx *Context, name string, id IDInput, state *ProductLicenseState, opts ...ResourceOption) (*ProductLicense, error)
    public static ProductLicense Get(string name, Input<string> id, ProductLicenseState? state, CustomResourceOptions? opts = null)
    public static ProductLicense get(String name, Output<String> id, ProductLicenseState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ActiveLicenseRecordCount int
    The number of active license records associated with the product license.
    CompartmentId string
    The compartment OCID where product licenses are created.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    DisplayName string
    Name of the product license.
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Images List<ProductLicenseImage>
    (Updatable) The image details associated with the product license.
    IsOverSubscribed bool
    Specifies whether or not the product license is oversubscribed.
    IsUnlimited bool
    Specifies if the license unit count is unlimited.
    IsVendorOracle bool
    Specifies if the product license vendor is Oracle or a third party.
    LicenseUnit string
    The product license unit.
    State string
    The current product license state.
    Status string
    The current product license status.
    StatusDescription string
    Status description for the current product license status.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    TimeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    TotalActiveLicenseUnitCount int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    TotalLicenseRecordCount int
    The number of license records associated with the product license.
    TotalLicenseUnitsConsumed double
    The number of license units consumed. Updated after each allocation run.
    VendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    ActiveLicenseRecordCount int
    The number of active license records associated with the product license.
    CompartmentId string
    The compartment OCID where product licenses are created.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    DisplayName string
    Name of the product license.
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    Images []ProductLicenseImageArgs
    (Updatable) The image details associated with the product license.
    IsOverSubscribed bool
    Specifies whether or not the product license is oversubscribed.
    IsUnlimited bool
    Specifies if the license unit count is unlimited.
    IsVendorOracle bool
    Specifies if the product license vendor is Oracle or a third party.
    LicenseUnit string
    The product license unit.
    State string
    The current product license state.
    Status string
    The current product license status.
    StatusDescription string
    Status description for the current product license status.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    TimeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    TotalActiveLicenseUnitCount int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    TotalLicenseRecordCount int
    The number of license records associated with the product license.
    TotalLicenseUnitsConsumed float64
    The number of license units consumed. Updated after each allocation run.
    VendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    activeLicenseRecordCount Integer
    The number of active license records associated with the product license.
    compartmentId String
    The compartment OCID where product licenses are created.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    displayName String
    Name of the product license.
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images List<ProductLicenseImage>
    (Updatable) The image details associated with the product license.
    isOverSubscribed Boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited Boolean
    Specifies if the license unit count is unlimited.
    isVendorOracle Boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit String
    The product license unit.
    state String
    The current product license state.
    status String
    The current product license status.
    statusDescription String
    Status description for the current product license status.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated String
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount Integer
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount Integer
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed Double
    The number of license units consumed. Updated after each allocation run.
    vendorName String

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    activeLicenseRecordCount number
    The number of active license records associated with the product license.
    compartmentId string
    The compartment OCID where product licenses are created.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    displayName string
    Name of the product license.
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images ProductLicenseImage[]
    (Updatable) The image details associated with the product license.
    isOverSubscribed boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited boolean
    Specifies if the license unit count is unlimited.
    isVendorOracle boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit string
    The product license unit.
    state string
    The current product license state.
    status string
    The current product license status.
    statusDescription string
    Status description for the current product license status.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated string
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount number
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount number
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed number
    The number of license units consumed. Updated after each allocation run.
    vendorName string

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    active_license_record_count int
    The number of active license records associated with the product license.
    compartment_id str
    The compartment OCID where product licenses are created.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    display_name str
    Name of the product license.
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images Sequence[licensemanager.ProductLicenseImageArgs]
    (Updatable) The image details associated with the product license.
    is_over_subscribed bool
    Specifies whether or not the product license is oversubscribed.
    is_unlimited bool
    Specifies if the license unit count is unlimited.
    is_vendor_oracle bool
    Specifies if the product license vendor is Oracle or a third party.
    license_unit str
    The product license unit.
    state str
    The current product license state.
    status str
    The current product license status.
    status_description str
    Status description for the current product license status.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The time the product license was created. An RFC 3339-formatted datetime string.
    time_updated str
    The time the product license was updated. An RFC 3339-formatted datetime string.
    total_active_license_unit_count int
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    total_license_record_count int
    The number of license records associated with the product license.
    total_license_units_consumed float
    The number of license units consumed. Updated after each allocation run.
    vendor_name str

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    activeLicenseRecordCount Number
    The number of active license records associated with the product license.
    compartmentId String
    The compartment OCID where product licenses are created.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}
    displayName String
    Name of the product license.
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type, or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    images List<Property Map>
    (Updatable) The image details associated with the product license.
    isOverSubscribed Boolean
    Specifies whether or not the product license is oversubscribed.
    isUnlimited Boolean
    Specifies if the license unit count is unlimited.
    isVendorOracle Boolean
    Specifies if the product license vendor is Oracle or a third party.
    licenseUnit String
    The product license unit.
    state String
    The current product license state.
    status String
    The current product license status.
    statusDescription String
    Status description for the current product license status.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the product license was created. An RFC 3339-formatted datetime string.
    timeUpdated String
    The time the product license was updated. An RFC 3339-formatted datetime string.
    totalActiveLicenseUnitCount Number
    The total number of licenses available for the product license, calculated by adding up all the license counts for active license records associated with the product license.
    totalLicenseRecordCount Number
    The number of license records associated with the product license.
    totalLicenseUnitsConsumed Number
    The number of license units consumed. Updated after each allocation run.
    vendorName String

    The product license vendor name, for example: Microsoft, RHEL, and so on.

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Supporting Types

    ProductLicenseImage, ProductLicenseImageArgs

    ListingId string
    (Updatable) Marketplace image listing ID.
    PackageVersion string
    (Updatable) Image package version.
    Id string
    The image ID associated with the product license.
    ListingName string
    The listing name associated with the product license.
    Publisher string
    The image publisher.
    ListingId string
    (Updatable) Marketplace image listing ID.
    PackageVersion string
    (Updatable) Image package version.
    Id string
    The image ID associated with the product license.
    ListingName string
    The listing name associated with the product license.
    Publisher string
    The image publisher.
    listingId String
    (Updatable) Marketplace image listing ID.
    packageVersion String
    (Updatable) Image package version.
    id String
    The image ID associated with the product license.
    listingName String
    The listing name associated with the product license.
    publisher String
    The image publisher.
    listingId string
    (Updatable) Marketplace image listing ID.
    packageVersion string
    (Updatable) Image package version.
    id string
    The image ID associated with the product license.
    listingName string
    The listing name associated with the product license.
    publisher string
    The image publisher.
    listing_id str
    (Updatable) Marketplace image listing ID.
    package_version str
    (Updatable) Image package version.
    id str
    The image ID associated with the product license.
    listing_name str
    The listing name associated with the product license.
    publisher str
    The image publisher.
    listingId String
    (Updatable) Marketplace image listing ID.
    packageVersion String
    (Updatable) Image package version.
    id String
    The image ID associated with the product license.
    listingName String
    The listing name associated with the product license.
    publisher String
    The image publisher.

    Import

    ProductLicenses can be imported using the id, e.g.

    $ pulumi import oci:LicenseManager/productLicense:ProductLicense test_product_license "id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    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 v2.17.0 published on Friday, Nov 15, 2024 by Pulumi