1. Packages
  2. AWS
  3. API Docs
  4. mq
  5. getInstanceTypeOfferings
AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi

aws.mq.getInstanceTypeOfferings

Explore with Pulumi AI

aws logo
AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi

    Provides details about available MQ broker instance type offerings. Use this data source to discover supported instance types, storage types, and deployment modes for Amazon MQ brokers.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    // Get all instance type offerings
    const all = aws.mq.getInstanceTypeOfferings({});
    // Filter by engine type
    const activemq = aws.mq.getInstanceTypeOfferings({
        engineType: "ACTIVEMQ",
    });
    // Filter by storage type
    const ebs = aws.mq.getInstanceTypeOfferings({
        storageType: "EBS",
    });
    // Filter by instance type
    const m5 = aws.mq.getInstanceTypeOfferings({
        hostInstanceType: "mq.m5.large",
    });
    // Filter by multiple criteria
    const filtered = aws.mq.getInstanceTypeOfferings({
        engineType: "ACTIVEMQ",
        storageType: "EBS",
        hostInstanceType: "mq.m5.large",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    # Get all instance type offerings
    all = aws.mq.get_instance_type_offerings()
    # Filter by engine type
    activemq = aws.mq.get_instance_type_offerings(engine_type="ACTIVEMQ")
    # Filter by storage type
    ebs = aws.mq.get_instance_type_offerings(storage_type="EBS")
    # Filter by instance type
    m5 = aws.mq.get_instance_type_offerings(host_instance_type="mq.m5.large")
    # Filter by multiple criteria
    filtered = aws.mq.get_instance_type_offerings(engine_type="ACTIVEMQ",
        storage_type="EBS",
        host_instance_type="mq.m5.large")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/mq"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Get all instance type offerings
    		_, err := mq.GetInstanceTypeOfferings(ctx, &mq.GetInstanceTypeOfferingsArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		// Filter by engine type
    		_, err = mq.GetInstanceTypeOfferings(ctx, &mq.GetInstanceTypeOfferingsArgs{
    			EngineType: pulumi.StringRef("ACTIVEMQ"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		// Filter by storage type
    		_, err = mq.GetInstanceTypeOfferings(ctx, &mq.GetInstanceTypeOfferingsArgs{
    			StorageType: pulumi.StringRef("EBS"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		// Filter by instance type
    		_, err = mq.GetInstanceTypeOfferings(ctx, &mq.GetInstanceTypeOfferingsArgs{
    			HostInstanceType: pulumi.StringRef("mq.m5.large"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		// Filter by multiple criteria
    		_, err = mq.GetInstanceTypeOfferings(ctx, &mq.GetInstanceTypeOfferingsArgs{
    			EngineType:       pulumi.StringRef("ACTIVEMQ"),
    			StorageType:      pulumi.StringRef("EBS"),
    			HostInstanceType: pulumi.StringRef("mq.m5.large"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        // Get all instance type offerings
        var all = Aws.Mq.GetInstanceTypeOfferings.Invoke();
    
        // Filter by engine type
        var activemq = Aws.Mq.GetInstanceTypeOfferings.Invoke(new()
        {
            EngineType = "ACTIVEMQ",
        });
    
        // Filter by storage type
        var ebs = Aws.Mq.GetInstanceTypeOfferings.Invoke(new()
        {
            StorageType = "EBS",
        });
    
        // Filter by instance type
        var m5 = Aws.Mq.GetInstanceTypeOfferings.Invoke(new()
        {
            HostInstanceType = "mq.m5.large",
        });
    
        // Filter by multiple criteria
        var filtered = Aws.Mq.GetInstanceTypeOfferings.Invoke(new()
        {
            EngineType = "ACTIVEMQ",
            StorageType = "EBS",
            HostInstanceType = "mq.m5.large",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.mq.MqFunctions;
    import com.pulumi.aws.mq.inputs.GetInstanceTypeOfferingsArgs;
    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) {
            // Get all instance type offerings
            final var all = MqFunctions.getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs.builder()
                .build());
    
            // Filter by engine type
            final var activemq = MqFunctions.getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs.builder()
                .engineType("ACTIVEMQ")
                .build());
    
            // Filter by storage type
            final var ebs = MqFunctions.getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs.builder()
                .storageType("EBS")
                .build());
    
            // Filter by instance type
            final var m5 = MqFunctions.getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs.builder()
                .hostInstanceType("mq.m5.large")
                .build());
    
            // Filter by multiple criteria
            final var filtered = MqFunctions.getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs.builder()
                .engineType("ACTIVEMQ")
                .storageType("EBS")
                .hostInstanceType("mq.m5.large")
                .build());
    
        }
    }
    
    variables:
      # Get all instance type offerings
      all:
        fn::invoke:
          function: aws:mq:getInstanceTypeOfferings
          arguments: {}
      # Filter by engine type
      activemq:
        fn::invoke:
          function: aws:mq:getInstanceTypeOfferings
          arguments:
            engineType: ACTIVEMQ
      # Filter by storage type
      ebs:
        fn::invoke:
          function: aws:mq:getInstanceTypeOfferings
          arguments:
            storageType: EBS
      # Filter by instance type
      m5:
        fn::invoke:
          function: aws:mq:getInstanceTypeOfferings
          arguments:
            hostInstanceType: mq.m5.large
      # Filter by multiple criteria
      filtered:
        fn::invoke:
          function: aws:mq:getInstanceTypeOfferings
          arguments:
            engineType: ACTIVEMQ
            storageType: EBS
            hostInstanceType: mq.m5.large
    

    Using getInstanceTypeOfferings

    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 getInstanceTypeOfferings(args: GetInstanceTypeOfferingsArgs, opts?: InvokeOptions): Promise<GetInstanceTypeOfferingsResult>
    function getInstanceTypeOfferingsOutput(args: GetInstanceTypeOfferingsOutputArgs, opts?: InvokeOptions): Output<GetInstanceTypeOfferingsResult>
    def get_instance_type_offerings(engine_type: Optional[str] = None,
                                    host_instance_type: Optional[str] = None,
                                    region: Optional[str] = None,
                                    storage_type: Optional[str] = None,
                                    opts: Optional[InvokeOptions] = None) -> GetInstanceTypeOfferingsResult
    def get_instance_type_offerings_output(engine_type: Optional[pulumi.Input[str]] = None,
                                    host_instance_type: Optional[pulumi.Input[str]] = None,
                                    region: Optional[pulumi.Input[str]] = None,
                                    storage_type: Optional[pulumi.Input[str]] = None,
                                    opts: Optional[InvokeOptions] = None) -> Output[GetInstanceTypeOfferingsResult]
    func GetInstanceTypeOfferings(ctx *Context, args *GetInstanceTypeOfferingsArgs, opts ...InvokeOption) (*GetInstanceTypeOfferingsResult, error)
    func GetInstanceTypeOfferingsOutput(ctx *Context, args *GetInstanceTypeOfferingsOutputArgs, opts ...InvokeOption) GetInstanceTypeOfferingsResultOutput

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

    public static class GetInstanceTypeOfferings 
    {
        public static Task<GetInstanceTypeOfferingsResult> InvokeAsync(GetInstanceTypeOfferingsArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceTypeOfferingsResult> Invoke(GetInstanceTypeOfferingsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetInstanceTypeOfferingsResult> getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs args, InvokeOptions options)
    public static Output<GetInstanceTypeOfferingsResult> getInstanceTypeOfferings(GetInstanceTypeOfferingsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: aws:mq/getInstanceTypeOfferings:getInstanceTypeOfferings
      arguments:
        # arguments dictionary

    The following arguments are supported:

    EngineType string
    Filter response by engine type.
    HostInstanceType string
    Filter response by host instance type.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    StorageType string
    Filter response by storage type.
    EngineType string
    Filter response by engine type.
    HostInstanceType string
    Filter response by host instance type.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    StorageType string
    Filter response by storage type.
    engineType String
    Filter response by engine type.
    hostInstanceType String
    Filter response by host instance type.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    storageType String
    Filter response by storage type.
    engineType string
    Filter response by engine type.
    hostInstanceType string
    Filter response by host instance type.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    storageType string
    Filter response by storage type.
    engine_type str
    Filter response by engine type.
    host_instance_type str
    Filter response by host instance type.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    storage_type str
    Filter response by storage type.
    engineType String
    Filter response by engine type.
    hostInstanceType String
    Filter response by host instance type.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    storageType String
    Filter response by storage type.

    getInstanceTypeOfferings Result

    The following output properties are available:

    BrokerInstanceOptions List<GetInstanceTypeOfferingsBrokerInstanceOption>
    List of broker instance options. See Broker Instance Options below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    EngineType string
    Broker's engine type.
    HostInstanceType string
    Broker's instance type.
    StorageType string
    Broker's storage type.
    BrokerInstanceOptions []GetInstanceTypeOfferingsBrokerInstanceOption
    List of broker instance options. See Broker Instance Options below.
    Id string
    The provider-assigned unique ID for this managed resource.
    Region string
    EngineType string
    Broker's engine type.
    HostInstanceType string
    Broker's instance type.
    StorageType string
    Broker's storage type.
    brokerInstanceOptions List<GetInstanceTypeOfferingsBrokerInstanceOption>
    List of broker instance options. See Broker Instance Options below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    engineType String
    Broker's engine type.
    hostInstanceType String
    Broker's instance type.
    storageType String
    Broker's storage type.
    brokerInstanceOptions GetInstanceTypeOfferingsBrokerInstanceOption[]
    List of broker instance options. See Broker Instance Options below.
    id string
    The provider-assigned unique ID for this managed resource.
    region string
    engineType string
    Broker's engine type.
    hostInstanceType string
    Broker's instance type.
    storageType string
    Broker's storage type.
    broker_instance_options Sequence[GetInstanceTypeOfferingsBrokerInstanceOption]
    List of broker instance options. See Broker Instance Options below.
    id str
    The provider-assigned unique ID for this managed resource.
    region str
    engine_type str
    Broker's engine type.
    host_instance_type str
    Broker's instance type.
    storage_type str
    Broker's storage type.
    brokerInstanceOptions List<Property Map>
    List of broker instance options. See Broker Instance Options below.
    id String
    The provider-assigned unique ID for this managed resource.
    region String
    engineType String
    Broker's engine type.
    hostInstanceType String
    Broker's instance type.
    storageType String
    Broker's storage type.

    Supporting Types

    GetInstanceTypeOfferingsBrokerInstanceOption

    AvailabilityZones List<GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone>
    List of available Availability Zones. See Availability Zones below.
    EngineType string
    Filter response by engine type.
    HostInstanceType string
    Filter response by host instance type.
    StorageType string
    Filter response by storage type.
    SupportedDeploymentModes List<string>
    List of supported deployment modes.
    SupportedEngineVersions List<string>
    List of supported engine versions.
    AvailabilityZones []GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone
    List of available Availability Zones. See Availability Zones below.
    EngineType string
    Filter response by engine type.
    HostInstanceType string
    Filter response by host instance type.
    StorageType string
    Filter response by storage type.
    SupportedDeploymentModes []string
    List of supported deployment modes.
    SupportedEngineVersions []string
    List of supported engine versions.
    availabilityZones List<GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone>
    List of available Availability Zones. See Availability Zones below.
    engineType String
    Filter response by engine type.
    hostInstanceType String
    Filter response by host instance type.
    storageType String
    Filter response by storage type.
    supportedDeploymentModes List<String>
    List of supported deployment modes.
    supportedEngineVersions List<String>
    List of supported engine versions.
    availabilityZones GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone[]
    List of available Availability Zones. See Availability Zones below.
    engineType string
    Filter response by engine type.
    hostInstanceType string
    Filter response by host instance type.
    storageType string
    Filter response by storage type.
    supportedDeploymentModes string[]
    List of supported deployment modes.
    supportedEngineVersions string[]
    List of supported engine versions.
    availability_zones Sequence[GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone]
    List of available Availability Zones. See Availability Zones below.
    engine_type str
    Filter response by engine type.
    host_instance_type str
    Filter response by host instance type.
    storage_type str
    Filter response by storage type.
    supported_deployment_modes Sequence[str]
    List of supported deployment modes.
    supported_engine_versions Sequence[str]
    List of supported engine versions.
    availabilityZones List<Property Map>
    List of available Availability Zones. See Availability Zones below.
    engineType String
    Filter response by engine type.
    hostInstanceType String
    Filter response by host instance type.
    storageType String
    Filter response by storage type.
    supportedDeploymentModes List<String>
    List of supported deployment modes.
    supportedEngineVersions List<String>
    List of supported engine versions.

    GetInstanceTypeOfferingsBrokerInstanceOptionAvailabilityZone

    Name string
    Name of the Availability Zone.
    Name string
    Name of the Availability Zone.
    name String
    Name of the Availability Zone.
    name string
    Name of the Availability Zone.
    name str
    Name of the Availability Zone.
    name String
    Name of the Availability Zone.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v7.4.0 published on Wednesday, Aug 13, 2025 by Pulumi