Package com.pulumi.aws.evidently

Class Launch

  • public class Launch
extends com.pulumi.resources.CustomResource
    Provides a CloudWatch Evidently Launch resource. ## Example Usage ### Basic <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .groups(LaunchGroupArgs.builder()
                 .feature(exampleAwsEvidentlyFeature.name())
                 .name("Variation1")
                 .variation("Variation1")
                 .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.of("Variation1", 0))
                     .startTime("2024-01-07 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With description <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .description("example description")
             .groups(LaunchGroupArgs.builder()
                 .feature(exampleAwsEvidentlyFeature.name())
                 .name("Variation1")
                 .variation("Variation1")
                 .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.of("Variation1", 0))
                     .startTime("2024-01-07 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With multiple groups <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .groups(            
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation1")
                     .variation("Variation1")
                     .description("first-group")
                     .build(),
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation2")
                     .variation("Variation2")
                     .description("second-group")
                     .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.ofEntries(
                         Map.entry("Variation1", 0),
                         Map.entry("Variation2", 0)
                     ))
                     .startTime("2024-01-07 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With metric_monitors <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchMetricMonitorArgs;
 import com.pulumi.aws.evidently.inputs.LaunchMetricMonitorMetricDefinitionArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .groups(LaunchGroupArgs.builder()
                 .feature(exampleAwsEvidentlyFeature.name())
                 .name("Variation1")
                 .variation("Variation1")
                 .build())
             .metricMonitors(            
                 LaunchMetricMonitorArgs.builder()
                     .metricDefinition(LaunchMetricMonitorMetricDefinitionArgs.builder()
                         .entityIdKey("entity_id_key1")
                         .eventPattern("{\"Price\":[{\"numeric\":[\">\",11,\"<=\",22]}]}")
                         .name("name1")
                         .unitLabel("unit_label1")
                         .valueKey("value_key1")
                         .build())
                     .build(),
                 LaunchMetricMonitorArgs.builder()
                     .metricDefinition(LaunchMetricMonitorMetricDefinitionArgs.builder()
                         .entityIdKey("entity_id_key2")
                         .eventPattern("{\"Price\":[{\"numeric\":[\">\",9,\"<=\",19]}]}")
                         .name("name2")
                         .unitLabel("unit_label2")
                         .valueKey("value_key2")
                         .build())
                     .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.of("Variation1", 0))
                     .startTime("2024-01-07 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With randomization_salt <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .randomizationSalt("example randomization salt")
             .groups(LaunchGroupArgs.builder()
                 .feature(exampleAwsEvidentlyFeature.name())
                 .name("Variation1")
                 .variation("Variation1")
                 .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.of("Variation1", 0))
                     .startTime("2024-01-07 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With multiple steps <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .groups(            
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation1")
                     .variation("Variation1")
                     .build(),
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation2")
                     .variation("Variation2")
                     .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(                
                     LaunchScheduledSplitsConfigStepArgs.builder()
                         .groupWeights(Map.ofEntries(
                             Map.entry("Variation1", 15),
                             Map.entry("Variation2", 10)
                         ))
                         .startTime("2024-01-07 01:43:59+00:00")
                         .build(),
                     LaunchScheduledSplitsConfigStepArgs.builder()
                         .groupWeights(Map.ofEntries(
                             Map.entry("Variation1", 20),
                             Map.entry("Variation2", 25)
                         ))
                         .startTime("2024-01-08 01:43:59+00:00")
                         .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ### With segment overrides <!--Start PulumiCodeChooser --> 
     
 package generated_program;
 
 import com.pulumi.Context;
 import com.pulumi.Pulumi;
 import com.pulumi.core.Output;
 import com.pulumi.aws.evidently.Launch;
 import com.pulumi.aws.evidently.LaunchArgs;
 import com.pulumi.aws.evidently.inputs.LaunchGroupArgs;
 import com.pulumi.aws.evidently.inputs.LaunchScheduledSplitsConfigArgs;
 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 Launch("example", LaunchArgs.builder()
             .name("example")
             .project(exampleAwsEvidentlyProject.name())
             .groups(            
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation1")
                     .variation("Variation1")
                     .build(),
                 LaunchGroupArgs.builder()
                     .feature(exampleAwsEvidentlyFeature.name())
                     .name("Variation2")
                     .variation("Variation2")
                     .build())
             .scheduledSplitsConfig(LaunchScheduledSplitsConfigArgs.builder()
                 .steps(LaunchScheduledSplitsConfigStepArgs.builder()
                     .groupWeights(Map.ofEntries(
                         Map.entry("Variation1", 0),
                         Map.entry("Variation2", 0)
                     ))
                     .segmentOverrides(                    
                         LaunchScheduledSplitsConfigStepSegmentOverrideArgs.builder()
                             .evaluationOrder(1)
                             .segment(exampleAwsEvidentlySegment.name())
                             .weights(Map.of("Variation2", 10000))
                             .build(),
                         LaunchScheduledSplitsConfigStepSegmentOverrideArgs.builder()
                             .evaluationOrder(2)
                             .segment(exampleAwsEvidentlySegment.name())
                             .weights(Map.ofEntries(
                                 Map.entry("Variation1", 40000),
                                 Map.entry("Variation2", 30000)
                             ))
                             .build())
                     .startTime("2024-01-08 01:43:59+00:00")
                     .build())
                 .build())
             .build());
 
     }
 }
    <!--End PulumiCodeChooser --> ## Import Import using the `name` of the launch and `arn` of the project separated by a `:`: __Using `pulumi import` to import__ CloudWatch Evidently Launch using the `name` of the launch and `name` of the project or `arn` of the hosting CloudWatch Evidently Project separated by a `:`. For example: Import using the `name` of the launch and `name` of the project separated by a `:`: ```sh $ pulumi import aws:evidently/launch:Launch example exampleLaunchName:exampleProjectName ``` Import using the `name` of the launch and `arn` of the project separated by a `:`: ```sh $ pulumi import aws:evidently/launch:Launch example exampleLaunchName:arn:aws:evidently:us-east-1:123456789012:project/exampleProjectName ```

    • Nested Class Summary

      • Nested classes/interfaces inherited from class com.pulumi.resources.CustomResource

        com.pulumi.resources.CustomResource.CustomResourceInternal

      • Nested classes/interfaces inherited from class com.pulumi.resources.Resource

        com.pulumi.resources.Resource.LazyField<T extends java.lang.Object>, com.pulumi.resources.Resource.LazyFields, com.pulumi.resources.Resource.ResourceInternal

    • Field Summary

      • Fields inherited from class com.pulumi.resources.Resource

        childResources, remote

    • Constructor Summary

      Constructors 
      Constructor Description
      Launch​(java.lang.String name)  
      Launch​(java.lang.String name, LaunchArgs args)  
      Launch​(java.lang.String name, LaunchArgs args, com.pulumi.resources.CustomResourceOptions options)  

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      com.pulumi.core.Output<java.lang.String> arn()  
      com.pulumi.core.Output<java.lang.String> createdTime()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> description()  
      com.pulumi.core.Output<java.util.List<LaunchExecution>> executions()  
      static Launch get​(java.lang.String name, com.pulumi.core.Output<java.lang.String> id, LaunchState state, com.pulumi.resources.CustomResourceOptions options)
      Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
      com.pulumi.core.Output<java.util.List<LaunchGroup>> groups()  
      com.pulumi.core.Output<java.lang.String> lastUpdatedTime()  
      com.pulumi.core.Output<java.util.Optional<java.util.List<LaunchMetricMonitor>>> metricMonitors()  
      com.pulumi.core.Output<java.lang.String> name()  
      com.pulumi.core.Output<java.lang.String> project()  
      com.pulumi.core.Output<java.util.Optional<java.lang.String>> randomizationSalt()  
      com.pulumi.core.Output<java.util.Optional<LaunchScheduledSplitsConfig>> scheduledSplitsConfig()  
      com.pulumi.core.Output<java.lang.String> status()  
      com.pulumi.core.Output<java.lang.String> statusReason()  
      com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> tags()  
      com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>> tagsAll()  
      com.pulumi.core.Output<java.lang.String> type()  

      • Methods inherited from class com.pulumi.resources.CustomResource

        getId, id, idFuture

      • Methods inherited from class com.pulumi.resources.Resource

        getChildResources, getResourceName, getResourceType, getUrn, pulumiChildResources, pulumiResourceName, pulumiResourceType, urn

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Constructor Detail

      • Launch

        public Launch​(java.lang.String name)
        Parameters:
        name - The _unique_ name of the resulting resource.

      • Launch

        public Launch​(java.lang.String name,
              LaunchArgs args)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.

      • Launch

        public Launch​(java.lang.String name,
              LaunchArgs args,
              @Nullable
              com.pulumi.resources.CustomResourceOptions options)
        Parameters:
        name - The _unique_ name of the resulting resource.
        args - The arguments to use to populate this resource's properties.
        options - A bag of options that control this resource's behavior.

    • Method Detail

      • arn

        public com.pulumi.core.Output<java.lang.String> arn()
        Returns:
        The ARN of the launch.

      • createdTime

        public com.pulumi.core.Output<java.lang.String> createdTime()
        Returns:
        The date and time that the launch is created.

      • description

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> description()
        Returns:
        Specifies the description of the launch.

      • executions

        public com.pulumi.core.Output<java.util.List<LaunchExecution>> executions()
        Returns:
        A block that contains information about the start and end times of the launch. Detailed below

      • groups

        public com.pulumi.core.Output<java.util.List<LaunchGroup>> groups()
        Returns:
        One or up to five blocks that contain the feature and variations that are to be used for the launch. Detailed below.

      • lastUpdatedTime

        public com.pulumi.core.Output<java.lang.String> lastUpdatedTime()
        Returns:
        The date and time that the launch was most recently updated.

      • metricMonitors

        public com.pulumi.core.Output<java.util.Optional<java.util.List<LaunchMetricMonitor>>> metricMonitors()
        Returns:
        One or up to three blocks that define the metrics that will be used to monitor the launch performance. Detailed below.

      • name

        public com.pulumi.core.Output<java.lang.String> name()
        Returns:
        The name for the new launch. Minimum length of `1`. Maximum length of `127`.

      • project

        public com.pulumi.core.Output<java.lang.String> project()
        Returns:
        The name or ARN of the project that is to contain the new launch.

      • randomizationSalt

        public com.pulumi.core.Output<java.util.Optional<java.lang.String>> randomizationSalt()
        Returns:
        When Evidently assigns a particular user session to a launch, it must use a randomization ID to determine which variation the user session is served. This randomization ID is a combination of the entity ID and randomizationSalt. If you omit randomizationSalt, Evidently uses the launch name as the randomizationSalt.

      • scheduledSplitsConfig

        public com.pulumi.core.Output<java.util.Optional<LaunchScheduledSplitsConfig>> scheduledSplitsConfig()
        Returns:
        A block that defines the traffic allocation percentages among the feature variations during each step of the launch. Detailed below.

      • status

        public com.pulumi.core.Output<java.lang.String> status()
        Returns:
        The current state of the launch. Valid values are `CREATED`, `UPDATING`, `RUNNING`, `COMPLETED`, and `CANCELLED`.

      • statusReason

        public com.pulumi.core.Output<java.lang.String> statusReason()
        Returns:
        If the launch was stopped, this is the string that was entered by the person who stopped the launch, to explain why it was stopped.

      • tags

        public com.pulumi.core.Output<java.util.Optional<java.util.Map<java.lang.String,​java.lang.String>>> tags()
        Returns:
        Tags to apply to the launch. If configured with a provider `default_tags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.

      • tagsAll

        public com.pulumi.core.Output<java.util.Map<java.lang.String,​java.lang.String>> tagsAll()
        Returns:
        A map of tags assigned to the resource, including those inherited from the provider `default_tags` configuration block.

      • type

        public com.pulumi.core.Output<java.lang.String> type()
        Returns:
        The type of launch.

      • get

        public static Launch get​(java.lang.String name,
                         com.pulumi.core.Output<java.lang.String> id,
                         @Nullable
                         LaunchState state,
                         @Nullable
                         com.pulumi.resources.CustomResourceOptions options)
        Get an existing Host resource's state with the given name, ID, and optional extra properties used to qualify the lookup.
        Parameters:
        name - The _unique_ name of the resulting resource.
        id - The _unique_ provider ID of the resource to lookup.
        state -
        options - Optional settings to control the behavior of the CustomResource.