Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. Honeycombio Provider
  4. API Docs
  5. Marker
Viewing docs for Honeycomb 0.53.0
published on Thursday, Jul 30, 2026 by honeycombio
Schema (JSON)
honeycombio/terraform-provider-honeycombio

honeycombio.Marker

Viewing docs for Honeycomb 0.53.0
published on Thursday, Jul 30, 2026 by honeycombio
Schema (JSON)
honeycombio/terraform-provider-honeycombio

    # Resource: honeycombio.Marker

    Creates a marker. For more information about markers, check out Annotate the timeline with Markers.

    Destroying or replacing this resource will not delete the previously created marker. This is intentional to preserve the markers.

    Example Usage

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

const config = new pulumi.Config();
const dataset = config.require("dataset");
const appVersion = config.require("appVersion");
const appDeploy = new honeycombio.Marker("app_deploy", {
    message: `deploy ${appVersion}`,
    type: "deploy",
    url: "http://www.example.com/",
    dataset: dataset,
});
// A time-range marker spanning a maintenance window.
const maintenance = new honeycombio.Marker("maintenance", {
    message: "scheduled maintenance",
    type: "maintenance",
    startTime: 1700000000,
    endTime: 1700003600,
    dataset: dataset,
});

    import pulumi
import pulumi_honeycombio as honeycombio

config = pulumi.Config()
dataset = config.require("dataset")
app_version = config.require("appVersion")
app_deploy = honeycombio.Marker("app_deploy",
    message=f"deploy {app_version}",
    type="deploy",
    url="http://www.example.com/",
    dataset=dataset)
# A time-range marker spanning a maintenance window.
maintenance = honeycombio.Marker("maintenance",
    message="scheduled maintenance",
    type="maintenance",
    start_time=1700000000,
    end_time=1700003600,
    dataset=dataset)

    package main

