pulumi-aws-kotlin/com.pulumi.aws.ssm.kotlin/MaintenanceWindowTargetArgs

MaintenanceWindowTargetArgs

data class MaintenanceWindowTargetArgs(val description: Output<String>? = null, val name: Output<String>? = null, val ownerInformation: Output<String>? = null, val resourceType: Output<String>? = null, val targets: Output<List<MaintenanceWindowTargetTargetArgs>>? = null, val windowId: Output<String>? = null) : ConvertibleToJava<MaintenanceWindowTargetArgs>

Provides an SSM Maintenance Window Target resource

Example Usage

Instance Target

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ssm.MaintenanceWindow;
import com.pulumi.aws.ssm.MaintenanceWindowArgs;
import com.pulumi.aws.ssm.MaintenanceWindowTarget;
import com.pulumi.aws.ssm.MaintenanceWindowTargetArgs;
import com.pulumi.aws.ssm.inputs.MaintenanceWindowTargetTargetArgs;
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 window = new MaintenanceWindow("window", MaintenanceWindowArgs.builder()
            .schedule("cron(0 16 ? * TUE *)")
            .duration(3)
            .cutoff(1)
            .build());
        var target1 = new MaintenanceWindowTarget("target1", MaintenanceWindowTargetArgs.builder()
            .windowId(window.id())
            .description("This is a maintenance window target")
            .resourceType("INSTANCE")
            .targets(MaintenanceWindowTargetTargetArgs.builder()
                .key("tag:Name")
                .values("acceptance_test")
                .build())
            .build());
    }
}

Resource Group Target

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ssm.MaintenanceWindow;
import com.pulumi.aws.ssm.MaintenanceWindowArgs;
import com.pulumi.aws.ssm.MaintenanceWindowTarget;
import com.pulumi.aws.ssm.MaintenanceWindowTargetArgs;
import com.pulumi.aws.ssm.inputs.MaintenanceWindowTargetTargetArgs;
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 window = new MaintenanceWindow("window", MaintenanceWindowArgs.builder()
            .schedule("cron(0 16 ? * TUE *)")
            .duration(3)
            .cutoff(1)
            .build());
        var target1 = new MaintenanceWindowTarget("target1", MaintenanceWindowTargetArgs.builder()
            .windowId(window.id())
            .description("This is a maintenance window target")
            .resourceType("RESOURCE_GROUP")
            .targets(MaintenanceWindowTargetTargetArgs.builder()
                .key("resource-groups:ResourceTypeFilters")
                .values("AWS::EC2::Instance")
                .build())
            .build());
    }
}

Import

Using pulumi import, import SSM Maintenance Window targets using WINDOW_ID/WINDOW_TARGET_ID. For example:

$ pulumi import aws:ssm/maintenanceWindowTarget:MaintenanceWindowTarget example mw-0c50858d01EXAMPLE/23639a0b-ddbc-4bca-9e72-78d96EXAMPLE

Constructors

MaintenanceWindowTargetArgs

fun MaintenanceWindowTargetArgs(description: Output<String>? = null, name: Output<String>? = null, ownerInformation: Output<String>? = null, resourceType: Output<String>? = null, targets: Output<List<MaintenanceWindowTargetTargetArgs>>? = null, windowId: Output<String>? = null)

Functions

toJava

open override fun toJava(): MaintenanceWindowTargetArgs

Properties

description

val description: Output<String>? = null

The description of the maintenance window target.

name

val name: Output<String>? = null

The name of the maintenance window target.

ownerInformation

val ownerInformation: Output<String>? = null

User-provided value that will be included in any CloudWatch events raised while running tasks for these targets in this Maintenance Window.

resourceType

val resourceType: Output<String>? = null

The type of target being registered with the Maintenance Window. Possible values are INSTANCE and RESOURCE_GROUP.

targets

val targets: Output<List<MaintenanceWindowTargetTargetArgs>>? = null

The targets to register with the maintenance window. In other words, the instances to run commands on when the maintenance window runs. You can specify targets using instance IDs, resource group names, or tags that have been applied to instances. For more information about these examples formats see (https://docs.aws.amazon.com/systems-manager/latest/userguide/mw-cli-tutorial-targets-examples.html)

windowId

val windowId: Output<String>? = null

The Id of the maintenance window to register the target with.