Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Grafana Cloud
  3. API Docs
  4. machineLearning
  5. Holiday
Grafana v0.16.1 published on Saturday, Mar 15, 2025 by pulumiverse
pulumiverse/pulumi-grafana

grafana.machineLearning.Holiday

Explore with Pulumi AI

grafana logo
Grafana v0.16.1 published on Saturday, Mar 15, 2025 by pulumiverse
pulumiverse/pulumi-grafana

    A holiday describes time periods where a time series is expected to behave differently to normal.

    To use a holiday in a job, use its id in the holidays attribute of a grafana.machineLearning.Job:

    iCal Holiday

    This holiday uses an iCal file to define the holidays.

    import * as pulumi from "@pulumi/pulumi";
import * as grafana from "@pulumiverse/grafana";

const ical = new grafana.machinelearning.Holiday("ical", {
    name: "My iCal holiday",
    description: "My Holiday",
    icalUrl: "https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics",
    icalTimezone: "Europe/London",
});

    import pulumi
import pulumiverse_grafana as grafana

ical = grafana.machine_learning.Holiday("ical",
    name="My iCal holiday",
    description="My Holiday",
    ical_url="https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics",
    ical_timezone="Europe/London")

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-grafana/sdk/go/grafana/machinelearning"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := machinelearning.NewHoliday(ctx, "ical", &machinelearning.HolidayArgs{
			Name:         pulumi.String("My iCal holiday"),
			Description:  pulumi.String("My Holiday"),
			IcalUrl:      pulumi.String("https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics"),
			IcalTimezone: pulumi.String("Europe/London"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Grafana = Pulumiverse.Grafana;

return await Deployment.RunAsync(() => 
{
    var ical = new Grafana.MachineLearning.Holiday("ical", new()
    {
        Name = "My iCal holiday",
        Description = "My Holiday",
        IcalUrl = "https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics",
        IcalTimezone = "Europe/London",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.grafana.machineLearning.Holiday;
import com.pulumi.grafana.machineLearning.HolidayArgs;
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) {
        var ical = new Holiday("ical", HolidayArgs.builder()
            .name("My iCal holiday")
            .description("My Holiday")
            .icalUrl("https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics")
            .icalTimezone("Europe/London")
            .build());

    }
}

    resources:
  ical:
    type: grafana:machineLearning:Holiday
    properties:
      name: My iCal holiday
      description: My Holiday
      icalUrl: https://calendar.google.com/calendar/ical/en.uk%23holiday%40group.v.calendar.google.com/public/basic.ics
      icalTimezone: Europe/London

    Custom Periods Holiday

    This holiday uses custom periods to define the holidays.

    import * as pulumi from "@pulumi/pulumi";
import * as grafana from "@pulumiverse/grafana";

const customPeriods = new grafana.machinelearning.Holiday("custom_periods", {
    name: "My custom periods holiday",
    description: "My Holiday",
    customPeriods: [
        {
            name: "First of January",
            startTime: "2023-01-01T00:00:00Z",
            endTime: "2023-01-02T00:00:00Z",
        },
        {
            name: "First of Feburary",
            startTime: "2023-02-01T00:00:00Z",
            endTime: "2023-02-02T00:00:00Z",
        },
    ],
});

    import pulumi
import pulumiverse_grafana as grafana

custom_periods = grafana.machine_learning.Holiday("custom_periods",
    name="My custom periods holiday",
    description="My Holiday",
    custom_periods=[
        {
            "name": "First of January",
            "start_time": "2023-01-01T00:00:00Z",
            "end_time": "2023-01-02T00:00:00Z",
        },
        {
            "name": "First of Feburary",
            "start_time": "2023-02-01T00:00:00Z",
            "end_time": "2023-02-02T00:00:00Z",
        },
    ])

    package main

import (
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumiverse/pulumi-grafana/sdk/go/grafana/machinelearning"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := machinelearning.NewHoliday(ctx, "custom_periods", &machinelearning.HolidayArgs{
			Name:        pulumi.String("My custom periods holiday"),
			Description: pulumi.String("My Holiday"),
			CustomPeriods: machinelearning.HolidayCustomPeriodArray{
				&machinelearning.HolidayCustomPeriodArgs{
					Name:      pulumi.String("First of January"),
					StartTime: pulumi.String("2023-01-01T00:00:00Z"),
					EndTime:   pulumi.String("2023-01-02T00:00:00Z"),
				},
				&machinelearning.HolidayCustomPeriodArgs{
					Name:      pulumi.String("First of Feburary"),
					StartTime: pulumi.String("2023-02-01T00:00:00Z"),
					EndTime:   pulumi.String("2023-02-02T00:00:00Z"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Grafana = Pulumiverse.Grafana;

return await Deployment.RunAsync(() => 
{
    var customPeriods = new Grafana.MachineLearning.Holiday("custom_periods", new()
    {
        Name = "My custom periods holiday",
        Description = "My Holiday",
        CustomPeriods = new[]
        {
            new Grafana.MachineLearning.Inputs.HolidayCustomPeriodArgs
            {
                Name = "First of January",
                StartTime = "2023-01-01T00:00:00Z",
                EndTime = "2023-01-02T00:00:00Z",
            },
            new Grafana.MachineLearning.Inputs.HolidayCustomPeriodArgs
            {
                Name = "First of Feburary",
                StartTime = "2023-02-01T00:00:00Z",
                EndTime = "2023-02-02T00:00:00Z",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.grafana.machineLearning.Holiday;
import com.pulumi.grafana.machineLearning.HolidayArgs;
import com.pulumi.grafana.machineLearning.inputs.HolidayCustomPeriodArgs;
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) {
        var customPeriods = new Holiday("customPeriods", HolidayArgs.builder()
            .name("My custom periods holiday")
            .description("My Holiday")
            .customPeriods(            
                HolidayCustomPeriodArgs.builder()
                    .name("First of January")
                    .startTime("2023-01-01T00:00:00Z")
                    .endTime("2023-01-02T00:00:00Z")
                    .build(),
                HolidayCustomPeriodArgs.builder()
                    .name("First of Feburary")
                    .startTime("2023-02-01T00:00:00Z")
                    .endTime("2023-02-02T00:00:00Z")
                    .build())
            .build());

    }
}

    resources:
  customPeriods:
    type: grafana:machineLearning:Holiday
    name: custom_periods
    properties:
      name: My custom periods holiday
      description: My Holiday
      customPeriods:
        - name: First of January
          startTime: 2023-01-01T00:00:00Z
          endTime: 2023-01-02T00:00:00Z
        - name: First of Feburary
          startTime: 2023-02-01T00:00:00Z
          endTime: 2023-02-02T00:00:00Z

    Create Holiday Resource

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

    Constructor syntax

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

@overload
def Holiday(resource_name: str,
            opts: Optional[ResourceOptions] = None,
            custom_periods: Optional[Sequence[_machinelearning.HolidayCustomPeriodArgs]] = None,
            description: Optional[str] = None,
            ical_timezone: Optional[str] = None,
            ical_url: Optional[str] = None,
            name: Optional[str] = None)
    func NewHoliday(ctx *Context, name string, args *HolidayArgs, opts ...ResourceOption) (*Holiday, error)
    public Holiday(string name, HolidayArgs? args = null, CustomResourceOptions? opts = null)
    public Holiday(String name, HolidayArgs args)
public Holiday(String name, HolidayArgs args, CustomResourceOptions options)

    type: grafana:machineLearning:Holiday
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args HolidayArgs
    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 HolidayArgs
    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 HolidayArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args HolidayArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args HolidayArgs
    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 holidayResource = new Grafana.MachineLearning.Holiday("holidayResource", new()
{
    CustomPeriods = new[]
    {
        new Grafana.MachineLearning.Inputs.HolidayCustomPeriodArgs
        {
            EndTime = "string",
            StartTime = "string",
            Name = "string",
        },
    },
    Description = "string",
    IcalTimezone = "string",
    IcalUrl = "string",
    Name = "string",
});

    example, err := machineLearning.NewHoliday(ctx, "holidayResource", &machineLearning.HolidayArgs{
	CustomPeriods: machinelearning.HolidayCustomPeriodArray{
		&machinelearning.HolidayCustomPeriodArgs{
			EndTime:   pulumi.String("string"),
			StartTime: pulumi.String("string"),
			Name:      pulumi.String("string"),
		},
	},
	Description:  pulumi.String("string"),
	IcalTimezone: pulumi.String("string"),
	IcalUrl:      pulumi.String("string"),
	Name:         pulumi.String("string"),
})

    var holidayResource = new Holiday("holidayResource", HolidayArgs.builder()
    .customPeriods(HolidayCustomPeriodArgs.builder()
        .endTime("string")
        .startTime("string")
        .name("string")
        .build())
    .description("string")
    .icalTimezone("string")
    .icalUrl("string")
    .name("string")
    .build());

    holiday_resource = grafana.machine_learning.Holiday("holidayResource",
    custom_periods=[{
        "end_time": "string",
        "start_time": "string",
        "name": "string",
    }],
    description="string",
    ical_timezone="string",
    ical_url="string",
    name="string")

    const holidayResource = new grafana.machinelearning.Holiday("holidayResource", {
    customPeriods: [{
        endTime: "string",
        startTime: "string",
        name: "string",
    }],
    description: "string",
    icalTimezone: "string",
    icalUrl: "string",
    name: "string",
});

    type: grafana:machineLearning:Holiday
properties:
    customPeriods:
        - endTime: string
          name: string
          startTime: string
    description: string
    icalTimezone: string
    icalUrl: string
    name: string

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

    CustomPeriods List<Pulumiverse.Grafana.MachineLearning.Inputs.HolidayCustomPeriod>
    A list of custom periods for the holiday.
    Description string
    A description of the holiday.
    IcalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    IcalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    Name string
    The name of the holiday.
    CustomPeriods []HolidayCustomPeriodArgs
    A list of custom periods for the holiday.
    Description string
    A description of the holiday.
    IcalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    IcalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    Name string
    The name of the holiday.
    customPeriods List<HolidayCustomPeriod>
    A list of custom periods for the holiday.
    description String
    A description of the holiday.
    icalTimezone String
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl String
    A URL to an iCal file containing all occurrences of the holiday.
    name String
    The name of the holiday.
    customPeriods HolidayCustomPeriod[]
    A list of custom periods for the holiday.
    description string
    A description of the holiday.
    icalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    name string
    The name of the holiday.
    custom_periods Sequence[machinelearning.HolidayCustomPeriodArgs]
    A list of custom periods for the holiday.
    description str
    A description of the holiday.
    ical_timezone str
    The timezone to use for events in the iCal file pointed to by ical_url.
    ical_url str
    A URL to an iCal file containing all occurrences of the holiday.
    name str
    The name of the holiday.
    customPeriods List<Property Map>
    A list of custom periods for the holiday.
    description String
    A description of the holiday.
    icalTimezone String
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl String
    A URL to an iCal file containing all occurrences of the holiday.
    name String
    The name of the holiday.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Holiday 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 str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing Holiday Resource

    Get an existing Holiday 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?: HolidayState, opts?: CustomResourceOptions): Holiday
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        custom_periods: Optional[Sequence[_machinelearning.HolidayCustomPeriodArgs]] = None,
        description: Optional[str] = None,
        ical_timezone: Optional[str] = None,
        ical_url: Optional[str] = None,
        name: Optional[str] = None) -> Holiday
    func GetHoliday(ctx *Context, name string, id IDInput, state *HolidayState, opts ...ResourceOption) (*Holiday, error)
    public static Holiday Get(string name, Input<string> id, HolidayState? state, CustomResourceOptions? opts = null)
    public static Holiday get(String name, Output<String> id, HolidayState state, CustomResourceOptions options)
    resources:  _:    type: grafana:machineLearning:Holiday    get:      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:
    CustomPeriods List<Pulumiverse.Grafana.MachineLearning.Inputs.HolidayCustomPeriod>
    A list of custom periods for the holiday.
    Description string
    A description of the holiday.
    IcalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    IcalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    Name string
    The name of the holiday.
    CustomPeriods []HolidayCustomPeriodArgs
    A list of custom periods for the holiday.
    Description string
    A description of the holiday.
    IcalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    IcalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    Name string
    The name of the holiday.
    customPeriods List<HolidayCustomPeriod>
    A list of custom periods for the holiday.
    description String
    A description of the holiday.
    icalTimezone String
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl String
    A URL to an iCal file containing all occurrences of the holiday.
    name String
    The name of the holiday.
    customPeriods HolidayCustomPeriod[]
    A list of custom periods for the holiday.
    description string
    A description of the holiday.
    icalTimezone string
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl string
    A URL to an iCal file containing all occurrences of the holiday.
    name string
    The name of the holiday.
    custom_periods Sequence[machinelearning.HolidayCustomPeriodArgs]
    A list of custom periods for the holiday.
    description str
    A description of the holiday.
    ical_timezone str
    The timezone to use for events in the iCal file pointed to by ical_url.
    ical_url str
    A URL to an iCal file containing all occurrences of the holiday.
    name str
    The name of the holiday.
    customPeriods List<Property Map>
    A list of custom periods for the holiday.
    description String
    A description of the holiday.
    icalTimezone String
    The timezone to use for events in the iCal file pointed to by ical_url.
    icalUrl String
    A URL to an iCal file containing all occurrences of the holiday.
    name String
    The name of the holiday.

    Supporting Types

    HolidayCustomPeriod, HolidayCustomPeriodArgs

    EndTime string
    StartTime string
    Name string
    The name of the custom period.
    EndTime string
    StartTime string
    Name string
    The name of the custom period.
    endTime String
    startTime String
    name String
    The name of the custom period.
    endTime string
    startTime string
    name string
    The name of the custom period.
    end_time str
    start_time str
    name str
    The name of the custom period.
    endTime String
    startTime String
    name String
    The name of the custom period.

    Import

    $ pulumi import grafana:machineLearning/holiday:Holiday name "{{ id }}"

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    grafana pulumiverse/pulumi-grafana
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the grafana Terraform Provider.
    grafana logo
    Grafana v0.16.1 published on Saturday, Mar 15, 2025 by pulumiverse
    pulumiverse/pulumi-grafana