import (
	"fmt"

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		dataset := cfg.Require("dataset")
		appVersion := cfg.Require("appVersion")
		_, err := honeycombio.NewMarker(ctx, "app_deploy", &honeycombio.MarkerArgs{
			Message: pulumi.Sprintf("deploy %v", appVersion),
			Type:    pulumi.String("deploy"),
			Url:     pulumi.String("http://www.example.com/"),
			Dataset: pulumi.String(dataset),
		})
		if err != nil {
			return err
		}
		// A time-range marker spanning a maintenance window.
		_, err = honeycombio.NewMarker(ctx, "maintenance", &honeycombio.MarkerArgs{
			Message:   pulumi.String("scheduled maintenance"),
			Type:      pulumi.String("maintenance"),
			StartTime: pulumi.Float64(1700000000),
			EndTime:   pulumi.Float64(1700003600),
			Dataset:   pulumi.String(dataset),
		})
		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 config = new Config();
    var dataset = config.Require("dataset");
    var appVersion = config.Require("appVersion");
    var appDeploy = new Honeycombio.Marker("app_deploy", new()
    {
        Message = $"deploy {appVersion}",
        Type = "deploy",
        Url = "http://www.example.com/",
        Dataset = dataset,
    });

    // A time-range marker spanning a maintenance window.
    var maintenance = new Honeycombio.Marker("maintenance", new()
    {
        Message = "scheduled maintenance",
        Type = "maintenance",
        StartTime = 1700000000,
        EndTime = 1700003600,
        Dataset = dataset,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.honeycombio.Marker;
import com.pulumi.honeycombio.MarkerArgs;
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 config = ctx.config();
        final var dataset = config.get("dataset");
        final var appVersion = config.get("appVersion");
        var appDeploy = new Marker("appDeploy", MarkerArgs.builder()
            .message(String.format("deploy %s", appVersion))
            .type("deploy")
            .url("http://www.example.com/")
            .dataset(dataset)
            .build());

        // A time-range marker spanning a maintenance window.
        var maintenance = new Marker("maintenance", MarkerArgs.builder()
            .message("scheduled maintenance")
            .type("maintenance")
            .startTime(1700000000.0)
            .endTime(1700003600.0)
            .dataset(dataset)
            .build());

    }
}

    configuration:
  dataset:
    type: string
  appVersion:
    type: string
resources:
  appDeploy:
    type: honeycombio:Marker
    name: app_deploy
    properties:
      message: deploy ${appVersion}
      type: deploy
      url: http://www.example.com/
      dataset: ${dataset}
  # A time-range marker spanning a maintenance window.
  maintenance:
    type: honeycombio:Marker
    properties:
      message: scheduled maintenance
      type: maintenance
      startTime: 1.7e+09
      endTime: 1.7000036e+09
      dataset: ${dataset}

    Example coming soon!

    Create Marker Resource

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

    Constructor syntax

    new Marker(name: string, args?: MarkerArgs, opts?: CustomResourceOptions);
    @overload
def Marker(resource_name: str,
           args: Optional[MarkerArgs] = None,
           opts: Optional[ResourceOptions] = None)

@overload
def Marker(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           dataset: Optional[str] = None,
           end_time: Optional[float] = None,
           marker_id: Optional[str] = None,
           message: Optional[str] = None,
           start_time: Optional[float] = None,
           type: Optional[str] = None,
           url: Optional[str] = None)
    func NewMarker(ctx *Context, name string, args *MarkerArgs, opts ...ResourceOption) (*Marker, error)
    public Marker(string name, MarkerArgs? args = null, CustomResourceOptions? opts = null)
    public Marker(String name, MarkerArgs args)
public Marker(String name, MarkerArgs args, CustomResourceOptions options)

    type: honeycombio:Marker
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "honeycombio_marker" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args MarkerArgs
    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 MarkerArgs
    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 MarkerArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args MarkerArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args MarkerArgs
    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 markerResource = new Honeycombio.Marker("markerResource", new()
{
    Dataset = "string",
    EndTime = 0,
    MarkerId = "string",
    Message = "string",
    StartTime = 0,
    Type = "string",
    Url = "string",
});

    example, err := honeycombio.NewMarker(ctx, "markerResource", &honeycombio.MarkerArgs{
	Dataset:   pulumi.String("string"),
	EndTime:   pulumi.Float64(0),
	MarkerId:  pulumi.String("string"),
	Message:   pulumi.String("string"),
	StartTime: pulumi.Float64(0),
	Type:      pulumi.String("string"),
	Url:       pulumi.String("string"),
})

    resource "honeycombio_marker" "markerResource" {
  lifecycle {
    create_before_destroy = true
  }
  dataset    = "string"
  end_time   = 0
  marker_id  = "string"
  message    = "string"
  start_time = 0
  type       = "string"
  url        = "string"
}

    var markerResource = new Marker("markerResource", MarkerArgs.builder()
    .dataset("string")
    .endTime(0.0)
    .markerId("string")
    .message("string")
    .startTime(0.0)
    .type("string")
    .url("string")
    .build());

    marker_resource = honeycombio.Marker("markerResource",
    dataset="string",
    end_time=float(0),
    marker_id="string",
    message="string",
    start_time=float(0),
    type="string",
    url="string")

    const markerResource = new honeycombio.Marker("markerResource", {
    dataset: "string",
    endTime: 0,
    markerId: "string",
    message: "string",
    startTime: 0,
    type: "string",
    url: "string",
});

    type: honeycombio:Marker
properties:
    dataset: string
    endTime: 0
    markerId: string
    message: string
    startTime: 0
    type: string
    url: string

    Marker 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 Marker resource accepts the following input properties:

    Dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    EndTime double
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    MarkerId string
    The ID of this resource.
    Message string
    A message that appears above the marker and can be used to describe the marker.
    StartTime double
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    Type string
    The type of the marker (e.g. "deploy", "job-run")
    Url string
    A target URL for the Marker. Rendered as a link in the UI.
    Dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    EndTime float64
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    MarkerId string
    The ID of this resource.
    Message string
    A message that appears above the marker and can be used to describe the marker.
    StartTime float64
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    Type string
    The type of the marker (e.g. "deploy", "job-run")
    Url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    end_time number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    marker_id string
    The ID of this resource.
    message string
    A message that appears above the marker and can be used to describe the marker.
    start_time number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type string
    The type of the marker (e.g. "deploy", "job-run")
    url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset String
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime Double
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId String
    The ID of this resource.
    message String
    A message that appears above the marker and can be used to describe the marker.
    startTime Double
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type String
    The type of the marker (e.g. "deploy", "job-run")
    url String
    A target URL for the Marker. Rendered as a link in the UI.
    dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId string
    The ID of this resource.
    message string
    A message that appears above the marker and can be used to describe the marker.
    startTime number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type string
    The type of the marker (e.g. "deploy", "job-run")
    url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset str
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    end_time float
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    marker_id str
    The ID of this resource.
    message str
    A message that appears above the marker and can be used to describe the marker.
    start_time float
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type str
    The type of the marker (e.g. "deploy", "job-run")
    url str
    A target URL for the Marker. Rendered as a link in the UI.
    dataset String
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime Number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId String
    The ID of this resource.
    message String
    A message that appears above the marker and can be used to describe the marker.
    startTime Number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type String
    The type of the marker (e.g. "deploy", "job-run")
    url String
    A target URL for the Marker. Rendered as a link in the UI.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Marker Resource

    Get an existing Marker 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?: MarkerState, opts?: CustomResourceOptions): Marker
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        dataset: Optional[str] = None,
        end_time: Optional[float] = None,
        marker_id: Optional[str] = None,
        message: Optional[str] = None,
        start_time: Optional[float] = None,
        type: Optional[str] = None,
        url: Optional[str] = None) -> Marker
    func GetMarker(ctx *Context, name string, id IDInput, state *MarkerState, opts ...ResourceOption) (*Marker, error)
    public static Marker Get(string name, Input<string> id, MarkerState? state, CustomResourceOptions? opts = null)
    public static Marker get(String name, Output<String> id, MarkerState state, CustomResourceOptions options)
    resources:  _:    type: honeycombio:Marker    get:      id: ${id}
    import {
  to = honeycombio_marker.example
  id = "${id}"
}
    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:
    Dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    EndTime double
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    MarkerId string
    The ID of this resource.
    Message string
    A message that appears above the marker and can be used to describe the marker.
    StartTime double
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    Type string
    The type of the marker (e.g. "deploy", "job-run")
    Url string
    A target URL for the Marker. Rendered as a link in the UI.
    Dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    EndTime float64
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    MarkerId string
    The ID of this resource.
    Message string
    A message that appears above the marker and can be used to describe the marker.
    StartTime float64
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    Type string
    The type of the marker (e.g. "deploy", "job-run")
    Url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    end_time number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    marker_id string
    The ID of this resource.
    message string
    A message that appears above the marker and can be used to describe the marker.
    start_time number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type string
    The type of the marker (e.g. "deploy", "job-run")
    url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset String
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime Double
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId String
    The ID of this resource.
    message String
    A message that appears above the marker and can be used to describe the marker.
    startTime Double
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type String
    The type of the marker (e.g. "deploy", "job-run")
    url String
    A target URL for the Marker. Rendered as a link in the UI.
    dataset string
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId string
    The ID of this resource.
    message string
    A message that appears above the marker and can be used to describe the marker.
    startTime number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type string
    The type of the marker (e.g. "deploy", "job-run")
    url string
    A target URL for the Marker. Rendered as a link in the UI.
    dataset str
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    end_time float
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    marker_id str
    The ID of this resource.
    message str
    A message that appears above the marker and can be used to describe the marker.
    start_time float
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type str
    The type of the marker (e.g. "deploy", "job-run")
    url str
    A target URL for the Marker. Rendered as a link in the UI.
    dataset String
    The dataset where this marker is placed. If not set, it will be Environment-wide.
    endTime Number
    The end time of the marker, in Unix Time (seconds since epoch). Used to create a time-range marker: requires start_time to be set and must be greater than or equal to it. Changing this creates a new marker; the previous one is retained.
    markerId String
    The ID of this resource.
    message String
    A message that appears above the marker and can be used to describe the marker.
    startTime Number
    The time the marker is placed at, in Unix Time (seconds since epoch). Defaults to the marker's creation time if not set. Changing this creates a new marker; the previous one is retained.
    type String
    The type of the marker (e.g. "deploy", "job-run")
    url String
    A target URL for the Marker. Rendered as a link in the UI.

    Package Details

    Repository
    honeycombio honeycombio/terraform-provider-honeycombio
    License
    Notes
    This Pulumi package is based on the honeycombio Terraform Provider.
    Viewing docs for Honeycomb 0.53.0
    published on Thursday, Jul 30, 2026 by honeycombio
    Schema (JSON)
    honeycombio/terraform-provider-honeycombio

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial