# InvokeConfigurationProperty

Configuration for how the subscriber invokes its target.

Specify the target ARN, the IAM role, and, optionally, the target-specific parameters object that matches the target type.

- Source: Generated code
- Type last changed: v2.275.0 · 26 Oct 2026

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_eventsv2 as eventsv2 } from 'aws-cdk-lib';
const invokeConfigurationProperty: eventsv2.CfnSubscriber.InvokeConfigurationProperty = {
  roleArn: 'roleArn',
  targetArn: 'targetArn',

  // the properties below are optional
  eventBusV2Parameters: {
    deduplicationConfiguration: {
      deduplicationType: 'deduplicationType',
    },
    metadata: {
      metadataKey: 'metadata',
    },
    systemMetadata: {
      deduplicationId: 'deduplicationId',
      eventGroupId: 'eventGroupId',
    },
  },
  httpParameters: {
    headerParameters: {
      headerParametersKey: 'headerParameters',
    },
    invocationTimeoutSeconds: 'invocationTimeoutSeconds',
    pathParameterValues: ['pathParameterValues'],
    queryStringParameters: {
      queryStringParametersKey: 'queryStringParameters',
    },
  },
  kinesisParameters: {
    explicitHashKey: 'explicitHashKey',
    partitionKey: 'partitionKey',
  },
  lambdaParameters: {
    durableExecutionName: 'durableExecutionName',
    invocationTimeoutSeconds: 'invocationTimeoutSeconds',
    invocationType: 'invocationType',
    qualifier: 'qualifier',
    tenantId: 'tenantId',
  },
  snsParameters: {
    messageAttributes: {
      messageAttributesKey: {
        dataType: 'dataType',

        // the properties below are optional
        binaryValue: 'binaryValue',
        stringValue: 'stringValue',
      },
    },
    messageDeduplicationId: 'messageDeduplicationId',
    messageGroupId: 'messageGroupId',
    messageStructure: 'messageStructure',
    subject: 'subject',
  },
  sqsParameters: {
    delaySeconds: 'delaySeconds',
    messageAttributes: {
      messageAttributesKey: {
        dataType: 'dataType',

        // the properties below are optional
        binaryValue: 'binaryValue',
        stringValue: 'stringValue',
      },
    },
    messageDeduplicationId: 'messageDeduplicationId',
    messageGroupId: 'messageGroupId',
    messageSystemAttributes: {
      messageSystemAttributesKey: {
        dataType: 'dataType',

        // the properties below are optional
        binaryValue: 'binaryValue',
        stringValue: 'stringValue',
      },
    },
  },
  stepFunctionsParameters: {
    invocationTimeoutSeconds: 'invocationTimeoutSeconds',
    invocationType: 'invocationType',
    name: 'name',
    traceHeader: 'traceHeader',
  },
  universalTargetParameters: {
    input: 'input',

    // the properties below are optional
    invocationTimeoutSeconds: 'invocationTimeoutSeconds',
  },
};
```

## Properties

- `eventBusV2Parameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.EventBusV2ParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.EventBusV2ParametersProperty.html) — Parameters for forwarding events to another EventBridge event bus, used when TargetArn is an event bus ARN of the form arn:{partition}:events:{region}:{account}:event-busv2/{name}/{id}.

- `httpParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.HttpParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.HttpParametersProperty.html) — Parameters for invoking an HTTP endpoint target, such as an Amazon API Gateway endpoint or an EventBridge API destination.

- `kinesisParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.KinesisParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.KinesisParametersProperty.html) — Parameters for writing events to an Amazon Kinesis Data Streams target.

- `lambdaParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.LambdaParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.LambdaParametersProperty.html) — Parameters for invoking an AWS Lambda function target.

- `roleArn`: string (required) — The ARN of the IAM role the service assumes to invoke the target.

  The role must belong to the same account as the subscriber.

- `snsParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.SnsParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.SnsParametersProperty.html) — Parameters for publishing events to an Amazon SNS topic target.

- `sqsParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.SqsParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.SqsParametersProperty.html) — Parameters for sending events to an Amazon SQS queue target.

- `stepFunctionsParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.StepFunctionsParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.StepFunctionsParametersProperty.html) — Parameters for starting an AWS Step Functions state machine execution target.

- `targetArn`: string (required) — The Amazon Resource Name (ARN) of the target that the subscriber invokes.

  For universal service integration targets, use the form arn:{partition}:events:::aws-sdk:{service}:{apiAction}.

- `universalTargetParameters`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnSubscriber.UniversalTargetParametersProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_eventsv2.CfnSubscriber.UniversalTargetParametersProperty.html) — Parameters for invoking an AWS service API as a universal service integration target, used when TargetArn has the form arn:{partition}:events:::aws-sdk:{service}:{apiAction}.