amazonka-cloudwatch-events-2.0: Amazon EventBridge SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.CloudWatchEvents.Types.Target

Description

 
Synopsis

Documentation

data Target Source #

Targets are the resources to be invoked when a rule is triggered. For a complete list of services and resources that can be set as a target, see PutTargets.

If you are setting the event bus of another account as the target, and that account granted permission to your account through an organization instead of directly by the account ID, then you must specify a RoleArn with proper permissions in the Target structure. For more information, see Sending and Receiving Events Between Amazon Web Services Accounts in the Amazon EventBridge User Guide.

See: newTarget smart constructor.

Constructors

Target' 

Fields

  • batchParameters :: Maybe BatchParameters

    If the event target is an Batch job, this contains the job definition, job name, and other parameters. For more information, see Jobs in the Batch User Guide.

  • deadLetterConfig :: Maybe DeadLetterConfig

    The DeadLetterConfig that defines the target queue to send dead-letter queue events to.

  • ecsParameters :: Maybe EcsParameters

    Contains the Amazon ECS task definition and task count to be used, if the event target is an Amazon ECS task. For more information about Amazon ECS tasks, see Task Definitions in the Amazon EC2 Container Service Developer Guide.

  • httpParameters :: Maybe HttpParameters

    Contains the HTTP parameters to use when the target is a API Gateway REST endpoint or EventBridge ApiDestination.

    If you specify an API Gateway REST API or EventBridge ApiDestination as a target, you can use this parameter to specify headers, path parameters, and query string keys/values as part of your target invoking request. If you're using ApiDestinations, the corresponding Connection can also have these values configured. In case of any conflicting keys, values from the Connection take precedence.

  • input :: Maybe Text

    Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see The JavaScript Object Notation (JSON) Data Interchange Format.

  • inputPath :: Maybe Text

    The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see JSONPath.

  • inputTransformer :: Maybe InputTransformer

    Settings to enable you to provide custom input to a target based on certain event data. You can extract one or more key-value pairs from the event and then use that data to send customized input to the target.

  • kinesisParameters :: Maybe KinesisParameters

    The custom parameter you can use to control the shard assignment, when the target is a Kinesis data stream. If you do not include this parameter, the default is to use the eventId as the partition key.

  • redshiftDataParameters :: Maybe RedshiftDataParameters

    Contains the Amazon Redshift Data API parameters to use when the target is a Amazon Redshift cluster.

    If you specify a Amazon Redshift Cluster as a Target, you can use this to specify parameters to invoke the Amazon Redshift Data API ExecuteStatement based on EventBridge events.

  • retryPolicy :: Maybe RetryPolicy

    The RetryPolicy object that contains the retry policy configuration to use for the dead-letter queue.

  • roleArn :: Maybe Text

    The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.

  • runCommandParameters :: Maybe RunCommandParameters

    Parameters used when you are using the rule to invoke Amazon EC2 Run Command.

  • sageMakerPipelineParameters :: Maybe SageMakerPipelineParameters

    Contains the SageMaker Model Building Pipeline parameters to start execution of a SageMaker Model Building Pipeline.

    If you specify a SageMaker Model Building Pipeline as a target, you can use this to specify parameters to start a pipeline execution based on EventBridge events.

  • sqsParameters :: Maybe SqsParameters

    Contains the message group ID to use when the target is a FIFO queue.

    If you specify an SQS FIFO queue as a target, the queue must have content-based deduplication enabled.

  • id :: Text

    The ID of the target within the specified rule. Use this ID to reference the target when updating the rule. We recommend using a memorable and unique string.

  • arn :: Text

    The Amazon Resource Name (ARN) of the target.

Instances

Instances details
FromJSON Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

ToJSON Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Generic Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Associated Types

type Rep Target :: Type -> Type #

Methods

from :: Target -> Rep Target x #

to :: Rep Target x -> Target #

Read Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Show Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

NFData Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Methods

rnf :: Target -> () #

Eq Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Methods

(==) :: Target -> Target -> Bool #

(/=) :: Target -> Target -> Bool #

Hashable Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

Methods

hashWithSalt :: Int -> Target -> Int #

