# CfnExperimentDefinitionProps

Properties for defining a `CfnExperimentDefinition`.

Extends: CfnExperimentDefinitionProps
Used as props by: CfnExperimentDefinition

- Source: Generated code
- Type last changed: v2.268.0 · 2 Sep 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_appconfig as appconfig } from 'aws-cdk-lib';
const cfnExperimentDefinitionProps: appconfig.CfnExperimentDefinitionProps = {
  applicationIdentifier: 'applicationIdentifier',
  audienceRule: 'audienceRule',
  configurationProfileIdentifier: 'configurationProfileIdentifier',
  control: {
    enabled: false,
    weight: 123,

    // the properties below are optional
    attributeValues: {
      attributeValuesKey: {
        booleanValue: false,
        numberArray: [123],
        numberValue: 123,
        stringArray: ['stringArray'],
        stringValue: 'stringValue',
      },
    },
    description: 'description',
    key: 'key',
  },
  environmentIdentifier: 'environmentIdentifier',
  flagKey: 'flagKey',
  name: 'name',
  treatments: [{
    enabled: false,
    weight: 123,

    // the properties below are optional
    attributeValues: {
      attributeValuesKey: {
        booleanValue: false,
        numberArray: [123],
        numberValue: 123,
        stringArray: ['stringArray'],
        stringValue: 'stringValue',
      },
    },
    description: 'description',
    key: 'key',
  }],

  // the properties below are optional
  audienceDescription: 'audienceDescription',
  hypothesis: 'hypothesis',
  launchCriteria: 'launchCriteria',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};
```

## Properties

- `applicationIdentifier`: string (required) — The application ID, name, or ARN.

- `audienceDescription`: string — Human-readable description of the audience.

- `audienceRule`: string (required) — Rule expression defining the experiment audience.

- `configurationProfileIdentifier`: string (required) — The configuration profile ID, name, or ARN.

- `control`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnExperimentDefinition.TreatmentProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_appconfig.CfnExperimentDefinition.TreatmentProperty.html) (required) — A treatment variant with weight and flag value.

  The Key is auto-generated by the service.

- `environmentIdentifier`: string (required) — The environment ID, name, or ARN.

- `flagKey`: string (required) — The key of the existing flag in the configuration profile to experiment on.

- `hypothesis`: string — The hypothesis of the experiment.

- `launchCriteria`: string — Criteria for launching the experiment.

- `name`: string (required) — A name for the experiment definition.

- `tags`: [CfnTag](/cdk/api/v2/docs/aws-cdk-lib.CfnTag.html)[] — Tags to associate with the experiment definition.

- `treatments`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnExperimentDefinition.TreatmentProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_appconfig.CfnExperimentDefinition.TreatmentProperty.html)[] (required) — Treatment variants (1-5).