Sign in Dashboard Get started
  1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. appconfig
  6. ExperimentDefinition

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.appconfig.ExperimentDefinition

aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::AppConfig::ExperimentDefinition

    Create ExperimentDefinition Resource

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

    Constructor syntax

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

@overload
def ExperimentDefinition(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         application_identifier: Optional[str] = None,
                         audience_rule: Optional[str] = None,
                         configuration_profile_identifier: Optional[str] = None,
                         control: Optional[ExperimentDefinitionTreatmentArgs] = None,
                         environment_identifier: Optional[str] = None,
                         flag_key: Optional[str] = None,
                         treatments: Optional[Sequence[ExperimentDefinitionTreatmentArgs]] = None,
                         audience_description: Optional[str] = None,
                         hypothesis: Optional[str] = None,
                         launch_criteria: Optional[str] = None,
                         name: Optional[str] = None,
                         tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewExperimentDefinition(ctx *Context, name string, args ExperimentDefinitionArgs, opts ...ResourceOption) (*ExperimentDefinition, error)
    public ExperimentDefinition(string name, ExperimentDefinitionArgs args, CustomResourceOptions? opts = null)
    public ExperimentDefinition(String name, ExperimentDefinitionArgs args)
public ExperimentDefinition(String name, ExperimentDefinitionArgs args, CustomResourceOptions options)

    type: aws-native:appconfig:ExperimentDefinition
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_appconfig_experiment_definition" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args ExperimentDefinitionArgs
    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 ExperimentDefinitionArgs
    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 ExperimentDefinitionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ExperimentDefinitionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ExperimentDefinitionArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

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

    ApplicationIdentifier string
    The application ID, name, or ARN.
    AudienceRule string
    Rule expression defining the experiment audience.
    ConfigurationProfileIdentifier string
    The configuration profile ID, name, or ARN.
    Control Pulumi.AwsNative.AppConfig.Inputs.ExperimentDefinitionTreatment
    The control (baseline) variant.
    EnvironmentIdentifier string
    The environment ID, name, or ARN.
    FlagKey string
    The key of the existing flag in the configuration profile to experiment on.
    Treatments List<Pulumi.AwsNative.AppConfig.Inputs.ExperimentDefinitionTreatment>
    Treatment variants (1-5).
    AudienceDescription string
    Human-readable description of the audience.
    Hypothesis string
    The hypothesis of the experiment.
    LaunchCriteria string
    Criteria for launching the experiment.
    Name string
    A name for the experiment definition.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    Tags to associate with the experiment definition.
    ApplicationIdentifier string
    The application ID, name, or ARN.
    AudienceRule string
    Rule expression defining the experiment audience.
    ConfigurationProfileIdentifier string
    The configuration profile ID, name, or ARN.
    Control ExperimentDefinitionTreatmentArgs
    The control (baseline) variant.
    EnvironmentIdentifier string
    The environment ID, name, or ARN.
    FlagKey string
    The key of the existing flag in the configuration profile to experiment on.
    Treatments []ExperimentDefinitionTreatmentArgs
    Treatment variants (1-5).
    AudienceDescription string
    Human-readable description of the audience.
    Hypothesis string
    The hypothesis of the experiment.
    LaunchCriteria string
    Criteria for launching the experiment.
    Name string
    A name for the experiment definition.
    Tags TagArgs
    Tags to associate with the experiment definition.
    application_identifier string
    The application ID, name, or ARN.
    audience_rule string
    Rule expression defining the experiment audience.
    configuration_profile_identifier string
    The configuration profile ID, name, or ARN.
    control object
    The control (baseline) variant.
    environment_identifier string
    The environment ID, name, or ARN.
    flag_key string
    The key of the existing flag in the configuration profile to experiment on.
    treatments list(object)
    Treatment variants (1-5).
    audience_description string
    Human-readable description of the audience.
    hypothesis string
    The hypothesis of the experiment.
    launch_criteria string
    Criteria for launching the experiment.
    name string
    A name for the experiment definition.
    tags list(object)
    Tags to associate with the experiment definition.
    applicationIdentifier String
    The application ID, name, or ARN.
    audienceRule String
    Rule expression defining the experiment audience.
    configurationProfileIdentifier String
    The configuration profile ID, name, or ARN.
    control ExperimentDefinitionTreatment
    The control (baseline) variant.
    environmentIdentifier String
    The environment ID, name, or ARN.
    flagKey String
    The key of the existing flag in the configuration profile to experiment on.
    treatments List<ExperimentDefinitionTreatment>
    Treatment variants (1-5).
    audienceDescription String
    Human-readable description of the audience.
    hypothesis String
    The hypothesis of the experiment.
    launchCriteria String
    Criteria for launching the experiment.
    name String
    A name for the experiment definition.
    tags List<Tag>
    Tags to associate with the experiment definition.
    applicationIdentifier string
    The application ID, name, or ARN.
    audienceRule string
    Rule expression defining the experiment audience.
    configurationProfileIdentifier string
    The configuration profile ID, name, or ARN.
    control ExperimentDefinitionTreatment
    The control (baseline) variant.
    environmentIdentifier string
    The environment ID, name, or ARN.
    flagKey string
    The key of the existing flag in the configuration profile to experiment on.
    treatments ExperimentDefinitionTreatment[]
    Treatment variants (1-5).
    audienceDescription string
    Human-readable description of the audience.
    hypothesis string
    The hypothesis of the experiment.
    launchCriteria string
    Criteria for launching the experiment.
    name string
    A name for the experiment definition.
    tags Tag[]
    Tags to associate with the experiment definition.
    application_identifier str
    The application ID, name, or ARN.
    audience_rule str
    Rule expression defining the experiment audience.
    configuration_profile_identifier str
    The configuration profile ID, name, or ARN.
    control ExperimentDefinitionTreatmentArgs
    The control (baseline) variant.
    environment_identifier str
    The environment ID, name, or ARN.
    flag_key str
    The key of the existing flag in the configuration profile to experiment on.
    treatments Sequence[ExperimentDefinitionTreatmentArgs]
    Treatment variants (1-5).
    audience_description str
    Human-readable description of the audience.
    hypothesis str
    The hypothesis of the experiment.
    launch_criteria str
    Criteria for launching the experiment.
    name str
    A name for the experiment definition.
    tags Sequence[TagArgs]
    Tags to associate with the experiment definition.
    applicationIdentifier String
    The application ID, name, or ARN.
    audienceRule String
    Rule expression defining the experiment audience.
    configurationProfileIdentifier String
    The configuration profile ID, name, or ARN.
    control Property Map
    The control (baseline) variant.
    environmentIdentifier String
    The environment ID, name, or ARN.
    flagKey String
    The key of the existing flag in the configuration profile to experiment on.
    treatments List<Property Map>
    Treatment variants (1-5).
    audienceDescription String
    Human-readable description of the audience.
    hypothesis String
    The hypothesis of the experiment.
    launchCriteria String
    Criteria for launching the experiment.
    name String
    A name for the experiment definition.
    tags List<Property Map>
    Tags to associate with the experiment definition.

    Outputs

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

    ApplicationId string
    The resolved application ID (read-only, assigned by service).
    AwsId string
    The experiment definition ID.
    CreatedAt string
    ISO-8601 creation timestamp.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status Pulumi.AwsNative.AppConfig.ExperimentDefinitionStatus
    Current status.
    UpdatedAt string
    ISO-8601 last update timestamp.
    ApplicationId string
    The resolved application ID (read-only, assigned by service).
    AwsId string
    The experiment definition ID.
    CreatedAt string
    ISO-8601 creation timestamp.
    Id string
    The provider-assigned unique ID for this managed resource.
    Status ExperimentDefinitionStatus
    Current status.
    UpdatedAt string
    ISO-8601 last update timestamp.
    application_id string
    The resolved application ID (read-only, assigned by service).
    aws_id string
    The experiment definition ID.
    created_at string
    ISO-8601 creation timestamp.
    id string
    The provider-assigned unique ID for this managed resource.
    status "ACTIVE" | "IDLE" | "ARCHIVED"
    Current status.
    updated_at string
    ISO-8601 last update timestamp.
    applicationId String
    The resolved application ID (read-only, assigned by service).
    awsId String
    The experiment definition ID.
    createdAt String
    ISO-8601 creation timestamp.
    id String
    The provider-assigned unique ID for this managed resource.
    status ExperimentDefinitionStatus
    Current status.
    updatedAt String
    ISO-8601 last update timestamp.
    applicationId string
    The resolved application ID (read-only, assigned by service).
    awsId string
    The experiment definition ID.
    createdAt string
    ISO-8601 creation timestamp.
    id string
    The provider-assigned unique ID for this managed resource.
    status ExperimentDefinitionStatus
    Current status.
    updatedAt string
    ISO-8601 last update timestamp.
    application_id str
    The resolved application ID (read-only, assigned by service).
    aws_id str
    The experiment definition ID.
    created_at str
    ISO-8601 creation timestamp.
    id str
    The provider-assigned unique ID for this managed resource.
    status ExperimentDefinitionStatus
    Current status.
    updated_at str
    ISO-8601 last update timestamp.
    applicationId String
    The resolved application ID (read-only, assigned by service).
    awsId String
    The experiment definition ID.
    createdAt String
    ISO-8601 creation timestamp.
    id String
    The provider-assigned unique ID for this managed resource.
    status "ACTIVE" | "IDLE" | "ARCHIVED"
    Current status.
    updatedAt String
    ISO-8601 last update timestamp.

    Supporting Types

    ExperimentDefinitionAttributeValue, ExperimentDefinitionAttributeValueArgs

    A typed attribute value for a treatment flag.
    BooleanValue bool
    A boolean value.
    NumberArray List<double>
    An array of numeric values.
    NumberValue double
    A numeric value.
    StringArray List<string>
    An array of string values.
    StringValue string
    A string value.
    BooleanValue bool
    A boolean value.
    NumberArray []float64
    An array of numeric values.
    NumberValue float64
    A numeric value.
    StringArray []string
    An array of string values.
    StringValue string
    A string value.
    boolean_value bool
    A boolean value.
    number_array list(number)
    An array of numeric values.
    number_value number
    A numeric value.
    string_array list(string)
    An array of string values.
    string_value string
    A string value.
    booleanValue Boolean
    A boolean value.
    numberArray List<Double>
    An array of numeric values.
    numberValue Double
    A numeric value.
    stringArray List<String>
    An array of string values.
    stringValue String
    A string value.
    booleanValue boolean
    A boolean value.
    numberArray number[]
    An array of numeric values.
    numberValue number
    A numeric value.
    stringArray string[]
    An array of string values.
    stringValue string
    A string value.
    boolean_value bool
    A boolean value.
    number_array Sequence[float]
    An array of numeric values.
    number_value float
    A numeric value.
    string_array Sequence[str]
    An array of string values.
    string_value str
    A string value.
    booleanValue Boolean
    A boolean value.
    numberArray List<Number>
    An array of numeric values.
    numberValue Number
    A numeric value.
    stringArray List<String>
    An array of string values.
    stringValue String
    A string value.

    ExperimentDefinitionStatus, ExperimentDefinitionStatusArgs

    Active
    ACTIVE
    Idle
    IDLE
    Archived
    ARCHIVED
    ExperimentDefinitionStatusActive
    ACTIVE
    ExperimentDefinitionStatusIdle
    IDLE
    ExperimentDefinitionStatusArchived
    ARCHIVED
    "ACTIVE"
    ACTIVE
    "IDLE"
    IDLE
    "ARCHIVED"
    ARCHIVED
    Active
    ACTIVE
    Idle
    IDLE
    Archived
    ARCHIVED
    Active
    ACTIVE
    Idle
    IDLE
    Archived
    ARCHIVED
    ACTIVE
    ACTIVE
    IDLE
    IDLE
    ARCHIVED
    ARCHIVED
    "ACTIVE"
    ACTIVE
    "IDLE"
    IDLE
    "ARCHIVED"
    ARCHIVED

    ExperimentDefinitionTreatment, ExperimentDefinitionTreatmentArgs

    A treatment variant with weight and flag value. The Key is auto-generated by the service.
    Enabled bool
    Whether the flag is enabled for this variant.
    Weight double
    Traffic weight percentage.
    AttributeValues Dictionary<string, Pulumi.AwsNative.AppConfig.Inputs.ExperimentDefinitionAttributeValue>
    Map of attribute name to attribute value.
    Description string
    Key string
    The treatment key (read-only, auto-generated by service).
    Enabled bool
    Whether the flag is enabled for this variant.
    Weight float64
    Traffic weight percentage.
    AttributeValues map[string]ExperimentDefinitionAttributeValue
    Map of attribute name to attribute value.
    Description string
    Key string
    The treatment key (read-only, auto-generated by service).
    enabled bool
    Whether the flag is enabled for this variant.
    weight number
    Traffic weight percentage.
    attribute_values map(object)
    Map of attribute name to attribute value.
    description string
    key string
    The treatment key (read-only, auto-generated by service).
    enabled Boolean
    Whether the flag is enabled for this variant.
    weight Double
    Traffic weight percentage.
    attributeValues Map<String,ExperimentDefinitionAttributeValue>
    Map of attribute name to attribute value.
    description String
    key String
    The treatment key (read-only, auto-generated by service).
    enabled boolean
    Whether the flag is enabled for this variant.
    weight number
    Traffic weight percentage.
    attributeValues {[key: string]: ExperimentDefinitionAttributeValue}
    Map of attribute name to attribute value.
    description string
    key string
    The treatment key (read-only, auto-generated by service).
    enabled bool
    Whether the flag is enabled for this variant.
    weight float
    Traffic weight percentage.
    attribute_values Mapping[str, ExperimentDefinitionAttributeValue]
    Map of attribute name to attribute value.
    description str
    key str
    The treatment key (read-only, auto-generated by service).
    enabled Boolean
    Whether the flag is enabled for this variant.
    weight Number
    Traffic weight percentage.
    attributeValues Map<Property Map>
    Map of attribute name to attribute value.
    description String
    key String
    The treatment key (read-only, auto-generated by service).

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.76.0
    published on Monday, Aug 24, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial