1. Packages
  2. AWS
  3. API Docs
  4. licensemanager
  5. getReceivedLicenses
AWS v6.76.0 published on Tuesday, Apr 8, 2025 by Pulumi

aws.licensemanager.getReceivedLicenses

Explore with Pulumi AI

This resource can be used to get a set of license ARNs matching a filter.

Example Usage

The following shows getting all license ARNs issued from the AWS marketplace. Providing no filter, would provide all license ARNs for the entire account.

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const test = aws.licensemanager.getReceivedLicenses({
    filters: [{
        name: "IssuerName",
        values: ["AWS/Marketplace"],
    }],
});
Copy
import pulumi
import pulumi_aws as aws

test = aws.licensemanager.get_received_licenses(filters=[{
    "name": "IssuerName",
    "values": ["AWS/Marketplace"],
}])
Copy
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "IssuerName",
					Values: []string{
						"AWS/Marketplace",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var test = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "IssuerName",
                Values = new[]
                {
                    "AWS/Marketplace",
                },
            },
        },
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 test = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("IssuerName")
                .values("AWS/Marketplace")
                .build())
            .build());

    }
}
Copy
variables:
  test:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: IssuerName
            values:
              - AWS/Marketplace
Copy

Using getReceivedLicenses

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 getReceivedLicenses(args: GetReceivedLicensesArgs, opts?: InvokeOptions): Promise<GetReceivedLicensesResult>
function getReceivedLicensesOutput(args: GetReceivedLicensesOutputArgs, opts?: InvokeOptions): Output<GetReceivedLicensesResult>
Copy
def get_received_licenses(filters: Optional[Sequence[GetReceivedLicensesFilter]] = None,
                          opts: Optional[InvokeOptions] = None) -> GetReceivedLicensesResult
def get_received_licenses_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetReceivedLicensesFilterArgs]]]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetReceivedLicensesResult]
Copy
func GetReceivedLicenses(ctx *Context, args *GetReceivedLicensesArgs, opts ...InvokeOption) (*GetReceivedLicensesResult, error)
func GetReceivedLicensesOutput(ctx *Context, args *GetReceivedLicensesOutputArgs, opts ...InvokeOption) GetReceivedLicensesResultOutput
Copy

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

public static class GetReceivedLicenses 
{
    public static Task<GetReceivedLicensesResult> InvokeAsync(GetReceivedLicensesArgs args, InvokeOptions? opts = null)
    public static Output<GetReceivedLicensesResult> Invoke(GetReceivedLicensesInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetReceivedLicensesResult> getReceivedLicenses(GetReceivedLicensesArgs args, InvokeOptions options)
public static Output<GetReceivedLicensesResult> getReceivedLicenses(GetReceivedLicensesArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: aws:licensemanager/getReceivedLicenses:getReceivedLicenses
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Filters List<GetReceivedLicensesFilter>

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

Filters []GetReceivedLicensesFilter

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

filters List<GetReceivedLicensesFilter>

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

filters GetReceivedLicensesFilter[]

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

filters Sequence[GetReceivedLicensesFilter]

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

filters List<Property Map>

Custom filter block as described below.

More complex filters can be expressed using one or more filter sub-blocks, which take the following arguments:

getReceivedLicenses Result

The following output properties are available:

Arns List<string>
List of all the license ARNs found.
Id string
The provider-assigned unique ID for this managed resource.
Filters List<GetReceivedLicensesFilter>
Arns []string
List of all the license ARNs found.
Id string
The provider-assigned unique ID for this managed resource.
Filters []GetReceivedLicensesFilter
arns List<String>
List of all the license ARNs found.
id String
The provider-assigned unique ID for this managed resource.
filters List<GetReceivedLicensesFilter>
arns string[]
List of all the license ARNs found.
id string
The provider-assigned unique ID for this managed resource.
filters GetReceivedLicensesFilter[]
arns Sequence[str]
List of all the license ARNs found.
id str
The provider-assigned unique ID for this managed resource.
filters Sequence[GetReceivedLicensesFilter]
arns List<String>
List of all the license ARNs found.
id String
The provider-assigned unique ID for this managed resource.
filters List<Property Map>

Supporting Types

GetReceivedLicensesFilter

Name This property is required. string
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_csharp">

Values This property is required. List<string>

Set of values that are accepted for the given field.

Name This property is required. string
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_go">

Values This property is required. []string

Set of values that are accepted for the given field.

name This property is required. String
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_java">

values This property is required. List<String>

Set of values that are accepted for the given field.

name This property is required. string
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_nodejs">

values This property is required. string[]

Set of values that are accepted for the given field.

name This property is required. str
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_python">

values This property is required. Sequence[str]

Set of values that are accepted for the given field.

name This property is required. String
Name of the field to filter by, as defined by the underlying AWS API. For example, if filtering using ProductSKU, use:

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const selected = aws.licensemanager.getReceivedLicenses({ filters: [{ name: "ProductSKU", values: [""], }], });

import pulumi
import pulumi_aws as aws

selected = aws.licensemanager.get_received_licenses(filters=[{
    "name": "ProductSKU",
    "values": [""],
}])
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var selected = Aws.LicenseManager.GetReceivedLicenses.Invoke(new()
    {
        Filters = new[]
        {
            new Aws.LicenseManager.Inputs.GetReceivedLicensesFilterInputArgs
            {
                Name = "ProductSKU",
                Values = new[]
                {
                    "",
                },
            },
        },
    });

});
package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/licensemanager"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := licensemanager.GetReceivedLicenses(ctx, &licensemanager.GetReceivedLicensesArgs{
			Filters: []licensemanager.GetReceivedLicensesFilter{
				{
					Name: "ProductSKU",
					Values: []string{
						"",
					},
				},
			},
		}, 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.aws.licensemanager.LicensemanagerFunctions;
import com.pulumi.aws.licensemanager.inputs.GetReceivedLicensesArgs;
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 selected = LicensemanagerFunctions.getReceivedLicenses(GetReceivedLicensesArgs.builder()
            .filters(GetReceivedLicensesFilterArgs.builder()
                .name("ProductSKU")
                .values("")
                .build())
            .build());

    }
}
variables:
  selected:
    fn::invoke:
      function: aws:licensemanager:getReceivedLicenses
      arguments:
        filters:
          - name: ProductSKU
            values:
              - ""
title="Required"> <span id="values_yaml">

values This property is required. List<String>

Set of values that are accepted for the given field.

Package Details

Repository
AWS Classic pulumi/pulumi-aws
License
Apache-2.0
Notes
This Pulumi package is based on the aws Terraform Provider.