Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. CrowdStrike
  3. API Docs
  4. SensorUpdatePolicy
CrowdStrike v0.0.10 published on Monday, Mar 3, 2025 by CrowdStrike
crowdstrike/pulumi-crowdstrike

crowdstrike.SensorUpdatePolicy

Explore with Pulumi AI

crowdstrike logo
CrowdStrike v0.0.10 published on Monday, Mar 3, 2025 by CrowdStrike
crowdstrike/pulumi-crowdstrike

    This resource allows management of sensor update policies in the CrowdStrike Falcon platform. Sensor update policies allow you to control the update process across a set of hosts.

    API Scopes

    The following API scopes are required:

    • Sensor update policies | Read & Write

    Example Usage

    Coming soon!

    Coming soon!

    Coming soon!

    Coming soon!

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.crowdstrike.SensorUpdatePolicy;
import com.pulumi.crowdstrike.SensorUpdatePolicyArgs;
import com.pulumi.crowdstrike.inputs.SensorUpdatePolicyScheduleArgs;
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 example = new SensorUpdatePolicy("example", SensorUpdatePolicyArgs.builder()
            .enabled(false)
            .description("Made with Pulumi")
            .platformName("Windows")
            .build("18110")
            .uninstallProtection(false)
            .hostGroups("host_group_id")
            .schedule(SensorUpdatePolicyScheduleArgs.builder()
                .enabled(true)
                .timezone("Etc/UTC")
                .time_blocks(%!v(PANIC=Format method: runtime error: invalid memory address or nil pointer dereference))
                .build())
            .build());

        ctx.export("sensorPolicy", example);
    }
}

    resources:
  example:
    type: crowdstrike:SensorUpdatePolicy
    properties:
      enabled: false
      description: Made with Pulumi
      platformName: Windows
      build: '18110'
      uninstallProtection: false
      hostGroups:
        - host_group_id
      schedule:
        enabled: true
        timezone: Etc/UTC
        time_blocks:
          - days:
              - sunday
              - wednesday
            startTime: 12:40
            endTime: 16:40
outputs:
  sensorPolicy: ${example}

    Create SensorUpdatePolicy Resource

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

    Constructor syntax

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

@overload
def SensorUpdatePolicy(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       build: Optional[str] = None,
                       platform_name: Optional[str] = None,
                       schedule: Optional[SensorUpdatePolicyScheduleArgs] = None,
                       build_arm64: Optional[str] = None,
                       description: Optional[str] = None,
                       enabled: Optional[bool] = None,
                       host_groups: Optional[Sequence[str]] = None,
                       name: Optional[str] = None,
                       uninstall_protection: Optional[bool] = None)
    func NewSensorUpdatePolicy(ctx *Context, name string, args SensorUpdatePolicyArgs, opts ...ResourceOption) (*SensorUpdatePolicy, error)
    public SensorUpdatePolicy(string name, SensorUpdatePolicyArgs args, CustomResourceOptions? opts = null)
    public SensorUpdatePolicy(String name, SensorUpdatePolicyArgs args)
