interface IDeliveryStream
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.KinesisFirehose.IDeliveryStream |
Java | software.amazon.awscdk.services.kinesisfirehose.IDeliveryStream |
Python | aws_cdk.aws_kinesisfirehose.IDeliveryStream |
TypeScript (source) | @aws-cdk/aws-kinesisfirehose » IDeliveryStream |
Implemented by
Delivery
Obtainable from
Delivery
.fromDeliveryStreamArn()
, Delivery
.fromDeliveryStreamAttributes()
, Delivery
.fromDeliveryStreamName()
Represents a Kinesis Data Firehose delivery stream.
Properties
Name | Type | Description |
---|---|---|
connections | Connections | The network connections associated with this resource. |
delivery | string | The ARN of the delivery stream. |
delivery | string | The name of the delivery stream. |
env | Resource | The environment this resource belongs to. |
grant | IPrincipal | The principal to grant permissions to. |
node | Construct | The construct tree node for this construct. |
stack | Stack | The stack in which this resource is defined. |
connections
Type:
Connections
The network connections associated with this resource.
deliveryStreamArn
Type:
string
The ARN of the delivery stream.
deliveryStreamName
Type:
string
The name of the delivery stream.
env
Type:
Resource
The environment this resource belongs to.
For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into.
grantPrincipal
Type:
IPrincipal
The principal to grant permissions to.
node
Type:
Construct
The construct tree node for this construct.
stack
Type:
Stack
The stack in which this resource is defined.
Methods
Name | Description |
---|---|
apply | Apply the given removal policy to this resource. |
grant(grantee, ...actions) | Grant the grantee identity permissions to perform actions . |
grant | Grant the grantee identity permissions to perform firehose:PutRecord and firehose:PutRecordBatch actions on this delivery stream. |
metric(metricName, props?) | Return the given named metric for this delivery stream. |
metric | Metric for the number of bytes delivered to Amazon S3 for backup over the specified time period. |
metric | Metric for the age (from getting into Kinesis Data Firehose to now) of the oldest record in Kinesis Data Firehose. |
metric | Metric for the number of records delivered to Amazon S3 for backup over the specified time period. |
metric | Metric for the number of bytes ingested successfully into the delivery stream over the specified time period after throttling. |
metric | Metric for the number of records ingested successfully into the delivery stream over the specified time period after throttling. |
RemovalPolicy(policy)
applypublic applyRemovalPolicy(policy: RemovalPolicy): void
Parameters
- policy
Removal
Policy
Apply the given removal policy to this resource.
The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you've removed it from the CDK application or because you've made a change that requires the resource to be replaced.
The resource can be deleted (RemovalPolicy.DESTROY
), or left in your AWS
account for data recovery and cleanup later (RemovalPolicy.RETAIN
).
grant(grantee, ...actions)
public grant(grantee: IGrantable, ...actions: string[]): Grant
Parameters
- grantee
IGrantable
- actions
string
Returns
Grant the grantee
identity permissions to perform actions
.
PutRecords(grantee)
grantpublic grantPutRecords(grantee: IGrantable): Grant
Parameters
- grantee
IGrantable
Returns
Grant the grantee
identity permissions to perform firehose:PutRecord
and firehose:PutRecordBatch
actions on this delivery stream.
metric(metricName, props?)
public metric(metricName: string, props?: MetricOptions): Metric
Parameters
- metricName
string
- props
Metric
Options
Returns
Return the given named metric for this delivery stream.
BackupToS3Bytes(props?)
metricpublic metricBackupToS3Bytes(props?: MetricOptions): Metric
Parameters
- props
Metric
Options
Returns
Metric for the number of bytes delivered to Amazon S3 for backup over the specified time period.
By default, this metric will be calculated as an average over a period of 5 minutes.
BackupToS3DataFreshness(props?)
metricpublic metricBackupToS3DataFreshness(props?: MetricOptions): Metric
Parameters
- props
Metric
Options
Returns
Metric for the age (from getting into Kinesis Data Firehose to now) of the oldest record in Kinesis Data Firehose.
Any record older than this age has been delivered to the Amazon S3 bucket for backup.
By default, this metric will be calculated as an average over a period of 5 minutes.
BackupToS3Records(props?)
metricpublic metricBackupToS3Records(props?: MetricOptions): Metric
Parameters
- props
Metric
Options
Returns
Metric for the number of records delivered to Amazon S3 for backup over the specified time period.
By default, this metric will be calculated as an average over a period of 5 minutes.
IncomingBytes(props?)
metricpublic metricIncomingBytes(props?: MetricOptions): Metric
Parameters
- props
Metric
Options
Returns
Metric for the number of bytes ingested successfully into the delivery stream over the specified time period after throttling.
By default, this metric will be calculated as an average over a period of 5 minutes.
IncomingRecords(props?)
metricpublic metricIncomingRecords(props?: MetricOptions): Metric
Parameters
- props
Metric
Options
Returns
Metric for the number of records ingested successfully into the delivery stream over the specified time period after throttling.
By default, this metric will be calculated as an average over a period of 5 minutes.