> **Experimental**
>
> `@aws-cdk/aws-gamelift-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# MatchmakingConfigurationProps

Properties for a new Gamelift matchmaking configuration.

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/matchmaking-configuration.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-gamelift-alpha/lib/matchmaking-configuration.ts#L131)

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as gamelift_alpha from '@aws-cdk/aws-gamelift-alpha';
import * as cdk from 'aws-cdk-lib';
import { aws_sns as sns } from 'aws-cdk-lib';

declare const matchmakingRuleSet: gamelift_alpha.MatchmakingRuleSet;
declare const topic: sns.Topic;
const matchmakingConfigurationProps: gamelift_alpha.MatchmakingConfigurationProps = {
  matchmakingConfigurationName: 'matchmakingConfigurationName',
  ruleSet: matchmakingRuleSet,

  // the properties below are optional
  acceptanceTimeout: cdk.Duration.minutes(30),
  customEventData: 'customEventData',
  description: 'description',
  notificationTarget: topic,
  requestTimeout: cdk.Duration.minutes(30),
  requireAcceptance: false,
};
```

## Properties

- `acceptanceTimeout`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The length of time (in seconds) to wait for players to accept a proposed match, if acceptance is required.

  **Default:** 300 seconds

- `customEventData`: string — Information to add to all events related to the matchmaking configuration.

  **Default:** no custom data added to events

- `description`: string — A human-readable description of the matchmaking configuration.

  **Default:** no description is provided

- `matchmakingConfigurationName`: string (required) — A unique identifier for the matchmaking configuration.

  This name is used to identify the configuration associated with a matchmaking request or ticket.

- `notificationTarget`: [ITopic](/cdk/api/v2/docs/aws-cdk-lib.aws_sns.ITopic.html) — An SNS topic ARN that is set up to receive matchmaking notifications.

  **Default:** no notification target

- `requestTimeout`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum duration, that a matchmaking ticket can remain in process before timing out.

  **Default:** 300 seconds

  Requests that fail due to timing out can be resubmitted as needed.

- `requireAcceptance`: boolean — A flag that determines whether a match that was created with this configuration must be accepted by the matched players.

  **Default:** Acceptance is not required

  With this option enabled, matchmaking tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a completed potential match is waiting for player acceptance.

- `ruleSet`: [IMatchmakingRuleSet](/cdk/api/v2/docs/@aws-cdk_aws-gamelift-alpha.IMatchmakingRuleSet.html) (required) — A matchmaking rule set to use with this configuration.

  A matchmaking configuration can only use rule sets that are defined in the same Region.