public SensorUpdatePolicy(String name, SensorUpdatePolicyArgs args, CustomResourceOptions options)

    type: crowdstrike:SensorUpdatePolicy
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 SensorUpdatePolicyArgs
    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 SensorUpdatePolicyArgs
    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 SensorUpdatePolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SensorUpdatePolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SensorUpdatePolicyArgs
    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 sensorUpdatePolicyResource = new Crowdstrike.SensorUpdatePolicy("sensorUpdatePolicyResource", new()
{
    Build = "string",
    PlatformName = "string",
    Schedule = new Crowdstrike.Inputs.SensorUpdatePolicyScheduleArgs
    {
        Enabled = false,
        TimeBlocks = new[]
        {
            new Crowdstrike.Inputs.SensorUpdatePolicyScheduleTimeBlockArgs
            {
                Days = new[]
                {
                    "string",
                },
                EndTime = "string",
                StartTime = "string",
            },
        },
        Timezone = "string",
    },
    BuildArm64 = "string",
    Description = "string",
    Enabled = false,
    HostGroups = new[]
    {
        "string",
    },
    Name = "string",
    UninstallProtection = false,
});

    example, err := crowdstrike.NewSensorUpdatePolicy(ctx, "sensorUpdatePolicyResource", &crowdstrike.SensorUpdatePolicyArgs{
	Build:        pulumi.String("string"),
	PlatformName: pulumi.String("string"),
	Schedule: &crowdstrike.SensorUpdatePolicyScheduleArgs{
		Enabled: pulumi.Bool(false),
		TimeBlocks: crowdstrike.SensorUpdatePolicyScheduleTimeBlockArray{
			&crowdstrike.SensorUpdatePolicyScheduleTimeBlockArgs{
				Days: pulumi.StringArray{
					pulumi.String("string"),
				},
				EndTime:   pulumi.String("string"),
				StartTime: pulumi.String("string"),
			},
		},
		Timezone: pulumi.String("string"),
	},
	BuildArm64:  pulumi.String("string"),
	Description: pulumi.String("string"),
	Enabled:     pulumi.Bool(false),
	HostGroups: pulumi.StringArray{
		pulumi.String("string"),
	},
	Name:                pulumi.String("string"),
	UninstallProtection: pulumi.Bool(false),
})

    var sensorUpdatePolicyResource = new SensorUpdatePolicy("sensorUpdatePolicyResource", SensorUpdatePolicyArgs.builder()
    .build("string")
    .platformName("string")
    .schedule(SensorUpdatePolicyScheduleArgs.builder()
        .enabled(false)
        .timeBlocks(SensorUpdatePolicyScheduleTimeBlockArgs.builder()
            .days("string")
            .endTime("string")
            .startTime("string")
            .build())
        .timezone("string")
        .build())
    .buildArm64("string")
    .description("string")
    .enabled(false)
    .hostGroups("string")
    .name("string")
    .uninstallProtection(false)
    .build());

    sensor_update_policy_resource = crowdstrike.SensorUpdatePolicy("sensorUpdatePolicyResource",
    build="string",
    platform_name="string",
    schedule={
        "enabled": False,
        "time_blocks": [{
            "days": ["string"],
            "end_time": "string",
            "start_time": "string",
        }],
        "timezone": "string",
    },
    build_arm64="string",
    description="string",
    enabled=False,
    host_groups=["string"],
    name="string",
    uninstall_protection=False)

    const sensorUpdatePolicyResource = new crowdstrike.SensorUpdatePolicy("sensorUpdatePolicyResource", {
    build: "string",
    platformName: "string",
    schedule: {
        enabled: false,
        timeBlocks: [{
            days: ["string"],
            endTime: "string",
            startTime: "string",
        }],
        timezone: "string",
    },
    buildArm64: "string",
    description: "string",
    enabled: false,
    hostGroups: ["string"],
    name: "string",
    uninstallProtection: false,
});

    type: crowdstrike:SensorUpdatePolicy