hash :: Target -> Int #

type Rep Target Source # 
Instance details

Defined in Amazonka.CloudWatchEvents.Types.Target

type Rep Target = D1 ('MetaData "Target" "Amazonka.CloudWatchEvents.Types.Target" "amazonka-cloudwatch-events-2.0-GJzRBos1CnlE3BT39axMc5" 'False) (C1 ('MetaCons "Target'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "batchParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe BatchParameters)) :*: S1 ('MetaSel ('Just "deadLetterConfig") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe DeadLetterConfig))) :*: (S1 ('MetaSel ('Just "ecsParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe EcsParameters)) :*: S1 ('MetaSel ('Just "httpParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe HttpParameters)))) :*: ((S1 ('MetaSel ('Just "input") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "inputPath") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :*: (S1 ('MetaSel ('Just "inputTransformer") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InputTransformer)) :*: S1 ('MetaSel ('Just "kinesisParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe KinesisParameters))))) :*: (((S1 ('MetaSel ('Just "redshiftDataParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RedshiftDataParameters)) :*: S1 ('MetaSel ('Just "retryPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RetryPolicy))) :*: (S1 ('MetaSel ('Just "roleArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "runCommandParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RunCommandParameters)))) :*: ((S1 ('MetaSel ('Just "sageMakerPipelineParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SageMakerPipelineParameters)) :*: S1 ('MetaSel ('Just "sqsParameters") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SqsParameters))) :*: (S1 ('MetaSel ('Just "id") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text))))))

newTarget Source #

Create a value of Target with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:batchParameters:Target', target_batchParameters - If the event target is an Batch job, this contains the job definition, job name, and other parameters. For more information, see Jobs in the Batch User Guide.

$sel:deadLetterConfig:Target', target_deadLetterConfig - The DeadLetterConfig that defines the target queue to send dead-letter queue events to.

$sel:ecsParameters:Target', target_ecsParameters - Contains the Amazon ECS task definition and task count to be used, if the event target is an Amazon ECS task. For more information about Amazon ECS tasks, see Task Definitions in the Amazon EC2 Container Service Developer Guide.

$sel:httpParameters:Target', target_httpParameters - Contains the HTTP parameters to use when the target is a API Gateway REST endpoint or EventBridge ApiDestination.

If you specify an API Gateway REST API or EventBridge ApiDestination as a target, you can use this parameter to specify headers, path parameters, and query string keys/values as part of your target invoking request. If you're using ApiDestinations, the corresponding Connection can also have these values configured. In case of any conflicting keys, values from the Connection take precedence.

$sel:input:Target', target_input - Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see The JavaScript Object Notation (JSON) Data Interchange Format.

$sel:inputPath:Target', target_inputPath - The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see JSONPath.

$sel:inputTransformer:Target', target_inputTransformer - Settings to enable you to provide custom input to a target based on certain event data. You can extract one or more key-value pairs from the event and then use that data to send customized input to the target.

$sel:kinesisParameters:Target', target_kinesisParameters - The custom parameter you can use to control the shard assignment, when the target is a Kinesis data stream. If you do not include this parameter, the default is to use the eventId as the partition key.

$sel:redshiftDataParameters:Target', target_redshiftDataParameters - Contains the Amazon Redshift Data API parameters to use when the target is a Amazon Redshift cluster.

If you specify a Amazon Redshift Cluster as a Target, you can use this to specify parameters to invoke the Amazon Redshift Data API ExecuteStatement based on EventBridge events.

$sel:retryPolicy:Target', target_retryPolicy - The RetryPolicy object that contains the retry policy configuration to use for the dead-letter queue.

$sel:roleArn:Target', target_roleArn - The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.

$sel:runCommandParameters:Target', target_runCommandParameters - Parameters used when you are using the rule to invoke Amazon EC2 Run Command.

$sel:sageMakerPipelineParameters:Target', target_sageMakerPipelineParameters - Contains the SageMaker Model Building Pipeline parameters to start execution of a SageMaker Model Building Pipeline.

If you specify a SageMaker Model Building Pipeline as a target, you can use this to specify parameters to start a pipeline execution based on EventBridge events.

$sel:sqsParameters:Target', target_sqsParameters - Contains the message group ID to use when the target is a FIFO queue.

If you specify an SQS FIFO queue as a target, the queue must have content-based deduplication enabled.

$sel:id:Target', target_id - The ID of the target within the specified rule. Use this ID to reference the target when updating the rule. We recommend using a memorable and unique string.

Target, target_arn - The Amazon Resource Name (ARN) of the target.

target_batchParameters :: Lens' Target (Maybe BatchParameters) Source #

If the event target is an Batch job, this contains the job definition, job name, and other parameters. For more information, see Jobs in the Batch User Guide.

target_deadLetterConfig :: Lens' Target (Maybe DeadLetterConfig) Source #

The DeadLetterConfig that defines the target queue to send dead-letter queue events to.

target_ecsParameters :: Lens' Target (Maybe EcsParameters) Source #

Contains the Amazon ECS task definition and task count to be used, if the event target is an Amazon ECS task. For more information about Amazon ECS tasks, see Task Definitions in the Amazon EC2 Container Service Developer Guide.

target_httpParameters :: Lens' Target (Maybe HttpParameters) Source #

Contains the HTTP parameters to use when the target is a API Gateway REST endpoint or EventBridge ApiDestination.

If you specify an API Gateway REST API or EventBridge ApiDestination as a target, you can use this parameter to specify headers, path parameters, and query string keys/values as part of your target invoking request. If you're using ApiDestinations, the corresponding Connection can also have these values configured. In case of any conflicting keys, values from the Connection take precedence.

target_input :: Lens' Target (Maybe Text) Source #

Valid JSON text passed to the target. In this case, nothing from the event itself is passed to the target. For more information, see The JavaScript Object Notation (JSON) Data Interchange Format.

target_inputPath :: Lens' Target (Maybe Text) Source #

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target. You must use JSON dot notation, not bracket notation. For more information about JSON paths, see JSONPath.

target_inputTransformer :: Lens' Target (Maybe InputTransformer) Source #

Settings to enable you to provide custom input to a target based on certain event data. You can extract one or more key-value pairs from the event and then use that data to send customized input to the target.

target_kinesisParameters :: Lens' Target (Maybe KinesisParameters) Source #

The custom parameter you can use to control the shard assignment, when the target is a Kinesis data stream. If you do not include this parameter, the default is to use the eventId as the partition key.

target_redshiftDataParameters :: Lens' Target (Maybe RedshiftDataParameters) Source #

Contains the Amazon Redshift Data API parameters to use when the target is a Amazon Redshift cluster.

If you specify a Amazon Redshift Cluster as a Target, you can use this to specify parameters to invoke the Amazon Redshift Data API ExecuteStatement based on EventBridge events.

target_retryPolicy :: Lens' Target (Maybe RetryPolicy) Source #

The RetryPolicy object that contains the retry policy configuration to use for the dead-letter queue.

target_roleArn :: Lens' Target (Maybe Text) Source #

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. If one rule triggers multiple targets, you can use a different IAM role for each target.

target_runCommandParameters :: Lens' Target (Maybe RunCommandParameters) Source #

Parameters used when you are using the rule to invoke Amazon EC2 Run Command.

target_sageMakerPipelineParameters :: Lens' Target (Maybe SageMakerPipelineParameters) Source #

Contains the SageMaker Model Building Pipeline parameters to start execution of a SageMaker Model Building Pipeline.

If you specify a SageMaker Model Building Pipeline as a target, you can use this to specify parameters to start a pipeline execution based on EventBridge events.

target_sqsParameters :: Lens' Target (Maybe SqsParameters) Source #

Contains the message group ID to use when the target is a FIFO queue.

If you specify an SQS FIFO queue as a target, the queue must have content-based deduplication enabled.

target_id :: Lens' Target Text Source #

The ID of the target within the specified rule. Use this ID to reference the target when updating the rule. We recommend using a memorable and unique string.

target_arn :: Lens' Target Text Source #

The Amazon Resource Name (ARN) of the target.