pulumi-aws-kotlin/com.pulumi.aws.pricing.kotlin/PricingFunctions/getProduct

getProduct

suspend fun getProduct(argument: GetProductPlainArgs): GetProductResult

Use this data source to get the pricing information of all products in AWS. This data source is only available in a us-east-1 or ap-south-1 provider.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = aws.pricing.getProduct({
    serviceCode: "AmazonEC2",
    filters: [
        {
            field: "instanceType",
            value: "c5.xlarge",
        },
        {
            field: "operatingSystem",
            value: "Linux",
        },
        {
            field: "location",
            value: "US East (N. Virginia)",
        },
        {
            field: "preInstalledSw",
            value: "NA",
        },
        {
            field: "licenseModel",
            value: "No License required",
        },
        {
            field: "tenancy",
            value: "Shared",
        },
        {
            field: "capacitystatus",
            value: "Used",
        },
    ],
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.pricing.get_product(service_code="AmazonEC2",
    filters=[
        {
            "field": "instanceType",
            "value": "c5.xlarge",
        },
        {
            "field": "operatingSystem",
            "value": "Linux",
        },
        {
            "field": "location",
            "value": "US East (N. Virginia)",
        },
        {
            "field": "preInstalledSw",
            "value": "NA",
        },
        {
            "field": "licenseModel",
            "value": "No License required",
        },
        {
            "field": "tenancy",
            "value": "Shared",
        },
        {
            "field": "capacitystatus",
            "value": "Used",
        },
    ])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = Aws.Pricing.GetProduct.Invoke(new()
    {
        ServiceCode = "AmazonEC2",
        Filters = new[]
        {
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "instanceType",
                Value = "c5.xlarge",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "operatingSystem",
                Value = "Linux",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "location",
                Value = "US East (N. Virginia)",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "preInstalledSw",
                Value = "NA",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "licenseModel",
                Value = "No License required",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "tenancy",
                Value = "Shared",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "capacitystatus",
                Value = "Used",
            },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/pricing"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := pricing.GetProduct(ctx, &pricing.GetProductArgs{
			ServiceCode: "AmazonEC2",
			Filters: []pricing.GetProductFilter{
				{
					Field: "instanceType",
					Value: "c5.xlarge",
				},
				{
					Field: "operatingSystem",
					Value: "Linux",
				},
				{
					Field: "location",
					Value: "US East (N. Virginia)",
				},
				{
					Field: "preInstalledSw",
					Value: "NA",
				},
				{
					Field: "licenseModel",
					Value: "No License required",
				},
				{
					Field: "tenancy",
					Value: "Shared",
				},
				{
					Field: "capacitystatus",
					Value: "Used",
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.pricing.PricingFunctions;
import com.pulumi.aws.pricing.inputs.GetProductArgs;
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 example = PricingFunctions.getProduct(GetProductArgs.builder()
            .serviceCode("AmazonEC2")
            .filters(
                GetProductFilterArgs.builder()
                    .field("instanceType")
                    .value("c5.xlarge")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("operatingSystem")
                    .value("Linux")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("location")
                    .value("US East (N. Virginia)")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("preInstalledSw")
                    .value("NA")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("licenseModel")
                    .value("No License required")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("tenancy")
                    .value("Shared")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("capacitystatus")
                    .value("Used")
                    .build())
            .build());
    }
}
Content copied to clipboard
variables:
  example:
    fn::invoke:
      function: aws:pricing:getProduct
      arguments:
        serviceCode: AmazonEC2
        filters:
          - field: instanceType
            value: c5.xlarge
          - field: operatingSystem
            value: Linux
          - field: location
            value: US East (N. Virginia)
          - field: preInstalledSw
            value: NA
          - field: licenseModel
            value: No License required
          - field: tenancy
            value: Shared
          - field: capacitystatus
            value: Used
Content copied to clipboard
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const example = aws.pricing.getProduct({
    serviceCode: "AmazonRedshift",
    filters: [
        {
            field: "instanceType",
            value: "ds1.xlarge",
        },
        {
            field: "location",
            value: "US East (N. Virginia)",
        },
    ],
});
Content copied to clipboard
import pulumi
import pulumi_aws as aws
example = aws.pricing.get_product(service_code="AmazonRedshift",
    filters=[
        {
            "field": "instanceType",
            "value": "ds1.xlarge",
        },
        {
            "field": "location",
            "value": "US East (N. Virginia)",
        },
    ])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
    var example = Aws.Pricing.GetProduct.Invoke(new()
    {
        ServiceCode = "AmazonRedshift",
        Filters = new[]
        {
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "instanceType",
                Value = "ds1.xlarge",
            },
            new Aws.Pricing.Inputs.GetProductFilterInputArgs
            {
                Field = "location",
                Value = "US East (N. Virginia)",
            },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/pricing"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := pricing.GetProduct(ctx, &pricing.GetProductArgs{
			ServiceCode: "AmazonRedshift",
			Filters: []pricing.GetProductFilter{
				{
					Field: "instanceType",
					Value: "ds1.xlarge",
				},
				{
					Field: "location",
					Value: "US East (N. Virginia)",
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.pricing.PricingFunctions;
import com.pulumi.aws.pricing.inputs.GetProductArgs;
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 example = PricingFunctions.getProduct(GetProductArgs.builder()
            .serviceCode("AmazonRedshift")
            .filters(
                GetProductFilterArgs.builder()
                    .field("instanceType")
                    .value("ds1.xlarge")
                    .build(),
                GetProductFilterArgs.builder()
                    .field("location")
                    .value("US East (N. Virginia)")
                    .build())
            .build());
    }
}
Content copied to clipboard
variables:
  example:
    fn::invoke:
      function: aws:pricing:getProduct
      arguments:
        serviceCode: AmazonRedshift
        filters:
          - field: instanceType
            value: ds1.xlarge
          - field: location
            value: US East (N. Virginia)
Content copied to clipboard

Return

A collection of values returned by getProduct.

Parameters

argument

A collection of arguments for invoking getProduct.

suspend fun getProduct(filters: List<GetProductFilter>, serviceCode: String): GetProductResult

Return

A collection of values returned by getProduct.

Parameters

filters

List of filters. Passed directly to the API (see GetProducts API reference). These filters must describe a single product, this resource will fail if more than one product is returned by the API.

serviceCode

Code of the service. Available service codes can be fetched using the DescribeServices pricing API call.

See also

.

suspend fun getProduct(argument: suspend GetProductPlainArgsBuilder.() -> Unit): GetProductResult

Return

A collection of values returned by getProduct.

Parameters

argument

Builder for com.pulumi.aws.pricing.kotlin.inputs.GetProductPlainArgs.

See also

.