properties:
    build: string
    buildArm64: string
    description: string
    enabled: false
    hostGroups:
        - string
    name: string
    platformName: string
    schedule:
        enabled: false
        timeBlocks:
            - days:
                - string
              endTime: string
              startTime: string
        timezone: string
    uninstallProtection: false

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

    Build string
    Sensor build to use for the sensor update policy.
    PlatformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    Schedule CrowdStrike.Crowdstrike.Inputs.SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    BuildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    Description string
    Description of the sensor update policy.
    Enabled bool
    Enable the sensor update policy.
    HostGroups List<string>
    Host Group ids to attach to the sensor update policy.
    Name string
    Name of the sensor update policy.
    UninstallProtection bool
    Enable uninstall protection. Windows and Mac only.
    Build string
    Sensor build to use for the sensor update policy.
    PlatformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    Schedule SensorUpdatePolicyScheduleArgs
    Prohibit sensor updates during a set of time blocks.
    BuildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    Description string
    Description of the sensor update policy.
    Enabled bool
    Enable the sensor update policy.
    HostGroups []string
    Host Group ids to attach to the sensor update policy.
    Name string
    Name of the sensor update policy.
    UninstallProtection bool
    Enable uninstall protection. Windows and Mac only.
    build String
    Sensor build to use for the sensor update policy.
    platformName String
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    buildArm64 String
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description String
    Description of the sensor update policy.
    enabled Boolean
    Enable the sensor update policy.
    hostGroups List<String>
    Host Group ids to attach to the sensor update policy.
    name String
    Name of the sensor update policy.
    uninstallProtection Boolean
    Enable uninstall protection. Windows and Mac only.
    build string
    Sensor build to use for the sensor update policy.
    platformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    buildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description string
    Description of the sensor update policy.
    enabled boolean
    Enable the sensor update policy.
    hostGroups string[]
    Host Group ids to attach to the sensor update policy.
    name string
    Name of the sensor update policy.
    uninstallProtection boolean
    Enable uninstall protection. Windows and Mac only.
    build str
    Sensor build to use for the sensor update policy.
    platform_name str
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicyScheduleArgs
    Prohibit sensor updates during a set of time blocks.
    build_arm64 str
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description str
    Description of the sensor update policy.
    enabled bool
    Enable the sensor update policy.
    host_groups Sequence[str]
    Host Group ids to attach to the sensor update policy.
    name str
    Name of the sensor update policy.
    uninstall_protection bool
    Enable uninstall protection. Windows and Mac only.
    build String
    Sensor build to use for the sensor update policy.
    platformName String
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule Property Map
    Prohibit sensor updates during a set of time blocks.
    buildArm64 String
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description String
    Description of the sensor update policy.
    enabled Boolean
    Enable the sensor update policy.
    hostGroups List<String>
    Host Group ids to attach to the sensor update policy.
    name String
    Name of the sensor update policy.
    uninstallProtection Boolean
    Enable uninstall protection. Windows and Mac only.

    Outputs

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

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

    Look up Existing SensorUpdatePolicy Resource

    Get an existing SensorUpdatePolicy 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?: SensorUpdatePolicyState, opts?: CustomResourceOptions): SensorUpdatePolicy
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        build: Optional[str] = None,
        build_arm64: Optional[str] = None,
        description: Optional[str] = None,
        enabled: Optional[bool] = None,
        host_groups: Optional[Sequence[str]] = None,
        last_updated: Optional[str] = None,
        name: Optional[str] = None,
        platform_name: Optional[str] = None,
        schedule: Optional[SensorUpdatePolicyScheduleArgs] = None,
        uninstall_protection: Optional[bool] = None) -> SensorUpdatePolicy
    func GetSensorUpdatePolicy(ctx *Context, name string, id IDInput, state *SensorUpdatePolicyState, opts ...ResourceOption) (*SensorUpdatePolicy, error)
    public static SensorUpdatePolicy Get(string name, Input<string> id, SensorUpdatePolicyState? state, CustomResourceOptions? opts = null)
    public static SensorUpdatePolicy get(String name, Output<String> id, SensorUpdatePolicyState state, CustomResourceOptions options)
    resources:  _:    type: crowdstrike:SensorUpdatePolicy    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:
    Build string
    Sensor build to use for the sensor update policy.
    BuildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    Description string
    Description of the sensor update policy.
    Enabled bool
    Enable the sensor update policy.
    HostGroups List<string>
    Host Group ids to attach to the sensor update policy.
    LastUpdated string
    Name string
    Name of the sensor update policy.
    PlatformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    Schedule CrowdStrike.Crowdstrike.Inputs.SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    UninstallProtection bool
    Enable uninstall protection. Windows and Mac only.
    Build string
    Sensor build to use for the sensor update policy.
    BuildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    Description string
    Description of the sensor update policy.
    Enabled bool
    Enable the sensor update policy.
    HostGroups []string
    Host Group ids to attach to the sensor update policy.
    LastUpdated string
    Name string
    Name of the sensor update policy.
    PlatformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    Schedule SensorUpdatePolicyScheduleArgs
    Prohibit sensor updates during a set of time blocks.
    UninstallProtection bool
    Enable uninstall protection. Windows and Mac only.
    build String
    Sensor build to use for the sensor update policy.
    buildArm64 String
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description String
    Description of the sensor update policy.
    enabled Boolean
    Enable the sensor update policy.
    hostGroups List<String>
    Host Group ids to attach to the sensor update policy.
    lastUpdated String
    name String
    Name of the sensor update policy.
    platformName String
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    uninstallProtection Boolean
    Enable uninstall protection. Windows and Mac only.
    build string
    Sensor build to use for the sensor update policy.
    buildArm64 string
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description string
    Description of the sensor update policy.
    enabled boolean
    Enable the sensor update policy.
    hostGroups string[]
    Host Group ids to attach to the sensor update policy.
    lastUpdated string
    name string
    Name of the sensor update policy.
    platformName string
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicySchedule
    Prohibit sensor updates during a set of time blocks.
    uninstallProtection boolean
    Enable uninstall protection. Windows and Mac only.
    build str
    Sensor build to use for the sensor update policy.
    build_arm64 str
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description str
    Description of the sensor update policy.
    enabled bool
    Enable the sensor update policy.
    host_groups Sequence[str]
    Host Group ids to attach to the sensor update policy.
    last_updated str
    name str
    Name of the sensor update policy.
    platform_name str
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule SensorUpdatePolicyScheduleArgs
    Prohibit sensor updates during a set of time blocks.
    uninstall_protection bool
    Enable uninstall protection. Windows and Mac only.
    build String
    Sensor build to use for the sensor update policy.
    buildArm64 String
    Sensor arm64 build to use for the sensor update policy (Linux only). Required if platform_name is Linux.
    description String
    Description of the sensor update policy.
    enabled Boolean
    Enable the sensor update policy.
    hostGroups List<String>
    Host Group ids to attach to the sensor update policy.
    lastUpdated String
    name String
    Name of the sensor update policy.
    platformName String
    Platform for the sensor update policy to manage. (Windows, Mac, Linux)
    schedule Property Map
    Prohibit sensor updates during a set of time blocks.
    uninstallProtection Boolean
    Enable uninstall protection. Windows and Mac only.

    Supporting Types

    SensorUpdatePolicySchedule, SensorUpdatePolicyScheduleArgs

    Enabled bool
    Enable the scheduler for sensor update policy.
    TimeBlocks List<CrowdStrike.Crowdstrike.Inputs.SensorUpdatePolicyScheduleTimeBlock>
    The time block to prevent sensor updates. Only set when enabled is true.
    Timezone string
    The time zones that will be used for the time blocks. Only set when enabled is true.
    Enabled bool
    Enable the scheduler for sensor update policy.
    TimeBlocks []SensorUpdatePolicyScheduleTimeBlock
    The time block to prevent sensor updates. Only set when enabled is true.
    Timezone string
    The time zones that will be used for the time blocks. Only set when enabled is true.
    enabled Boolean
    Enable the scheduler for sensor update policy.
    timeBlocks List<SensorUpdatePolicyScheduleTimeBlock>
    The time block to prevent sensor updates. Only set when enabled is true.
    timezone String
    The time zones that will be used for the time blocks. Only set when enabled is true.
    enabled boolean
    Enable the scheduler for sensor update policy.
    timeBlocks SensorUpdatePolicyScheduleTimeBlock[]
    The time block to prevent sensor updates. Only set when enabled is true.
    timezone string
    The time zones that will be used for the time blocks. Only set when enabled is true.
    enabled bool
    Enable the scheduler for sensor update policy.
    time_blocks Sequence[SensorUpdatePolicyScheduleTimeBlock]
    The time block to prevent sensor updates. Only set when enabled is true.
    timezone str
    The time zones that will be used for the time blocks. Only set when enabled is true.
    enabled Boolean
    Enable the scheduler for sensor update policy.
    timeBlocks List<Property Map>
    The time block to prevent sensor updates. Only set when enabled is true.
    timezone String
    The time zones that will be used for the time blocks. Only set when enabled is true.

    SensorUpdatePolicyScheduleTimeBlock, SensorUpdatePolicyScheduleTimeBlockArgs

    Days List<string>
    The days of the week the time block should be active.
    EndTime string
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    StartTime string
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.
    Days []string
    The days of the week the time block should be active.
    EndTime string
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    StartTime string
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.
    days List<String>
    The days of the week the time block should be active.
    endTime String
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    startTime String
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.
    days string[]
    The days of the week the time block should be active.
    endTime string
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    startTime string
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.
    days Sequence[str]
    The days of the week the time block should be active.
    end_time str
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    start_time str
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.
    days List<String>
    The days of the week the time block should be active.
    endTime String
    The end time for the time block in 24HR format. Must be atleast 1 hour more than start_time.
    startTime String
    The start time for the time block in 24HR format. Must be atleast 1 hour before end_time.

    Import

    prevention policy can be imported by specifying the policy id.

    $ pulumi import crowdstrike:index/sensorUpdatePolicy:SensorUpdatePolicy example 7fb858a949034a0cbca175f660f1e769

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

    Package Details

    Repository
    crowdstrike crowdstrike/pulumi-crowdstrike
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the crowdstrike Terraform Provider.
    crowdstrike logo
    CrowdStrike v0.0.10 published on Monday, Mar 3, 2025 by CrowdStrike
    crowdstrike/pulumi-crowdstrike