honeycombio.getDatasets

Start a Neo task

Explain and create a honeycombio.getDatasets resource

Honeycomb 0.42.0 published on Friday, Oct 10, 2025 by honeycombio

honeycombio/terraform-provider-honeycombio

# Data Source: honeycombio.getDatasets

The Datasets data source retrieves the Environment’s Datasets.

Example Usage

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

const all = honeycombio.getDatasets({});
const foo = honeycombio.getDatasets({
    detailFilters: [{
        name: "name",
        valueRegex: "foo_*",
    }],
});

import pulumi
import pulumi_honeycombio as honeycombio

all = honeycombio.get_datasets()
foo = honeycombio.get_datasets(detail_filters=[{
    "name": "name",
    "value_regex": "foo_*",
}])

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/honeycombio/honeycombio"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := honeycombio.GetDatasets(ctx, &honeycombio.GetDatasetsArgs{}, nil)
		if err != nil {
			return err
		}
		_, err = honeycombio.GetDatasets(ctx, &honeycombio.GetDatasetsArgs{
			DetailFilters: []honeycombio.GetDatasetsDetailFilter{
				{
					Name:       "name",
					ValueRegex: pulumi.StringRef("foo_*"),
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Honeycombio = Pulumi.Honeycombio;

return await Deployment.RunAsync(() => 
{
    var all = Honeycombio.GetDatasets.Invoke();

    var foo = Honeycombio.GetDatasets.Invoke(new()
    {
        DetailFilters = new[]
        {
            new Honeycombio.Inputs.GetDatasetsDetailFilterInputArgs
            {
                Name = "name",
                ValueRegex = "foo_*",
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.honeycombio.HoneycombioFunctions;
import com.pulumi.honeycombio.inputs.GetDatasetsArgs;
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 all = HoneycombioFunctions.getDatasets();

        final var foo = HoneycombioFunctions.getDatasets(GetDatasetsArgs.builder()
            .detailFilters(GetDatasetsDetailFilterArgs.builder()
                .name("name")
                .valueRegex("foo_*")
                .build())
            .build());

    }
}

variables:
  all:
    fn::invoke:
      function: honeycombio:getDatasets
      arguments: {}
  foo:
    fn::invoke:
      function: honeycombio:getDatasets
      arguments:
        detailFilters:
          - name: name
            valueRegex: foo_*

Using getDatasets

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 getDatasets(args: GetDatasetsArgs, opts?: InvokeOptions): Promise<GetDatasetsResult>
function getDatasetsOutput(args: GetDatasetsOutputArgs, opts?: InvokeOptions): Output<GetDatasetsResult>

def get_datasets(detail_filters: Optional[Sequence[GetDatasetsDetailFilter]] = None,
                 starts_with: Optional[str] = None,
                 opts: Optional[InvokeOptions] = None) -> GetDatasetsResult
def get_datasets_output(detail_filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetDatasetsDetailFilterArgs]]]] = None,
                 starts_with: Optional[pulumi.Input[str]] = None,
                 opts: Optional[InvokeOptions] = None) -> Output[GetDatasetsResult]

func GetDatasets(ctx *Context, args *GetDatasetsArgs, opts ...InvokeOption) (*GetDatasetsResult, error)
func GetDatasetsOutput(ctx *Context, args *GetDatasetsOutputArgs, opts ...InvokeOption) GetDatasetsResultOutput

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

public static class GetDatasets 
{
    public static Task<GetDatasetsResult> InvokeAsync(GetDatasetsArgs args, InvokeOptions? opts = null)
    public static Output<GetDatasetsResult> Invoke(GetDatasetsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetDatasetsResult> getDatasets(GetDatasetsArgs args, InvokeOptions options)
public static Output<GetDatasetsResult> getDatasets(GetDatasetsArgs args, InvokeOptions options)

fn::invoke:
  function: honeycombio:index/getDatasets:getDatasets
  arguments:
    # arguments dictionary

The following arguments are supported:

DetailFilters List<GetDatasetsDetailFilter>: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
StartsWith string: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

DetailFilters []GetDatasetsDetailFilter: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
StartsWith string: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

detailFilters List<GetDatasetsDetailFilter>: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
startsWith String: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

detailFilters GetDatasetsDetailFilter[]: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
startsWith string: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

detail_filters Sequence[GetDatasetsDetailFilter]: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
starts_with str: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

detailFilters List<Property Map>: a block to further filter results as described below. Multiple detail_filter blocks can be provided to filter by multiple fields. Multiple filters are combined with a logical AND operation, meaning all conditions must be satisfied for a dataset to be included in the results. Conflicts with starts_with.
startsWith String: Deprecated: use detail_filter instead. Only return datasets whose name starts with the given value.
Deprecated: Deprecated

getDatasets Result

The following output properties are available:

Id string
Names List<string>: a list of all the dataset names.
Slugs List<string>: a list of all the dataset slugs.
DetailFilters List<GetDatasetsDetailFilter>
StartsWith string: Deprecated: Deprecated

Id string
Names []string: a list of all the dataset names.
Slugs []string: a list of all the dataset slugs.
DetailFilters []GetDatasetsDetailFilter
StartsWith string: Deprecated: Deprecated

id String
names List<String>: a list of all the dataset names.
slugs List<String>: a list of all the dataset slugs.
detailFilters List<GetDatasetsDetailFilter>
startsWith String: Deprecated: Deprecated

id string
names string[]: a list of all the dataset names.
slugs string[]: a list of all the dataset slugs.
detailFilters GetDatasetsDetailFilter[]
startsWith string: Deprecated: Deprecated

id str
names Sequence[str]: a list of all the dataset names.
slugs Sequence[str]: a list of all the dataset slugs.
detail_filters Sequence[GetDatasetsDetailFilter]
starts_with str: Deprecated: Deprecated

id String
names List<String>: a list of all the dataset names.
slugs List<String>: a list of all the dataset slugs.
detailFilters List<Property Map>
startsWith String: Deprecated: Deprecated

Supporting Types

GetDatasetsDetailFilter

Name string: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
Operator string: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
Value string: The value of the detail field to match on.
ValueRegex string: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.

Name string: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
Operator string: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
Value string: The value of the detail field to match on.
ValueRegex string: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.

name String: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
operator String: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
value String: The value of the detail field to match on.
valueRegex String: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.

name string: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
operator string: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
value string: The value of the detail field to match on.
valueRegex string: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.

name str: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
operator str: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
value str: The value of the detail field to match on.
value_regex str: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.

name String: The name of the detail field to filter by. This field must match a schema attribute of the honeycombio.Dataset resource (e.g., name, tags, description).
operator String: The comparison operator to use for filtering. Defaults to equals. Valid operators include:
value String: The value of the detail field to match on.
valueRegex String: A regular expression string to apply to the value of the detail field to match on.
Note one of value or value_regex is required.