Class CfnPipe
java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.core.Construct
software.amazon.awscdk.core.CfnElement
software.amazon.awscdk.core.CfnRefElement
software.amazon.awscdk.core.CfnResource
software.amazon.awscdk.services.pipes.CfnPipe
- All Implemented Interfaces:
IConstruct,IDependable,IInspectable,software.amazon.jsii.JsiiSerializable,software.constructs.IConstruct
@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)",
date="2023-06-19T16:30:00.936Z")
@Stability(Stable)
public class CfnPipe
extends CfnResource
implements IInspectable
A CloudFormation
AWS::Pipes::Pipe.
Create a pipe. Amazon EventBridge Pipes connect event sources to targets and reduces the need for specialized knowledge and integration code.
Example:
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.pipes.*;
CfnPipe cfnPipe = CfnPipe.Builder.create(this, "MyCfnPipe")
.roleArn("roleArn")
.source("source")
.target("target")
// the properties below are optional
.description("description")
.desiredState("desiredState")
.enrichment("enrichment")
.enrichmentParameters(PipeEnrichmentParametersProperty.builder()
.httpParameters(PipeEnrichmentHttpParametersProperty.builder()
.headerParameters(Map.of(
"headerParametersKey", "headerParameters"))
.pathParameterValues(List.of("pathParameterValues"))
.queryStringParameters(Map.of(
"queryStringParametersKey", "queryStringParameters"))
.build())
.inputTemplate("inputTemplate")
.build())
.name("name")
.sourceParameters(PipeSourceParametersProperty.builder()
.activeMqBrokerParameters(PipeSourceActiveMQBrokerParametersProperty.builder()
.credentials(MQBrokerAccessCredentialsProperty.builder()
.basicAuth("basicAuth")
.build())
.queueName("queueName")
// the properties below are optional
.batchSize(123)
.maximumBatchingWindowInSeconds(123)
.build())
.dynamoDbStreamParameters(PipeSourceDynamoDBStreamParametersProperty.builder()
.startingPosition("startingPosition")
// the properties below are optional
.batchSize(123)
.deadLetterConfig(DeadLetterConfigProperty.builder()
.arn("arn")
.build())
.maximumBatchingWindowInSeconds(123)
.maximumRecordAgeInSeconds(123)
.maximumRetryAttempts(123)
.onPartialBatchItemFailure("onPartialBatchItemFailure")
.parallelizationFactor(123)
.build())
.filterCriteria(FilterCriteriaProperty.builder()
.filters(List.of(FilterProperty.builder()
.pattern("pattern")
.build()))
.build())
.kinesisStreamParameters(PipeSourceKinesisStreamParametersProperty.builder()
.startingPosition("startingPosition")
// the properties below are optional
.batchSize(123)
.deadLetterConfig(DeadLetterConfigProperty.builder()
.arn("arn")
.build())
.maximumBatchingWindowInSeconds(123)
.maximumRecordAgeInSeconds(123)
.maximumRetryAttempts(123)
.onPartialBatchItemFailure("onPartialBatchItemFailure")
.parallelizationFactor(123)
.startingPositionTimestamp("startingPositionTimestamp")
.build())
.managedStreamingKafkaParameters(PipeSourceManagedStreamingKafkaParametersProperty.builder()
.topicName("topicName")
// the properties below are optional
.batchSize(123)
.consumerGroupId("consumerGroupId")
.credentials(MSKAccessCredentialsProperty.builder()
.clientCertificateTlsAuth("clientCertificateTlsAuth")
.saslScram512Auth("saslScram512Auth")
.build())
.maximumBatchingWindowInSeconds(123)
.startingPosition("startingPosition")
.build())
.rabbitMqBrokerParameters(PipeSourceRabbitMQBrokerParametersProperty.builder()
.credentials(MQBrokerAccessCredentialsProperty.builder()
.basicAuth("basicAuth")
.build())
.queueName("queueName")
// the properties below are optional
.batchSize(123)
.maximumBatchingWindowInSeconds(123)
.virtualHost("virtualHost")
.build())
.selfManagedKafkaParameters(PipeSourceSelfManagedKafkaParametersProperty.builder()
.topicName("topicName")
// the properties below are optional
.additionalBootstrapServers(List.of("additionalBootstrapServers"))
.batchSize(123)
.consumerGroupId("consumerGroupId")
.credentials(SelfManagedKafkaAccessConfigurationCredentialsProperty.builder()
.basicAuth("basicAuth")
.clientCertificateTlsAuth("clientCertificateTlsAuth")
.saslScram256Auth("saslScram256Auth")
.saslScram512Auth("saslScram512Auth")
.build())
.maximumBatchingWindowInSeconds(123)
.serverRootCaCertificate("serverRootCaCertificate")
.startingPosition("startingPosition")
.vpc(SelfManagedKafkaAccessConfigurationVpcProperty.builder()
.securityGroup(List.of("securityGroup"))
.subnets(List.of("subnets"))
.build())
.build())
.sqsQueueParameters(PipeSourceSqsQueueParametersProperty.builder()
.batchSize(123)
.maximumBatchingWindowInSeconds(123)
.build())
.build())
.tags(Map.of(
"tagsKey", "tags"))
.targetParameters(PipeTargetParametersProperty.builder()
.batchJobParameters(PipeTargetBatchJobParametersProperty.builder()
.jobDefinition("jobDefinition")
.jobName("jobName")
// the properties below are optional
.arrayProperties(BatchArrayPropertiesProperty.builder()
.size(123)
.build())
.containerOverrides(BatchContainerOverridesProperty.builder()
.command(List.of("command"))
.environment(List.of(BatchEnvironmentVariableProperty.builder()
.name("name")
.value("value")
.build()))
.instanceType("instanceType")
.resourceRequirements(List.of(BatchResourceRequirementProperty.builder()
.type("type")
.value("value")
.build()))
.build())
.dependsOn(List.of(BatchJobDependencyProperty.builder()
.jobId("jobId")
.type("type")
.build()))
.parameters(Map.of(
"parametersKey", "parameters"))
.retryStrategy(BatchRetryStrategyProperty.builder()
.attempts(123)
.build())
.build())
.cloudWatchLogsParameters(PipeTargetCloudWatchLogsParametersProperty.builder()
.logStreamName("logStreamName")
.timestamp("timestamp")
.build())
.ecsTaskParameters(PipeTargetEcsTaskParametersProperty.builder()
.taskDefinitionArn("taskDefinitionArn")
// the properties below are optional
.capacityProviderStrategy(List.of(CapacityProviderStrategyItemProperty.builder()
.capacityProvider("capacityProvider")
// the properties below are optional
.base(123)
.weight(123)
.build()))
.enableEcsManagedTags(false)
.enableExecuteCommand(false)
.group("group")
.launchType("launchType")
.networkConfiguration(NetworkConfigurationProperty.builder()
.awsvpcConfiguration(AwsVpcConfigurationProperty.builder()
.subnets(List.of("subnets"))
// the properties below are optional
.assignPublicIp("assignPublicIp")
.securityGroups(List.of("securityGroups"))
.build())
.build())
.overrides(EcsTaskOverrideProperty.builder()
.containerOverrides(List.of(EcsContainerOverrideProperty.builder()
.command(List.of("command"))
.cpu(123)
.environment(List.of(EcsEnvironmentVariableProperty.builder()
.name("name")
.value("value")
.build()))
.environmentFiles(List.of(EcsEnvironmentFileProperty.builder()
.type("type")
.value("value")
.build()))
.memory(123)
.memoryReservation(123)
.name("name")
.resourceRequirements(List.of(EcsResourceRequirementProperty.builder()
.type("type")
.value("value")
.build()))
.build()))
.cpu("cpu")
.ephemeralStorage(EcsEphemeralStorageProperty.builder()
.sizeInGiB(123)
.build())
.executionRoleArn("executionRoleArn")
.inferenceAcceleratorOverrides(List.of(EcsInferenceAcceleratorOverrideProperty.builder()
.deviceName("deviceName")
.deviceType("deviceType")
.build()))
.memory("memory")
.taskRoleArn("taskRoleArn")
.build())
.placementConstraints(List.of(PlacementConstraintProperty.builder()
.expression("expression")
.type("type")
.build()))
.placementStrategy(List.of(PlacementStrategyProperty.builder()
.field("field")
.type("type")
.build()))
.platformVersion("platformVersion")
.propagateTags("propagateTags")
.referenceId("referenceId")
.tags(List.of(CfnTag.builder()
.key("key")
.value("value")
.build()))
.taskCount(123)
.build())
.eventBridgeEventBusParameters(PipeTargetEventBridgeEventBusParametersProperty.builder()
.detailType("detailType")
.endpointId("endpointId")
.resources(List.of("resources"))
.source("source")
.time("time")
.build())
.httpParameters(PipeTargetHttpParametersProperty.builder()
.headerParameters(Map.of(
"headerParametersKey", "headerParameters"))
.pathParameterValues(List.of("pathParameterValues"))
.queryStringParameters(Map.of(
"queryStringParametersKey", "queryStringParameters"))
.build())
.inputTemplate("inputTemplate")
.kinesisStreamParameters(PipeTargetKinesisStreamParametersProperty.builder()
.partitionKey("partitionKey")
.build())
.lambdaFunctionParameters(PipeTargetLambdaFunctionParametersProperty.builder()
.invocationType("invocationType")
.build())
.redshiftDataParameters(PipeTargetRedshiftDataParametersProperty.builder()
.database("database")
.sqls(List.of("sqls"))
// the properties below are optional
.dbUser("dbUser")
.secretManagerArn("secretManagerArn")
.statementName("statementName")
.withEvent(false)
.build())
.sageMakerPipelineParameters(PipeTargetSageMakerPipelineParametersProperty.builder()
.pipelineParameterList(List.of(SageMakerPipelineParameterProperty.builder()
.name("name")
.value("value")
.build()))
.build())
.sqsQueueParameters(PipeTargetSqsQueueParametersProperty.builder()
.messageDeduplicationId("messageDeduplicationId")
.messageGroupId("messageGroupId")
.build())
.stepFunctionStateMachineParameters(PipeTargetStateMachineParametersProperty.builder()
.invocationType("invocationType")
.build())
.build())
.build();
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interfaceThis structure specifies the VPC subnets and security groups for the task, and whether a public IP address is to be used.static interfaceThe array properties for the submitted job, such as the size of the array.static interfaceThe overrides that are sent to a container.static interfaceThe environment variables to send to the container.static interfaceAn object that represents an AWS Batch job dependency.static interfaceThe type and amount of a resource to assign to a container.static interfaceThe retry strategy that's associated with a job.static final classA fluent builder forCfnPipe.static interfaceThe details of a capacity provider strategy.static interfaceADeadLetterConfigobject that contains information about a dead-letter queue configuration.static interfaceThe overrides that are sent to a container.static interfaceA list of files containing the environment variables to pass to a container.static interfaceThe environment variables to send to the container.static interfaceThe amount of ephemeral storage to allocate for the task.static interfaceDetails on an Elastic Inference accelerator task override.static interfaceThe type and amount of a resource to assign to a container.static interfaceThe overrides that are associated with a task.static interfaceThe collection of event patterns used to filter events.static interfaceFilter events using an event pattern.static interfaceThe AWS Secrets Manager secret that stores your broker credentials.static interfaceThe AWS Secrets Manager secret that stores your stream credentials.static interfaceThis structure specifies the network configuration for an Amazon ECS task.static interfaceThese are custom parameter to be used when the target is an API Gateway REST APIs or EventBridge ApiDestinations.static interfaceThe parameters required to set up enrichment on your pipe.static interfaceThe parameters for using an Active MQ broker as a source.static interfaceThe parameters for using a DynamoDB stream as a source.static interfaceThe parameters for using a Kinesis stream as a source.static interfaceThe parameters for using an MSK stream as a source.static interfaceThe parameters required to set up a source for your pipe.static interfaceThe parameters for using a Rabbit MQ broker as a source.static interfaceThe parameters for using a self-managed Apache Kafka stream as a source.static interfaceThe parameters for using a Amazon SQS stream as a source.static interfaceThe parameters for using an AWS Batch job as a target.static interfaceThe parameters for using an CloudWatch Logs log stream as a target.static interfaceThe parameters for using an Amazon ECS task as a target.static interfaceThe parameters for using an EventBridge event bus as a target.static interfaceThese are custom parameter to be used when the target is an API Gateway REST APIs or EventBridge ApiDestinations.static interfaceThe parameters for using a Kinesis stream as a source.static interfaceThe parameters for using a Lambda function as a target.static interfaceThe parameters required to set up a target for your pipe.static interfaceThese are custom parameters to be used when the target is a Amazon Redshift cluster to invoke the Amazon Redshift Data API BatchExecuteStatement.static interfaceThe parameters for using a SageMaker pipeline as a target.static interfaceThe parameters for using a Amazon SQS stream as a source.static interfaceThe parameters for using a Step Functions state machine as a target.static interfaceAn object representing a constraint on task placement.static interfaceThe task placement strategy for a task or service.static interfaceName/Value pair of a parameter to start execution of a SageMaker Model Building Pipeline.static interfaceThe AWS Secrets Manager secret that stores your stream credentials.static interfaceThis structure specifies the VPC subnets and security groups for the stream, and whether a public IP address is to be used.Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject
software.amazon.jsii.JsiiObject.InitializationModeNested classes/interfaces inherited from interface software.amazon.awscdk.core.IConstruct
IConstruct.Jsii$DefaultNested classes/interfaces inherited from interface software.constructs.IConstruct
software.constructs.IConstruct.Jsii$DefaultNested classes/interfaces inherited from interface software.amazon.awscdk.core.IInspectable
IInspectable.Jsii$Default, IInspectable.Jsii$Proxy -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringThe CloudFormation resource type name for this resource class. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionThe ARN of the pipe.The time the pipe was created.The state the pipe is in.When the pipe was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD).The reason the pipe is in its current state.A description of the pipe.The state the pipe should be in.The ARN of the enrichment resource.The parameters required to set up enrichment on your pipe.getName()The name of the pipe.The ARN of the role that allows the pipe to send data to the target.The ARN of the source resource.The parameters required to set up a source for your pipe.getTags()The list of key-value pairs to associate with the pipe.The ARN of the target resource.The parameters required to set up a target for your pipe.voidinspect(TreeInspector inspector) Examines the CloudFormation resource and discloses attributes.renderProperties(Map<String, Object> props) voidsetDescription(String value) A description of the pipe.voidsetDesiredState(String value) The state the pipe should be in.voidsetEnrichment(String value) The ARN of the enrichment resource.voidThe parameters required to set up enrichment on your pipe.voidThe parameters required to set up enrichment on your pipe.voidThe name of the pipe.voidsetRoleArn(String value) The ARN of the role that allows the pipe to send data to the target.voidThe ARN of the source resource.voidsetSourceParameters(IResolvable value) The parameters required to set up a source for your pipe.voidThe parameters required to set up a source for your pipe.voidThe ARN of the target resource.voidsetTargetParameters(IResolvable value) The parameters required to set up a target for your pipe.voidThe parameters required to set up a target for your pipe.Methods inherited from class software.amazon.awscdk.core.CfnResource
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validatePropertiesMethods inherited from class software.amazon.awscdk.core.CfnRefElement
getRefMethods inherited from class software.amazon.awscdk.core.CfnElement
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalIdMethods inherited from class software.amazon.awscdk.core.Construct
getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validateMethods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSetMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Field Details
-
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
-
-
Constructor Details
-
CfnPipe
protected CfnPipe(software.amazon.jsii.JsiiObjectRef objRef) -
CfnPipe
protected CfnPipe(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) -
CfnPipe
@Stability(Stable) public CfnPipe(@NotNull Construct scope, @NotNull String id, @NotNull CfnPipeProps props) Create a newAWS::Pipes::Pipe.- Parameters:
scope-- scope in which this resource is defined.
id-- scoped id of the resource.
props-- resource properties.
-
-
Method Details
-
inspect
Examines the CloudFormation resource and discloses attributes.- Specified by:
inspectin interfaceIInspectable- Parameters:
inspector-- tree inspector to collect and process attributes.
-
renderProperties
@Stability(Stable) @NotNull protected Map<String,Object> renderProperties(@NotNull Map<String, Object> props) - Overrides:
renderPropertiesin classCfnResource- Parameters:
props- This parameter is required.
-
getAttrArn
The ARN of the pipe. -
getAttrCreationTime
The time the pipe was created. -
getAttrCurrentState
The state the pipe is in. -
getAttrLastModifiedTime
When the pipe was last updated, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD). -
getAttrStateReason
The reason the pipe is in its current state. -
getCfnProperties
- Overrides:
getCfnPropertiesin classCfnResource
-
getTags
The list of key-value pairs to associate with the pipe. -
getRoleArn
The ARN of the role that allows the pipe to send data to the target. -
setRoleArn
The ARN of the role that allows the pipe to send data to the target. -
getSource
The ARN of the source resource. -
setSource
The ARN of the source resource. -
getTarget
The ARN of the target resource. -
setTarget
The ARN of the target resource. -
getDescription
A description of the pipe. -
setDescription
A description of the pipe. -
getDesiredState
The state the pipe should be in. -
setDesiredState
The state the pipe should be in. -
getEnrichment
The ARN of the enrichment resource. -
setEnrichment
The ARN of the enrichment resource. -
getEnrichmentParameters
The parameters required to set up enrichment on your pipe. -
setEnrichmentParameters
@Stability(Stable) public void setEnrichmentParameters(@Nullable CfnPipe.PipeEnrichmentParametersProperty value) The parameters required to set up enrichment on your pipe. -
setEnrichmentParameters
The parameters required to set up enrichment on your pipe. -
getName
The name of the pipe. -
setName
The name of the pipe. -
getSourceParameters
The parameters required to set up a source for your pipe. -
setSourceParameters
The parameters required to set up a source for your pipe. -
setSourceParameters
@Stability(Stable) public void setSourceParameters(@Nullable CfnPipe.PipeSourceParametersProperty value) The parameters required to set up a source for your pipe. -
getTargetParameters
The parameters required to set up a target for your pipe.For more information about pipe target parameters, including how to use dynamic path parameters, see Target parameters in the Amazon EventBridge User Guide .
-
setTargetParameters
The parameters required to set up a target for your pipe.For more information about pipe target parameters, including how to use dynamic path parameters, see Target parameters in the Amazon EventBridge User Guide .
-
setTargetParameters
@Stability(Stable) public void setTargetParameters(@Nullable CfnPipe.PipeTargetParametersProperty value) The parameters required to set up a target for your pipe.For more information about pipe target parameters, including how to use dynamic path parameters, see Target parameters in the Amazon EventBridge User Guide .
-