From f5e6886f6a776d70e9166987cc3d458a3ff0ff8a Mon Sep 17 00:00:00 2001 From: github-actions-bot Date: Thu, 30 Nov 2023 11:17:38 +0000 Subject: [PATCH] Updates --- classes/constructs_acm.GuCertificate.html | 6 +-- ...tructs_autoscaling.GuAutoScalingGroup.html | 6 +-- .../constructs_autoscaling.GuUserData.html | 4 +- classes/constructs_cloudwatch.GuAlarm.html | 4 +- ...ts_cloudwatch.GuAlb4xxPercentageAlarm.html | 4 +- ...ts_cloudwatch.GuAlb5xxPercentageAlarm.html | 4 +- ...oudwatch.GuLambdaErrorPercentageAlarm.html | 4 +- ...ts_cloudwatch.GuLambdaThrottlingAlarm.html | 4 +- ..._cloudwatch.GuUnhealthyInstancesAlarm.html | 4 +- classes/constructs_core.GuAmiParameter.html | 4 +- ...ucts_core.GuAnghammaradTopicParameter.html | 8 ++-- classes/constructs_core.GuArnParameter.html | 4 +- ...tructs_core.GuCertificateArnParameter.html | 4 +- ...ts_core.GuDistributionBucketParameter.html | 8 ++-- ...ucts_core.GuFastlyCustomerIdParameter.html | 8 ++-- ...cts_core.GuLoggingStreamNameParameter.html | 8 ++-- classes/constructs_core.GuParameter.html | 4 +- ...s_core.GuPrivateConfigBucketParameter.html | 6 +-- classes/constructs_core.GuStack.html | 20 +++++----- ...ructs_core.GuStackForStackSetInstance.html | 18 ++++----- .../constructs_core.GuStringParameter.html | 4 +- ...constructs_core.GuSubnetListParameter.html | 4 +- classes/constructs_core.GuVpcParameter.html | 8 ++-- classes/constructs_dns.GuCname.html | 4 +- classes/constructs_dns.GuDnsRecordSet.html | 4 +- .../constructs_ec2.GuBaseSecurityGroup.html | 4 +- ...tructs_ec2.GuHttpsEgressSecurityGroup.html | 8 ++-- classes/constructs_ec2.GuSecurityGroup.html | 6 +-- classes/constructs_ec2.GuVpc.html | 4 +- classes/constructs_ec2.GuWazuhAccess.html | 8 ++-- classes/constructs_ecs.GuEcsTask.html | 6 +-- classes/constructs_iam.GuAllowPolicy.html | 4 +- ...structs_iam.GuAnghammaradSenderPolicy.html | 8 ++-- .../constructs_iam.GuAssumeRolePolicy.html | 4 +- classes/constructs_iam.GuDenyPolicy.html | 4 +- .../constructs_iam.GuDescribeEC2Policy.html | 8 ++-- .../constructs_iam.GuDynamoDBReadPolicy.html | 4 +- .../constructs_iam.GuDynamoDBWritePolicy.html | 4 +- .../constructs_iam.GuFastlyLogsIamRole.html | 4 +- ...ucts_iam.GuGetCloudwatchMetricsPolicy.html | 4 +- ...nstructs_iam.GuGetDistributablePolicy.html | 6 +-- ...iam.GuGetDistributablePolicyStatement.html | 4 +- ...nstructs_iam.GuGetPrivateConfigPolicy.html | 4 +- .../constructs_iam.GuGetS3ObjectsPolicy.html | 4 +- .../constructs_iam.GuGithubActionsRole.html | 4 +- classes/constructs_iam.GuInstanceRole.html | 6 +-- .../constructs_iam.GuLogShippingPolicy.html | 8 ++-- ...tructs_iam.GuParameterStoreReadPolicy.html | 6 +-- classes/constructs_iam.GuPolicy.html | 4 +- ...ucts_iam.GuPutCloudwatchMetricsPolicy.html | 4 +- .../constructs_iam.GuPutS3ObjectsPolicy.html | 4 +- classes/constructs_iam.GuRole.html | 4 +- classes/constructs_iam.GuSESSenderPolicy.html | 4 +- .../constructs_iam.ReadParametersByName.html | 4 +- .../constructs_iam.ReadParametersByPath.html | 4 +- .../constructs_kinesis.GuKinesisStream.html | 4 +- .../constructs_lambda.GuLambdaFunction.html | 12 +++--- ...s_loadbalancing.GuApplicationListener.html | 6 +-- ...adbalancing.GuApplicationLoadBalancer.html | 6 +-- ...oadbalancing.GuApplicationTargetGroup.html | 8 ++-- ...dbalancing.GuHttpsApplicationListener.html | 6 +-- .../constructs_rds.GuDatabaseInstance.html | 6 +-- classes/constructs_s3.GuS3Bucket.html | 6 +-- classes/constructs_ses.GuEmailIdentity.html | 8 ++-- classes/constructs_stack_set.GuStackSet.html | 4 +- classes/constructs_vpc.GuVpc.html | 6 +-- ..._patterns.GuKinesisLambdaExperimental.html | 14 +++---- ...ntal_patterns.GuSnsLambdaExperimental.html | 14 +++---- ...patterns.GuApiGatewayWithLambdaByPath.html | 4 +- classes/patterns.GuApiLambda.html | 12 +++--- classes/patterns.GuEc2App.html | 6 +-- classes/patterns.GuNodeApp.html | 6 +-- classes/patterns.GuPlayApp.html | 6 +-- classes/patterns.GuPlayWorkerApp.html | 6 +-- classes/patterns.GuScheduledEcsTask.html | 8 ++-- classes/patterns.GuScheduledLambda.html | 12 +++--- classes/utils_lambda.StreamRetry.html | 4 +- classes/utils_test.GuTemplate.html | 4 +- enums/constants.AccessScope.html | 8 ++-- enums/constructs_dns.RecordType.html | 4 +- enums/constructs_ec2.SubnetType.html | 4 +- functions/constants.getDependency.html | 2 +- functions/constants.getDevDependency.html | 2 +- functions/constructs_ec2.maybeApp.html | 2 +- .../utils_lambda.toAwsErrorHandlingProps.html | 2 +- ...ps.transformToSecurityGroupAccessRule.html | 2 +- .../utils_test.attachPolicyToTestRole.html | 2 +- .../utils_test.simpleGuStackForTesting.html | 2 +- interfaces/constants.SsmParameterPath.html | 4 +- ...s_autoscaling.GuAutoScalingGroupProps.html | 24 +++++------ ...onstructs_autoscaling.GuUserDataProps.html | 4 +- .../constructs_cloudwatch.GuAlarmProps.html | 6 +-- ...uLambdaErrorPercentageMonitoringProps.html | 4 +- ...tch.GuLambdaThrottlingMonitoringProps.html | 8 ++-- ...nstructs_cloudwatch.Http4xxAlarmProps.html | 4 +- ...nstructs_cloudwatch.Http5xxAlarmProps.html | 4 +- .../constructs_cloudwatch.NoMonitoring.html | 4 +- interfaces/constructs_core.AppIdentity.html | 4 +- .../constructs_core.GuParameterProps.html | 4 +- interfaces/constructs_core.GuStackProps.html | 14 +++---- .../constructs_core.GuStaticLogicalId.html | 6 +-- interfaces/constructs_core.Identity.html | 4 +- .../constructs_core.StackStageIdentity.html | 4 +- interfaces/constructs_dns.GuCnameProps.html | 12 +++--- .../constructs_dns.GuDnsRecordSetProps.html | 4 +- ...nstructs_ec2.GuBaseSecurityGroupProps.html | 4 +- .../constructs_ec2.GuSecurityGroupProps.html | 6 +-- interfaces/constructs_ec2.GuSubnetProps.html | 4 +- ...onstructs_ec2.SecurityGroupAccessRule.html | 8 ++-- interfaces/constructs_ecs.GuEcsTaskProps.html | 6 +-- .../constructs_iam.GuAllowPolicyProps.html | 6 +-- ...onstructs_iam.GuAssumeRolePolicyProps.html | 4 +- ...nstructs_iam.GuFastlyLogsIamRoleProps.html | 6 +-- ...nstructs_iam.GuGetS3ObjectPolicyProps.html | 6 +-- ...am.GuGithubActionsRepositoryCondition.html | 6 +-- ...nstructs_iam.GuGithubActionsRoleProps.html | 6 +-- .../constructs_iam.GuInstanceRoleProps.html | 6 +-- ...nstructs_iam.GuPutS3ObjectPolicyProps.html | 6 +-- .../constructs_lambda.GuFunctionProps.html | 18 ++++----- ...dbalancing.GuApplicationListenerProps.html | 4 +- ...lancing.GuApplicationTargetGroupProps.html | 4 +- ...ncing.GuHttpsApplicationListenerProps.html | 6 +-- ...onstructs_rds.GuDatabaseInstanceProps.html | 6 +-- interfaces/constructs_s3.GuS3BucketProps.html | 4 +- .../constructs_ses.GuEmailIdentityProps.html | 6 +-- ...mental_patterns.ExistingKinesisStream.html | 4 +- ...xperimental_patterns.ExistingSnsTopic.html | 4 +- ...imental_patterns.GuKinesisLambdaProps.html | 26 ++++++------ ...xperimental_patterns.GuSnsLambdaProps.html | 20 +++++----- interfaces/patterns.AccessLoggingProps.html | 6 +-- interfaces/patterns.Alarms.html | 12 +++--- interfaces/patterns.ApiGatewayAlarms.html | 8 ++-- interfaces/patterns.ApiTarget.html | 10 ++--- .../patterns.ApplicationLoggingProps.html | 6 +-- ...rns.GuApiGatewayWithLambdaByPathProps.html | 8 ++-- interfaces/patterns.GuApiLambdaProps.html | 18 ++++----- interfaces/patterns.GuEc2AppProps.html | 40 +++++++++---------- .../patterns.GuScheduledEcsTaskProps.html | 8 ++-- .../patterns.GuScheduledLambdaProps.html | 20 +++++----- interfaces/types.Access.html | 4 +- interfaces/types.GuAsgCapacity.html | 6 +-- interfaces/types.GuDistributable.html | 4 +- interfaces/types.GuDistributableForEc2.html | 6 +-- interfaces/types.GuDomainName.html | 6 +-- interfaces/types.InternalAccess.html | 4 +- interfaces/types.PublicAccess.html | 4 +- interfaces/types.RestrictedAccess.html | 4 +- ...ils_ec2.GuPrivateS3ConfigurationProps.html | 4 +- ...utils_lambda.StreamErrorHandlingProps.html | 4 +- modules/constants.html | 2 +- modules/constructs_acm.html | 2 +- modules/constructs_autoscaling.html | 2 +- modules/constructs_cloudwatch.html | 2 +- modules/constructs_core.html | 2 +- modules/constructs_dns.html | 2 +- modules/constructs_ec2.html | 2 +- modules/constructs_ecs.html | 2 +- modules/constructs_iam.html | 2 +- modules/constructs_kinesis.html | 2 +- modules/constructs_lambda.html | 2 +- modules/constructs_loadbalancing.html | 2 +- modules/constructs_rds.html | 2 +- modules/constructs_s3.html | 2 +- modules/constructs_ses.html | 2 +- modules/constructs_stack_set.html | 2 +- modules/constructs_vpc.html | 2 +- modules/experimental_patterns.html | 2 +- modules/patterns.html | 2 +- modules/types.html | 2 +- modules/utils_ec2.html | 2 +- modules/utils_lambda.html | 2 +- modules/utils_security_groups.html | 2 +- modules/utils_test.html | 2 +- ...structs_acm.GuCertificatePropsWithApp.html | 2 +- ...ts_autoscaling.GuUserDataPropsWithApp.html | 2 +- ...onstructs_core.GuNoTypeParameterProps.html | 2 +- ...GuNoTypeParameterPropsWithAppIdentity.html | 2 +- ...constructs_ecs.ContainerConfiguration.html | 2 +- ...nstructs_ecs.GuEcsTaskMonitoringProps.html | 2 +- types/constructs_ecs.RegistryContainer.html | 2 +- types/constructs_ecs.RepositoryContainer.html | 2 +- types/constructs_iam.GuDenyPolicyProps.html | 2 +- ...tructs_iam.GuInstanceRolePropsWithApp.html | 2 +- ...structs_iam.GuNoStatementsPolicyProps.html | 2 +- types/constructs_iam.GuPolicyProps.html | 2 +- types/constructs_iam.GuRoleProps.html | 2 +- ...nstructs_kinesis.GuKinesisStreamProps.html | 2 +- types/constructs_vpc.GuVpcProps.html | 2 +- types/patterns.HttpMethod.html | 2 +- types/types.AppAccess.html | 2 +- types/utils_lambda.StreamProcessingProps.html | 2 +- .../constants.ALL_SSM_PARAMETER_PATHS.html | 2 +- variables/constants.ContextKeys.html | 2 +- .../constants.FASTLY_AWS_ACCOUNT_ID.html | 2 +- variables/constants.LibraryInfo.html | 2 +- variables/constants.MetadataKeys.html | 2 +- .../constants.NAMED_SSM_PARAMETER_PATHS.html | 2 +- variables/constants.RegexPattern.html | 2 +- variables/constants.TrackingTag.html | 2 +- .../constants.VPC_SSM_PARAMETER_PREFIX.html | 2 +- variables/constructs_core.AppIdentity-1.html | 2 +- variables/types.AppAccess-1.html | 2 +- variables/types.GuDistributable-1.html | 2 +- 203 files changed, 542 insertions(+), 542 deletions(-) diff --git a/classes/constructs_acm.GuCertificate.html b/classes/constructs_acm.GuCertificate.html index cf9b1a7ec9..9f5da60961 100644 --- a/classes/constructs_acm.GuCertificate.html +++ b/classes/constructs_acm.GuCertificate.html @@ -3,7 +3,7 @@ validate your certificate.

If your DNS is not managed via Route 53, or you omit the hostedZoneId props, then the CloudFormation operation which adds this construct will pause until the relevant DNS record has been added manually.

-

Hierarchy

Constructors

Hierarchy

  • Mixin<typeof Certificate, this> & Certificate<this>
    • GuCertificate

Constructors

Properties

Constructors

Properties

certificateArn: string

The certificate's ARN

+

Constructors

Properties

certificateArn: string

The certificate's ARN

env: ResourceEnvironment
idWithApp: string

The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

-
node: Node

The tree node.

+
node: Node

The tree node.

physicalName: string

Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

This value will resolve to one of the following:

diff --git a/classes/constructs_autoscaling.GuAutoScalingGroup.html b/classes/constructs_autoscaling.GuAutoScalingGroup.html index 48044ce165..1654e9c372 100644 --- a/classes/constructs_autoscaling.GuAutoScalingGroup.html +++ b/classes/constructs_autoscaling.GuAutoScalingGroup.html @@ -13,7 +13,7 @@ additionalSecurityGroups prop.

All EC2 instances provisioned via this construct will use IMDSv2.

-

Hierarchy

  • Mixin<typeof AutoScalingGroup, this> & AutoScalingGroup<this>
    • GuAutoScalingGroup

Constructors

Hierarchy

  • Mixin<typeof AutoScalingGroup, this> & AutoScalingGroup<this>
    • GuAutoScalingGroup

Constructors

Properties

albTargetGroup?: ApplicationTargetGroup
amiParameter: GuAmiParameter
app: string
autoScalingGroupArn: string

Arn of the AutoScalingGroup

+

Constructors

Properties

albTargetGroup?: ApplicationTargetGroup
amiParameter: GuAmiParameter
app: string
autoScalingGroupArn: string

Arn of the AutoScalingGroup

autoScalingGroupName: string

Name of the AutoScalingGroup

env: ResourceEnvironment
grantPrincipal: IPrincipal

The principal to grant permissions to

hasCalledScaleOnRequestCount: boolean
idWithApp: string

The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

-
imageRecipe?: string | AmigoProps
maxInstanceLifetime?: Duration

The maximum amount of time that an instance can be in service.

+
imageRecipe?: string | AmigoProps
maxInstanceLifetime?: Duration

The maximum amount of time that an instance can be in service.

newInstancesProtectedFromScaleIn?: boolean
node: Node

The tree node.

osType: OperatingSystemType

The type of OS instances of this fleet are running.

physicalName: string

Returns a string-encoded token that resolves to the physical name that diff --git a/classes/constructs_autoscaling.GuUserData.html b/classes/constructs_autoscaling.GuUserData.html index 6852bb2006..c748035286 100644 --- a/classes/constructs_autoscaling.GuUserData.html +++ b/classes/constructs_autoscaling.GuUserData.html @@ -5,11 +5,11 @@

  • download distributable
  • execute distributable
  • -

    Constructors

    Constructors

    Properties

    _userData: UserData

    Accessors

    Methods

    Generated using TypeDoc

    \ No newline at end of file +

    Constructors

    Properties

    _userData: UserData

    Accessors

    Methods

    Generated using TypeDoc

    \ No newline at end of file diff --git a/classes/constructs_cloudwatch.GuAlarm.html b/classes/constructs_cloudwatch.GuAlarm.html index a3c448b652..61c337b8ef 100644 --- a/classes/constructs_cloudwatch.GuAlarm.html +++ b/classes/constructs_cloudwatch.GuAlarm.html @@ -5,7 +5,7 @@

    This library provides an implementation of some commonly used alarms, which require less boilerplate than this construct, for example the [[GuAlb5xxPercentageAlarm]]. Prefer using these more specific implementations where possible.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_cloudwatch.GuAlb4xxPercentageAlarm.html b/classes/constructs_cloudwatch.GuAlb4xxPercentageAlarm.html index c784e4af1c..f82fd6deb4 100644 --- a/classes/constructs_cloudwatch.GuAlb4xxPercentageAlarm.html +++ b/classes/constructs_cloudwatch.GuAlb4xxPercentageAlarm.html @@ -1,6 +1,6 @@ GuAlb4xxPercentageAlarm | @guardian/cdk

    Creates an alarm which is triggered whenever the percentage of requests with a 4xx response code exceeds the specified threshold.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_cloudwatch.GuAlb5xxPercentageAlarm.html b/classes/constructs_cloudwatch.GuAlb5xxPercentageAlarm.html index d3fce026ad..e5f7b3e4ed 100644 --- a/classes/constructs_cloudwatch.GuAlb5xxPercentageAlarm.html +++ b/classes/constructs_cloudwatch.GuAlb5xxPercentageAlarm.html @@ -1,6 +1,6 @@ GuAlb5xxPercentageAlarm | @guardian/cdk

    Creates an alarm which is triggered whenever the percentage of requests with a 5xx response code exceeds the specified threshold.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_cloudwatch.GuLambdaErrorPercentageAlarm.html b/classes/constructs_cloudwatch.GuLambdaErrorPercentageAlarm.html index e48c1ace57..ff65a5a9de 100644 --- a/classes/constructs_cloudwatch.GuLambdaErrorPercentageAlarm.html +++ b/classes/constructs_cloudwatch.GuLambdaErrorPercentageAlarm.html @@ -1,5 +1,5 @@ GuLambdaErrorPercentageAlarm | @guardian/cdk

    Creates an alarm which is triggered whenever the error percentage specified is exceeded.

    -

    Hierarchy

    • GuAlarm
      • GuLambdaErrorPercentageAlarm

    Constructors

    Hierarchy

    • GuAlarm
      • GuLambdaErrorPercentageAlarm

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_cloudwatch.GuLambdaThrottlingAlarm.html b/classes/constructs_cloudwatch.GuLambdaThrottlingAlarm.html index 850a0a2e4d..9bf6e60052 100644 --- a/classes/constructs_cloudwatch.GuLambdaThrottlingAlarm.html +++ b/classes/constructs_cloudwatch.GuLambdaThrottlingAlarm.html @@ -5,7 +5,7 @@

    This library provides an implementation of some commonly used alarms, which require less boilerplate than this construct, for example the [[GuAlb5xxPercentageAlarm]]. Prefer using these more specific implementations where possible.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_cloudwatch.GuUnhealthyInstancesAlarm.html b/classes/constructs_cloudwatch.GuUnhealthyInstancesAlarm.html index e06f2c9a23..e66083decd 100644 --- a/classes/constructs_cloudwatch.GuUnhealthyInstancesAlarm.html +++ b/classes/constructs_cloudwatch.GuUnhealthyInstancesAlarm.html @@ -1,5 +1,5 @@ GuUnhealthyInstancesAlarm | @guardian/cdk

    Creates an alarm which is triggered whenever there have been several healthcheck failures within a single hour.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    +

    Constructors

    Properties

    alarmActionArns?: string[]
    alarmArn: string

    ARN of this alarm

    Attribute

    alarmName: string

    Name of this alarm.

    Attribute

    env: ResourceEnvironment
    insufficientDataActionArns?: string[]
    metric: IMetric

    The metric object this alarm was based on

    node: Node

    The tree node.

    diff --git a/classes/constructs_core.GuAmiParameter.html b/classes/constructs_core.GuAmiParameter.html index bf1cc476f7..b4a36dd38f 100644 --- a/classes/constructs_core.GuAmiParameter.html +++ b/classes/constructs_core.GuAmiParameter.html @@ -1,4 +1,4 @@ -GuAmiParameter | @guardian/cdk

    Hierarchy

    Constructors

    constructor +GuAmiParameter | @guardian/cdk

    Hierarchy

    Constructors

    Properties

    Constructors

    Properties

    id: string
    logicalId: string

    The logical ID for this CloudFormation stack element. The logical ID of the element +

    Constructors

    Properties

    id: string
    logicalId: string

    The logical ID for this CloudFormation stack element. The logical ID of the element is calculated from the path of the resource node in the construct tree.

    To override this value, use overrideLogicalId(newLogicalId).

    Returns

    the logical ID as a stringified token. This value will only get diff --git a/classes/constructs_core.GuAnghammaradTopicParameter.html b/classes/constructs_core.GuAnghammaradTopicParameter.html index 8e878d8371..fc805b82a0 100644 --- a/classes/constructs_core.GuAnghammaradTopicParameter.html +++ b/classes/constructs_core.GuAnghammaradTopicParameter.html @@ -1,7 +1,7 @@ GuAnghammaradTopicParameter | @guardian/cdk

    Creates a CloudFormation parameter to a SSM Parameter Store item that holds the ARN of the Anghammarad SNS topic. This parameter is implemented as a singleton, meaning only one can ever be added to a stack and will be reused if necessary.

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    Constructors

    Properties

    id: string
    logicalId: string

    The logical ID for this CloudFormation stack element. The logical ID of the element +

    Constructors

    Properties

    id: string
    logicalId: string

    The logical ID for this CloudFormation stack element. The logical ID of the element is calculated from the path of the resource node in the construct tree.

    To override this value, use overrideLogicalId(newLogicalId).

    Returns

    the logical ID as a stringified token. This value will only get resolved during synthesis.

    node: Node

    The tree node.

    stack: Stack

    The stack in which this element is defined. CfnElements must be defined within a stack scope (directly or indirectly).

    -
    instance: undefined | GuAnghammaradTopicParameter

    Accessors

    • get allowedPattern(): undefined | string
    • A regular expression that represents the patterns to allow for String types.

      +
    instance: undefined | GuAnghammaradTopicParameter

    Accessors

    • get allowedPattern(): undefined | string
    • A regular expression that represents the patterns to allow for String types.

      Returns undefined | string

      Default

      - No constraints on patterns allowed for parameter.
       
    • set allowedPattern(pattern): void
    • Parameters

      • pattern: undefined | string

      Returns void

    • get allowedValues(): undefined | string[]
    • An array containing the list of values allowed for the parameter.

      @@ -100,7 +100,7 @@

      Returns string

    • Returns true if a construct is a stack element (i.e. part of the +

    Returns GuAnghammaradTopicParameter

    -
    stack: Stack
    instance: undefined | GuAnghammaradSenderPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      +
    stack: Stack
    instance: undefined | GuAnghammaradSenderPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      Returns any

    • get policyName(): string
    • The name of this policy.

      Returns string

      Attribute

    Methods

    • Internal

      Called when this resource is referenced across environments (account/region) to order to request that a physical name will be generated @@ -78,7 +78,7 @@ Commonly this is the resource's ref.

    Returns string

    • Returns a string representation of this construct.

      Returns string

    • Import a policy in this app based on its name

      -

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    • Checks if x is a construct.

      +

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    -
    stack: Stack
    instance: undefined | GuPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      +
    stack: Stack
    instance: undefined | GuPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      Returns any

    • get policyName(): string
    • The name of this policy.

      Returns string

      Attribute

    Methods

    • Internal

      Called when this resource is referenced across environments (account/region) to order to request that a physical name will be generated @@ -72,7 +72,7 @@ Commonly this is the resource's ref.

    Returns string

    • Returns a string representation of this construct.

      Returns string

    • Import a policy in this app based on its name

      -

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    • Checks if x is a construct.

      +

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    -
    stack: Stack
    instance: undefined | GuLogShippingPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      +
    stack: Stack
    instance: undefined | GuLogShippingPolicy

    Accessors

    • get isAttached(): any
    • Whether the policy resource has been attached to any identity

      Returns any

    • get policyName(): string
    • The name of this policy.

      Returns string

      Attribute

    Methods

    • Internal

      Called when this resource is referenced across environments (account/region) to order to request that a physical name will be generated @@ -72,7 +72,7 @@ Commonly this is the resource's ref.

    Returns string

    • Returns a string representation of this construct.

      Returns string

    • Import a policy in this app based on its name

      -

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    • Checks if x is a construct.

      +

      Parameters

      • scope: Construct
      • id: string
      • policyName: string

      Returns IPolicy

    • Checks if x is a construct.

      Use this method instead of instanceof to properly detect Construct instances, even when the construct library is symlinked.

      Explanation: in JavaScript, multiple copies of the constructs library on diff --git a/classes/constructs_iam.GuParameterStoreReadPolicy.html b/classes/constructs_iam.GuParameterStoreReadPolicy.html index aed40a73be..44256453e5 100644 --- a/classes/constructs_iam.GuParameterStoreReadPolicy.html +++ b/classes/constructs_iam.GuParameterStoreReadPolicy.html @@ -1,6 +1,6 @@ GuParameterStoreReadPolicy | @guardian/cdk

      Grants read-only permissions for Parameter Store. These permissions are typically used for accessing private configuration. See [[ReadParametersByPath]] and [[ReadParametersByName]] for more details.

      -

      Hierarchy

      Constructors

      Hierarchy

      Constructors

      Properties

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      +

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      idWithApp: string

      The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

      -
      node: Node

      The tree node.

      +
      node: Node

      The tree node.

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

      This value will resolve to one of the following:

      diff --git a/classes/constructs_iam.GuPolicy.html b/classes/constructs_iam.GuPolicy.html index e91f8728ce..2acbdd3dbb 100644 --- a/classes/constructs_iam.GuPolicy.html +++ b/classes/constructs_iam.GuPolicy.html @@ -1,4 +1,4 @@ -GuPolicy | @guardian/cdk

      Hierarchy

      Constructors

      constructor +GuPolicy | @guardian/cdk

      Hierarchy

      Constructors

      Properties

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      +

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      node: Node

      The tree node.

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

      diff --git a/classes/constructs_iam.GuPutCloudwatchMetricsPolicy.html b/classes/constructs_iam.GuPutCloudwatchMetricsPolicy.html index d34a5f4657..01f6f9c4c0 100644 --- a/classes/constructs_iam.GuPutCloudwatchMetricsPolicy.html +++ b/classes/constructs_iam.GuPutCloudwatchMetricsPolicy.html @@ -1,4 +1,4 @@ -GuPutCloudwatchMetricsPolicy | @guardian/cdk

      Hierarchy

      • GuCloudwatchPolicy
        • GuPutCloudwatchMetricsPolicy

      Constructors

      constructor +GuPutCloudwatchMetricsPolicy | @guardian/cdk

      Hierarchy

      • GuCloudwatchPolicy
        • GuPutCloudwatchMetricsPolicy

      Constructors

      Properties

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      +

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      node: Node

      The tree node.

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

      diff --git a/classes/constructs_iam.GuPutS3ObjectsPolicy.html b/classes/constructs_iam.GuPutS3ObjectsPolicy.html index c7989ba73d..e0cec52c72 100644 --- a/classes/constructs_iam.GuPutS3ObjectsPolicy.html +++ b/classes/constructs_iam.GuPutS3ObjectsPolicy.html @@ -1,4 +1,4 @@ -GuPutS3ObjectsPolicy | @guardian/cdk

      Hierarchy

      Constructors

      constructor +GuPutS3ObjectsPolicy | @guardian/cdk

      Hierarchy

      Constructors

      Properties

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      +

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      node: Node

      The tree node.

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

      diff --git a/classes/constructs_iam.GuRole.html b/classes/constructs_iam.GuRole.html index bbe733b0a7..cb73a9d7b2 100644 --- a/classes/constructs_iam.GuRole.html +++ b/classes/constructs_iam.GuRole.html @@ -1,4 +1,4 @@ -GuRole | @guardian/cdk

      Hierarchy

      Constructors

      constructor +GuRole | @guardian/cdk

      Hierarchy

      Constructors

      Properties

      assumeRoleAction: string
      assumeRolePolicy?: PolicyDocument

      The assume role policy document associated with this role.

      +

      Constructors

      Properties

      assumeRoleAction: string
      assumeRolePolicy?: PolicyDocument

      The assume role policy document associated with this role.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      node: Node

      The tree node.

      permissionsBoundary?: IManagedPolicy

      Returns the permissions boundary attached to this role

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that diff --git a/classes/constructs_iam.GuSESSenderPolicy.html b/classes/constructs_iam.GuSESSenderPolicy.html index dfcf3d755a..29040e13ee 100644 --- a/classes/constructs_iam.GuSESSenderPolicy.html +++ b/classes/constructs_iam.GuSESSenderPolicy.html @@ -1,4 +1,4 @@ -GuSESSenderPolicy | @guardian/cdk

      Hierarchy

      Constructors

      constructor +GuSESSenderPolicy | @guardian/cdk

      Hierarchy

      Constructors

      Properties

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      +

      Constructors

      Properties

      document: PolicyDocument

      The policy document.

      env: ResourceEnvironment
      grantPrincipal: IPrincipal
      node: Node

      The tree node.

      physicalName: string

      Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

      diff --git a/classes/constructs_iam.ReadParametersByName.html b/classes/constructs_iam.ReadParametersByName.html index d26a51b14b..8fedb8406b 100644 --- a/classes/constructs_iam.ReadParametersByName.html +++ b/classes/constructs_iam.ReadParametersByName.html @@ -1,7 +1,7 @@ ReadParametersByName | @guardian/cdk

      This is helpful for accessing specific pieces of private configuration. For example, the play-secret-rotation library requires ssm:GetParameters permissions.

      -

      Hierarchy

      • PolicyStatement
        • ReadParametersByName

      Constructors

      Hierarchy

      • PolicyStatement
        • ReadParametersByName

      Constructors

      Accessors

      • get actions(): string[]
      • The Actions added to this statement

        +

      Constructors

      Accessors

      • get actions(): string[]
      • The Actions added to this statement

        Returns string[]

      • get conditions(): any
      • The conditions added to this statement

        Returns any

      • get effect(): Effect
      • Whether to allow or deny the actions in this statement

        Returns Effect

      • set effect(effect): void
      • Set effect for this statement

        diff --git a/classes/constructs_iam.ReadParametersByPath.html b/classes/constructs_iam.ReadParametersByPath.html index 2aa201a6e5..10d851039e 100644 --- a/classes/constructs_iam.ReadParametersByPath.html +++ b/classes/constructs_iam.ReadParametersByPath.html @@ -1,6 +1,6 @@ ReadParametersByPath | @guardian/cdk

        This is helpful for reading all private configuration for a given app. For example, the simple-configuration library requires these permissions.

        -

        Hierarchy

        • PolicyStatement
          • ReadParametersByPath

        Constructors

        Hierarchy

        • PolicyStatement
          • ReadParametersByPath

        Constructors

        Accessors

        • get actions(): string[]
        • The Actions added to this statement

          +

        Constructors

        Accessors

        • get actions(): string[]
        • The Actions added to this statement

          Returns string[]

        • get conditions(): any
        • The conditions added to this statement

          Returns any

        • get effect(): Effect
        • Whether to allow or deny the actions in this statement

          Returns Effect

        • set effect(effect): void
        • Set effect for this statement

          diff --git a/classes/constructs_kinesis.GuKinesisStream.html b/classes/constructs_kinesis.GuKinesisStream.html index 52c4107108..fd723f87c6 100644 --- a/classes/constructs_kinesis.GuKinesisStream.html +++ b/classes/constructs_kinesis.GuKinesisStream.html @@ -1,7 +1,7 @@ GuKinesisStream | @guardian/cdk

          Construct which creates a Kinesis stream.

          This resource is stateful.

          Hierarchy

          • Stream
            • GuKinesisStream

          Constructors

          Hierarchy

          • Stream
            • GuKinesisStream

          Constructors

          Properties

          Constructors

          Properties

          encryptionKey?: IKey
          env: ResourceEnvironment
          node: Node

          The tree node.

          +

          Constructors

          Properties

          encryptionKey?: IKey
          env: ResourceEnvironment
          node: Node

          The tree node.

          physicalName: string

          Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

          This value will resolve to one of the following:

          diff --git a/classes/constructs_lambda.GuLambdaFunction.html b/classes/constructs_lambda.GuLambdaFunction.html index 9ea1a31501..ebb4013cf2 100644 --- a/classes/constructs_lambda.GuLambdaFunction.html +++ b/classes/constructs_lambda.GuLambdaFunction.html @@ -21,7 +21,7 @@

          Note that this construct creates a Lambda without an event source. Depending on your use-case, you may wish to consider using a pattern which instantiates a Lambda with an event source e.g. [[GuScheduledLambda]].

          -

          Hierarchy

          Constructors

          Hierarchy

          Constructors

          Properties

          _connections?: Connections

          Actual connections object for this Lambda

          +

          Constructors

          Properties

          _connections?: Connections

          Actual connections object for this Lambda

          May be unset, in which case this Lambda is not configured use in a VPC.

          _functionUrlInvocationGrants: Record<string, Grant>

          Mapping of fucntion URL invocation principals to grants. Used to de-dupe grantInvokeUrl() calls.

          _invocationGrants: Record<string, Grant>

          Mapping of invocation principals to grants. Used to de-dupe grantInvoke() calls.

          @@ -108,10 +108,10 @@ where the user commits to modifying the permisssions on the imported lambda outside CDK.

          _warnIfCurrentVersionCalled: boolean

          Flag to delay adding a warning message until current version is invoked.

          -
          alias?: Alias
          app: string
          architecture: Architecture

          The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

          -
          bucketNamePath: undefined | string
          canCreatePermissions: true = true
          deadLetterQueue?: IQueue

          The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

          +
          alias?: Alias
          app: string
          architecture: Architecture

          The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

          +
          bucketNamePath: undefined | string
          canCreatePermissions: true = true
          deadLetterQueue?: IQueue

          The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

          deadLetterTopic?: ITopic

          The DLQ (as topic) associated with this Lambda Function (this is an optional attribute).

          -
          env: ResourceEnvironment
          fileName: string
          functionArn: string

          ARN of this function

          +
          env: ResourceEnvironment
          fileName: string
          functionArn: string

          ARN of this function

          functionName: string

          Name of this function

          grantPrincipal: IPrincipal

          The principal this Lambda Function is running as

          node: Node

          The tree node.

          @@ -127,7 +127,7 @@
          role?: IRole

          Execution role associated with this function

          runtime: Runtime

          The runtime configured for this lambda.

          stack: Stack
          timeout?: Duration

          The timeout configured for this lambda.

          -
          withoutArtifactUpload: boolean
          withoutFilePrefix: boolean
          _VER_PROPS: {
              [key: string]: boolean;
          }

          Type declaration

          • [key: string]: boolean

          Accessors

          • get connections(): Connections
          • Access the Connections object

            +
          withoutArtifactUpload: boolean
          withoutFilePrefix: boolean
          _VER_PROPS: {
              [key: string]: boolean;
          }

          Type declaration

          • [key: string]: boolean

          Accessors

          • get connections(): Connections
          • Access the Connections object

            Will fail if not a VPC-enabled Lambda Function

            Returns Connections

          • get currentVersion(): Version
          • Returns a lambda.Version which represents the current version of this Lambda function. A new version will be created every time the function's diff --git a/classes/constructs_loadbalancing.GuApplicationListener.html b/classes/constructs_loadbalancing.GuApplicationListener.html index 6bb39907ba..b6012fb9bd 100644 --- a/classes/constructs_loadbalancing.GuApplicationListener.html +++ b/classes/constructs_loadbalancing.GuApplicationListener.html @@ -6,7 +6,7 @@ to reduce the amount of boilerplate needed when configuring your Listener.

            This resource is stateful.

          Hierarchy

          • Mixin<typeof ApplicationListener, this> & ApplicationListener<this>
            • GuApplicationListener

          Constructors

          Hierarchy

          • Mixin<typeof ApplicationListener, this> & ApplicationListener<this>
            • GuApplicationListener

          Constructors

          Properties

          Constructors

          Properties

          connections: Connections

          Manage connections to this ApplicationListener

          +

          Constructors

          Properties

          connections: Connections

          Manage connections to this ApplicationListener

          env: ResourceEnvironment
          idWithApp: string

          The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

          -
          listenerArn: string

          Attribute

          loadBalancer: IApplicationLoadBalancer

          Load balancer this listener is associated with

          +
          listenerArn: string

          Attribute

          loadBalancer: IApplicationLoadBalancer

          Load balancer this listener is associated with

          node: Node

          The tree node.

          physicalName: string

          Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

          diff --git a/classes/constructs_loadbalancing.GuApplicationLoadBalancer.html b/classes/constructs_loadbalancing.GuApplicationLoadBalancer.html index 710fd9dda0..4a43e329a2 100644 --- a/classes/constructs_loadbalancing.GuApplicationLoadBalancer.html +++ b/classes/constructs_loadbalancing.GuApplicationLoadBalancer.html @@ -4,7 +4,7 @@ AWS documentation.

          This resource is stateful.

          Hierarchy

          • Mixin<typeof ApplicationLoadBalancer, this> & ApplicationLoadBalancer<this>
            • GuApplicationLoadBalancer

          Constructors

          Hierarchy

          • Mixin<typeof ApplicationLoadBalancer, this> & ApplicationLoadBalancer<this>
            • GuApplicationLoadBalancer

          Constructors

          Properties

          Constructors

          Properties

          connections: Connections
          env: ResourceEnvironment
          idWithApp: string

          The ID of the construct with the App suffix. +

          Constructors

          Properties

          connections: Connections
          env: ResourceEnvironment
          idWithApp: string

          The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

          -
          ipAddressType?: IpAddressType
          listeners: ApplicationListener[]
          loadBalancerArn: string

          The ARN of this load balancer

          +
          ipAddressType?: IpAddressType
          listeners: ApplicationListener[]
          loadBalancerArn: string

          The ARN of this load balancer

          Example value: arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-internal-load-balancer/50dc6c495c0c9188

          Attribute

          loadBalancerCanonicalHostedZoneId: string

          The canonical hosted zone ID of this load balancer

          Example value: Z2P70J7EXAMPLE

          diff --git a/classes/constructs_loadbalancing.GuApplicationTargetGroup.html b/classes/constructs_loadbalancing.GuApplicationTargetGroup.html index b3be4fa2f1..bb38de7d8d 100644 --- a/classes/constructs_loadbalancing.GuApplicationTargetGroup.html +++ b/classes/constructs_loadbalancing.GuApplicationTargetGroup.html @@ -9,7 +9,7 @@

          This resource is stateful.

          Hierarchy

          • Mixin<typeof ApplicationTargetGroup, this> & ApplicationTargetGroup<this>
            • GuApplicationTargetGroup

          Constructors

          Hierarchy

          • Mixin<typeof ApplicationTargetGroup, this> & ApplicationTargetGroup<this>
            • GuApplicationTargetGroup

          Constructors

          Properties

          defaultPort: number

          Default port configured for members of this target group

          +

          Constructors

          Properties

          defaultPort: number

          Default port configured for members of this target group

          healthCheck: HealthCheck

          Health check for the members of this target group

          idWithApp: string

          The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

          -
          loadBalancerArns: string

          A token representing a list of ARNs of the load balancers that route traffic to this target group

          +
          loadBalancerArns: string

          A token representing a list of ARNs of the load balancers that route traffic to this target group

          loadBalancerAttachedDependencies: DependencyGroup

          Configurable dependable with all resources that lead to load balancer attachment

          node: Node

          The tree node.

          targetGroupArn: string

          The ARN of the target group

          @@ -60,7 +60,7 @@
          targetGroupLoadBalancerArns: string[]

          ARNs of load balancers load balancing to this TargetGroup

          targetGroupName: string

          The name of the target group

          targetType?: TargetType

          The types of the directly registered members of this target group

          -
          DefaultHealthCheck: HealthCheck = ...
          defaultHealthcheckInterval: Duration = ...
          defaultHealthcheckTimeout: Duration = ...

          Accessors

          • get firstLoadBalancerFullName(): string
          • Full name of first load balancer

            +
          DefaultHealthCheck: HealthCheck = ...
          defaultHealthcheckInterval: Duration = ...
          defaultHealthcheckTimeout: Duration = ...

          Accessors

          • get firstLoadBalancerFullName(): string
          • Full name of first load balancer

            Returns string

          • get loadBalancerAttached(): IDependable
          • List of constructs that need to be depended on to ensure the TargetGroup is associated to a load balancer

            Returns IDependable

          • get metrics(): IApplicationTargetGroupMetrics
          • Returns IApplicationTargetGroupMetrics

          Methods

          • Register the given load balancing target as part of this group

            Parameters

            • props: LoadBalancerTargetProps

            Returns void

          • Add a load balancing target to this target group

            diff --git a/classes/constructs_loadbalancing.GuHttpsApplicationListener.html b/classes/constructs_loadbalancing.GuHttpsApplicationListener.html index db3b12d94e..747487ac82 100644 --- a/classes/constructs_loadbalancing.GuHttpsApplicationListener.html +++ b/classes/constructs_loadbalancing.GuHttpsApplicationListener.html @@ -1,7 +1,7 @@ GuHttpsApplicationListener | @guardian/cdk

            Construct which creates a Listener which accepts HTTPS traffic.

            You must pass a [[GuCertificate]] to this Listener via the certificate prop.

            For general details about Listeners, see [[GuApplicationListener]].

            -

            Hierarchy

            • Mixin<typeof ApplicationListener, this> & ApplicationListener<this>
              • GuHttpsApplicationListener

            Constructors

            Hierarchy

            • Mixin<typeof ApplicationListener, this> & ApplicationListener<this>
              • GuHttpsApplicationListener

            Constructors

            Properties

            Constructors

            Properties

            connections: Connections

            Manage connections to this ApplicationListener

            +

            Constructors

            Properties

            connections: Connections

            Manage connections to this ApplicationListener

            env: ResourceEnvironment
            idWithApp: string

            The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

            -
            listenerArn: string

            Attribute

            loadBalancer: IApplicationLoadBalancer

            Load balancer this listener is associated with

            +
            listenerArn: string

            Attribute

            loadBalancer: IApplicationLoadBalancer

            Load balancer this listener is associated with

            node: Node

            The tree node.

            physicalName: string

            Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

            diff --git a/classes/constructs_rds.GuDatabaseInstance.html b/classes/constructs_rds.GuDatabaseInstance.html index 794ac88b8a..3b0aba7c5e 100644 --- a/classes/constructs_rds.GuDatabaseInstance.html +++ b/classes/constructs_rds.GuDatabaseInstance.html @@ -1,4 +1,4 @@ -GuDatabaseInstance | @guardian/cdk

            Hierarchy

            • Mixin<typeof DatabaseInstance, this> & DatabaseInstance<this>
              • GuDatabaseInstance

            Constructors

            constructor +GuDatabaseInstance | @guardian/cdk

            Hierarchy

            • Mixin<typeof DatabaseInstance, this> & DatabaseInstance<this>
              • GuDatabaseInstance

            Constructors

            Properties

            connections: Connections
            dbInstanceEndpointAddress: string
            dbInstanceEndpointPort: string
            enableIamAuthentication?: boolean
            engine?: IInstanceEngine
            env: ResourceEnvironment
            idWithApp: string

            The ID of the construct with the App suffix. +

            Constructors

            Properties

            connections: Connections
            dbInstanceEndpointAddress: string
            dbInstanceEndpointPort: string
            enableIamAuthentication?: boolean
            engine?: IInstanceEngine
            env: ResourceEnvironment
            idWithApp: string

            The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

            -
            instanceEndpoint: Endpoint
            instanceIdentifier: string
            instanceResourceId?: string
            instanceType: InstanceType
            newCfnProps: CfnDBInstanceProps
            node: Node

            The tree node.

            +
            instanceEndpoint: Endpoint
            instanceIdentifier: string
            instanceResourceId?: string
            instanceType: InstanceType
            newCfnProps: CfnDBInstanceProps
            node: Node

            The tree node.

            physicalName: string

            Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

            This value will resolve to one of the following:

            diff --git a/classes/constructs_s3.GuS3Bucket.html b/classes/constructs_s3.GuS3Bucket.html index cfa8ea5784..285d483efb 100644 --- a/classes/constructs_s3.GuS3Bucket.html +++ b/classes/constructs_s3.GuS3Bucket.html @@ -1,5 +1,5 @@ GuS3Bucket | @guardian/cdk

            A construct to create a bucket with a "retain" policy to prevent it from being deleted. It will be orphaned instead.

            -

            Hierarchy

            • Mixin<typeof Bucket, this> & Bucket<this>
              • GuS3Bucket

            Constructors

            Hierarchy

            • Mixin<typeof Bucket, this> & Bucket<this>
              • GuS3Bucket

            Constructors

            Properties

            autoCreatePolicy: boolean
            bucketArn: string
            bucketDomainName: string
            bucketDualStackDomainName: string
            bucketName: string
            bucketRegionalDomainName: string
            bucketWebsiteDomainName: string
            bucketWebsiteUrl: string
            disallowPublicAccess?: boolean
            encryptionKey?: IKey
            env: ResourceEnvironment
            idWithApp: string

            The ID of the construct with the App suffix. +

            Constructors

            Properties

            autoCreatePolicy: boolean
            bucketArn: string
            bucketDomainName: string
            bucketDualStackDomainName: string
            bucketName: string
            bucketRegionalDomainName: string
            bucketWebsiteDomainName: string
            bucketWebsiteUrl: string
            disallowPublicAccess?: boolean
            encryptionKey?: IKey
            env: ResourceEnvironment
            idWithApp: string

            The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

            -
            isWebsite?: boolean
            node: Node

            The tree node.

            +
            isWebsite?: boolean
            node: Node

            The tree node.

            notificationsHandlerRole?: IRole
            objectOwnership?: ObjectOwnership
            physicalName: string

            Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

            This value will resolve to one of the following:

            diff --git a/classes/constructs_ses.GuEmailIdentity.html b/classes/constructs_ses.GuEmailIdentity.html index 7e22665543..d8a3eb1594 100644 --- a/classes/constructs_ses.GuEmailIdentity.html +++ b/classes/constructs_ses.GuEmailIdentity.html @@ -6,7 +6,7 @@

          Example

          new GuEmailIdentity(stack, "MyEmailIdentity", {
          domainName: "my-service.gutools.co.uk",
          app: "test",
          });
          -

        Hierarchy

        • Mixin<typeof EmailIdentity, this> & EmailIdentity<this>
          • GuEmailIdentity

        Constructors

        Hierarchy

        • Mixin<typeof EmailIdentity, this> & EmailIdentity<this>
          • GuEmailIdentity

        Constructors

        Properties

        Constructors

        Properties

        dkimDnsTokenName1: string

        The host name for the first token that you have to add to the +

        Constructors

        Properties

        dkimDnsTokenName1: string

        The host name for the first token that you have to add to the DNS configurationfor your domain

        Attribute

        dkimDnsTokenName2: string

        The host name for the second token that you have to add to the DNS configuration for your domain

        @@ -46,7 +46,7 @@

        Example

        new

        Attribute

        dkimRecords: DkimRecord[]

        DKIM records for this identity

        emailIdentityName: string
        env: ResourceEnvironment
        idWithApp: string

        The ID of the construct with the App suffix. This should be used in place of id when trying to reference the construct.

        -
        node: Node

        The tree node.

        +
        node: Node

        The tree node.

        physicalName: string

        Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

        This value will resolve to one of the following:

        @@ -56,7 +56,7 @@

        Example

        newa concrete name generated automatically during synthesis, in
         cross-environment scenarios.
      -
      stack: Stack

      Accessors

      Methods

      • Internal

        Called when this resource is referenced across environments +

      stack: Stack

      Accessors

      Methods

      • Internal

        Called when this resource is referenced across environments (account/region) to order to request that a physical name will be generated for this resource during synthesis, so the resource can be referenced through its absolute name/arn.

        diff --git a/classes/constructs_stack_set.GuStackSet.html b/classes/constructs_stack_set.GuStackSet.html index e576924e46..08dab52990 100644 --- a/classes/constructs_stack_set.GuStackSet.html +++ b/classes/constructs_stack_set.GuStackSet.html @@ -8,7 +8,7 @@
        Resources:
        AccountAlarmResourcesStackSet:
        Type: AWS::CloudFormation::StackSet
        Properties:
        PermissionModel: SERVICE_MANAGED
        StackSetName: centralised-alarms
        AutoDeployment:
        Enabled: true
        RetainStacksOnAccountRemoval: false
        Description: Provisioning of standard account alerting resources
        Parameters: []
        StackInstancesGroup:
        - DeploymentTargets:
        OrganizationalUnitIds:
        - o-abcde12345
        Regions:
        - Ref: AWS::Region
        Tags:
        - Key: gu:cdk:version
        Value: TEST
        - Key: gu:repo
        Value: guardian/cdk
        - Key: Stack
        Value: alarms
        - Key: Stage
        Value: INFRA
        TemplateBody: |-
        {
        "Resources": {
        "topicforalerts57330FBE": {
        "Type": "AWS::SNS::Topic",
        "Properties": {
        "Tags": [
        {
        "Key": "gu:cdk:version",
        "Value": "TEST"
        },
        {
        "Key": "gu:repo",
        "Value": "guardian/cdk"
        },
        {
        "Key": "Stack",
        "Value": "alarms"
        },
        {
        "Key": "Stage",
        "Value": "INFRA"
        }
        ]
        }
        }
        }
        }

      Hierarchy

      • CfnStackSet
        • GuStackSet

      Constructors

      Hierarchy

      • CfnStackSet
        • GuStackSet

      Constructors

      Properties

      _cfnProperties: any

      AWS CloudFormation resource properties.

      +

      Constructors

      Properties

      _cfnProperties: any

      AWS CloudFormation resource properties.

      This object is returned via cfnProperties

      administrationRoleArn?: string

      The Amazon Resource Number (ARN) of the IAM role to use to create this stack set.

      attrStackSetId: string

      The ID of the stack that you're creating.

      diff --git a/classes/constructs_vpc.GuVpc.html b/classes/constructs_vpc.GuVpc.html index fbbe321f88..7226f07459 100644 --- a/classes/constructs_vpc.GuVpc.html +++ b/classes/constructs_vpc.GuVpc.html @@ -29,7 +29,7 @@ https://github.com/guardian/recommendations/blob/main/AWS.md#vpc

      For more information on VPCs and AWS see: https://docs.aws.amazon.com/vpc/latest/userguide/VPC_Subnets.html.

      -

      Hierarchy

      • Vpc
        • GuVpc

      Constructors

      Hierarchy

      • Vpc
        • GuVpc

      Constructors

      Properties

      _vpnGatewayId?: string

      Mutable private field for the vpnGatewayId

      +

      Constructors

      Properties

      _vpnGatewayId?: string

      Mutable private field for the vpnGatewayId

      availabilityZones: string[]

      AZs for this VPC

      dnsHostnamesEnabled: boolean

      Indicates if instances launched in this VPC will have public DNS hostnames.

      dnsSupportEnabled: boolean

      Indicates if DNS support is enabled for this VPC.

      @@ -183,4 +183,4 @@ This means consuming stacks do NOT have to commit a cdk.context.json file when using this construct in eu-west-1.

      Parameters

      Returns void

      Throws

      if the account ID has not been explicitly set on the parent GuStack

      -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/classes/experimental_patterns.GuKinesisLambdaExperimental.html b/classes/experimental_patterns.GuKinesisLambdaExperimental.html index 9ce5befdd7..37346c1cf8 100644 --- a/classes/experimental_patterns.GuKinesisLambdaExperimental.html +++ b/classes/experimental_patterns.GuKinesisLambdaExperimental.html @@ -6,7 +6,7 @@

    The Kinesis stream is stateful, and is accessible via kinesisStream.

    See

    https://github.com/guardian/cdk/blob/main/docs/stateful-resources.md

    This pattern is in early development. The API is likely to change in future releases.

    -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    +

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    May be unset, in which case this Lambda is not configured use in a VPC.

    _functionUrlInvocationGrants: Record<string, Grant>

    Mapping of fucntion URL invocation principals to grants. Used to de-dupe grantInvokeUrl() calls.

    _invocationGrants: Record<string, Grant>

    Mapping of invocation principals to grants. Used to de-dupe grantInvoke() calls.

    @@ -94,13 +94,13 @@ where the user commits to modifying the permisssions on the imported lambda outside CDK.

    _warnIfCurrentVersionCalled: boolean

    Flag to delay adding a warning message until current version is invoked.

    -
    alias?: Alias
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    -
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    +
    alias?: Alias
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    +
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    deadLetterTopic?: ITopic

    The DLQ (as topic) associated with this Lambda Function (this is an optional attribute).

    -
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    +
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    functionName: string

    Name of this function

    grantPrincipal: IPrincipal

    The principal this Lambda Function is running as

    -
    kinesisStream: IStream
    node: Node

    The tree node.

    +
    kinesisStream: IStream
    node: Node

    The tree node.

    permissionsNode: Node
    physicalName: string

    Returns a string-encoded token that resolves to the physical name that should be passed to the CloudFormation resource.

    This value will resolve to one of the following:

    @@ -113,7 +113,7 @@
    role?: IRole

    Execution role associated with this function

    runtime: Runtime

    The runtime configured for this lambda.

    stack: Stack
    timeout?: Duration

    The timeout configured for this lambda.

    -
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      +
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      Will fail if not a VPC-enabled Lambda Function

      Returns Connections

    • get currentVersion(): Version
    • Returns a lambda.Version which represents the current version of this Lambda function. A new version will be created every time the function's diff --git a/classes/experimental_patterns.GuSnsLambdaExperimental.html b/classes/experimental_patterns.GuSnsLambdaExperimental.html index 9a65a194c7..e6c744e9f7 100644 --- a/classes/experimental_patterns.GuSnsLambdaExperimental.html +++ b/classes/experimental_patterns.GuSnsLambdaExperimental.html @@ -6,7 +6,7 @@

      The SNS topic is stateful, and is accessible via snsTopic.

      See

      https://github.com/guardian/cdk/blob/main/docs/stateful-resources.md

      This pattern is in early development. The API is likely to change in future releases.

      -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    +

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    May be unset, in which case this Lambda is not configured use in a VPC.

    _functionUrlInvocationGrants: Record<string, Grant>

    Mapping of fucntion URL invocation principals to grants. Used to de-dupe grantInvokeUrl() calls.

    _invocationGrants: Record<string, Grant>

    Mapping of invocation principals to grants. Used to de-dupe grantInvoke() calls.

    @@ -94,10 +94,10 @@ where the user commits to modifying the permisssions on the imported lambda outside CDK.

    _warnIfCurrentVersionCalled: boolean

    Flag to delay adding a warning message until current version is invoked.

    -
    alias?: Alias
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    -
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    +
    alias?: Alias
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    +
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    deadLetterTopic?: ITopic

    The DLQ (as topic) associated with this Lambda Function (this is an optional attribute).

    -
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    +
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    functionName: string

    Name of this function

    grantPrincipal: IPrincipal

    The principal this Lambda Function is running as

    node: Node

    The tree node.

    @@ -112,8 +112,8 @@
    role?: IRole

    Execution role associated with this function

    runtime: Runtime

    The runtime configured for this lambda.

    -
    snsTopic: ITopic
    stack: Stack
    timeout?: Duration

    The timeout configured for this lambda.

    -
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      +
    snsTopic: ITopic
    stack: Stack
    timeout?: Duration

    The timeout configured for this lambda.

    +
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      Will fail if not a VPC-enabled Lambda Function

      Returns Connections

    • get currentVersion(): Version
    • Returns a lambda.Version which represents the current version of this Lambda function. A new version will be created every time the function's diff --git a/classes/patterns.GuApiGatewayWithLambdaByPath.html b/classes/patterns.GuApiGatewayWithLambdaByPath.html index 816bf262dd..4e9ea8f0f5 100644 --- a/classes/patterns.GuApiGatewayWithLambdaByPath.html +++ b/classes/patterns.GuApiGatewayWithLambdaByPath.html @@ -8,12 +8,12 @@

      For all API configuration options, see [[GuApiGatewayWithLambdaByPathProps]].

      For details on configuring the individual Lambda functions, see [[GuLambdaFunction]].

      -

    Hierarchy

    • Construct
      • GuApiGatewayWithLambdaByPath

    Constructors

    Hierarchy

    • Construct
      • GuApiGatewayWithLambdaByPath

    Constructors

    Properties

    Methods

    Constructors

    Properties

    api: RestApi
    node: Node

    The tree node.

    +

    Constructors

    Properties

    api: RestApi
    node: Node

    The tree node.

    Methods

    • Returns a string representation of this construct.

      Returns string

    • Checks if x is a construct.

      Use this method instead of instanceof to properly detect Construct diff --git a/classes/patterns.GuApiLambda.html b/classes/patterns.GuApiLambda.html index b31efeef49..22f43ed0b3 100644 --- a/classes/patterns.GuApiLambda.html +++ b/classes/patterns.GuApiLambda.html @@ -8,7 +8,7 @@

      Example usage:

      new GuApiLambda(stack, "my-lambda", {
      fileName: "my-app.zip",
      handler: "handler.ts",
      runtime: Runtime.NODEJS_14_X,
      monitoringConfiguration: {
      http5xxAlarm: { tolerated5xxPercentage: 5 },
      snsTopicName: "alerts-topic",
      },
      app: "my-app",
      api: {
      id: "my-api",
      description: "...",
      },
      });
      -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    +

    Constructors

    Properties

    _connections?: Connections

    Actual connections object for this Lambda

    May be unset, in which case this Lambda is not configured use in a VPC.

    _functionUrlInvocationGrants: Record<string, Grant>

    Mapping of fucntion URL invocation principals to grants. Used to de-dupe grantInvokeUrl() calls.

    _invocationGrants: Record<string, Grant>

    Mapping of invocation principals to grants. Used to de-dupe grantInvoke() calls.

    @@ -96,10 +96,10 @@ where the user commits to modifying the permisssions on the imported lambda outside CDK.

    _warnIfCurrentVersionCalled: boolean

    Flag to delay adding a warning message until current version is invoked.

    -
    alias?: Alias
    api: LambdaRestApi
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    -
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    +
    alias?: Alias
    api: LambdaRestApi
    app: string
    architecture: Architecture

    The architecture of this Lambda Function (this is an optional attribute and defaults to X86_64).

    +
    bucketNamePath: undefined | string
    canCreatePermissions: true = true
    deadLetterQueue?: IQueue

    The DLQ (as queue) associated with this Lambda Function (this is an optional attribute).

    deadLetterTopic?: ITopic

    The DLQ (as topic) associated with this Lambda Function (this is an optional attribute).

    -
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    +
    env: ResourceEnvironment
    fileName: string
    functionArn: string

    ARN of this function

    functionName: string

    Name of this function

    grantPrincipal: IPrincipal

    The principal this Lambda Function is running as

    node: Node

    The tree node.

    @@ -115,7 +115,7 @@
    role?: IRole

    Execution role associated with this function

    runtime: Runtime

    The runtime configured for this lambda.

    stack: Stack
    timeout?: Duration

    The timeout configured for this lambda.

    -
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      +
    withoutArtifactUpload: boolean
    withoutFilePrefix: boolean
    _VER_PROPS: {
        [key: string]: boolean;
    }

    Type declaration

    • [key: string]: boolean

    Accessors

    • get connections(): Connections
    • Access the Connections object

      Will fail if not a VPC-enabled Lambda Function

      Returns Connections

    • get currentVersion(): Version
    • Returns a lambda.Version which represents the current version of this Lambda function. A new version will be created every time the function's diff --git a/classes/patterns.GuEc2App.html b/classes/patterns.GuEc2App.html index f28a3cb0c2..79bf874450 100644 --- a/classes/patterns.GuEc2App.html +++ b/classes/patterns.GuEc2App.html @@ -2,7 +2,7 @@ behind a load balancer. For convenience, you may wish to use [[GuPlayApp]] or [[GuNodeApp]], which extend this class.

      See props for further details.

      -

    Hierarchy

    Constructors

    Hierarchy

    Constructors

    Properties

    Methods

    Constructors

    Properties

    autoScalingGroup: GuAutoScalingGroup
    certificate?: GuCertificate
    node: Node

    The tree node.

    -
    vpc: IVpc

    Methods

    • Returns a string representation of this construct.

      +

    Constructors

    Properties

    autoScalingGroup: GuAutoScalingGroup
    certificate?: GuCertificate
    node: Node

    The tree node.

    +
    vpc: IVpc

    Methods

    • Returns a string representation of this construct.

      Returns string

    withoutImdsv2?: boolean

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_autoscaling.GuUserDataProps.html b/interfaces/constructs_autoscaling.GuUserDataProps.html index 3ead32697f..af3ce609bd 100644 --- a/interfaces/constructs_autoscaling.GuUserDataProps.html +++ b/interfaces/constructs_autoscaling.GuUserDataProps.html @@ -1,3 +1,3 @@ -GuUserDataProps | @guardian/cdk
    interface GuUserDataProps {
        configuration?: GuPrivateS3ConfigurationProps;
        distributable: GuDistributableForEc2;
    }

    Properties

    configuration? +GuUserDataProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    distributable: GuDistributableForEc2

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_cloudwatch.GuAlarmProps.html b/interfaces/constructs_cloudwatch.GuAlarmProps.html index 686fc273a4..0fd360148a 100644 --- a/interfaces/constructs_cloudwatch.GuAlarmProps.html +++ b/interfaces/constructs_cloudwatch.GuAlarmProps.html @@ -1,4 +1,4 @@ -GuAlarmProps | @guardian/cdk
    interface GuAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        app: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        evaluationPeriods: number;
        metric: IMetric;
        okAction?: boolean;
        snsTopicName: string;
        threshold: number;
        treatMissingData?: TreatMissingData;
    }

    Hierarchy

    Properties

    actionsEnabled? +GuAlarmProps | @guardian/cdk
    interface GuAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        app: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        evaluationPeriods: number;
        metric: IMetric;
        okAction?: boolean;
        snsTopicName: string;
        threshold: number;
        treatMissingData?: TreatMissingData;
    }

    Hierarchy

    Properties

    alarmName?: string

    Name of the alarm

    Default

    Automatically generated name
     
    -
    app: string
    comparisonOperator?: ComparisonOperator

    Comparison to use to check if metric is breaching

    +
    app: string
    comparisonOperator?: ComparisonOperator

    Comparison to use to check if metric is breaching

    Default

    GreaterThanOrEqualToThreshold
     
    datapointsToAlarm?: number

    The number of datapoints that must be breaching to trigger the alarm. This is used only if you are setting an "M @@ -36,7 +36,7 @@

    See

    metric: IMetric

    The metric to add the alarm on

    Metric objects can be obtained from most resources, or you can construct custom Metric objects by instantiating one.

    -
    okAction?: boolean
    snsTopicName: string
    threshold: number

    The value against which the specified statistic is compared.

    +
    okAction?: boolean
    snsTopicName: string
    threshold: number

    The value against which the specified statistic is compared.

    treatMissingData?: TreatMissingData

    Sets how this alarm is to handle missing data points.

    Default

    TreatMissingData.Missing
     
    diff --git a/interfaces/constructs_cloudwatch.GuLambdaErrorPercentageMonitoringProps.html b/interfaces/constructs_cloudwatch.GuLambdaErrorPercentageMonitoringProps.html index ceb6c42cfe..83e3276fdc 100644 --- a/interfaces/constructs_cloudwatch.GuLambdaErrorPercentageMonitoringProps.html +++ b/interfaces/constructs_cloudwatch.GuLambdaErrorPercentageMonitoringProps.html @@ -1,4 +1,4 @@ -GuLambdaErrorPercentageMonitoringProps | @guardian/cdk

    Interface GuLambdaErrorPercentageMonitoringProps

    interface GuLambdaErrorPercentageMonitoringProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        lengthOfEvaluationPeriod?: Duration;
        noMonitoring?: false;
        numberOfEvaluationPeriodsAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        snsTopicName: string;
        toleratedErrorPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "metric" | "threshold" | "comparisonOperator" | "evaluationPeriods" | "treatMissingData" | "app">
      • GuLambdaErrorPercentageMonitoringProps

    Properties

    actionsEnabled? +GuLambdaErrorPercentageMonitoringProps | @guardian/cdk

    Interface GuLambdaErrorPercentageMonitoringProps

    interface GuLambdaErrorPercentageMonitoringProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        lengthOfEvaluationPeriod?: Duration;
        noMonitoring?: false;
        numberOfEvaluationPeriodsAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        snsTopicName: string;
        toleratedErrorPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "metric" | "threshold" | "comparisonOperator" | "evaluationPeriods" | "treatMissingData" | "app">
      • GuLambdaErrorPercentageMonitoringProps

    Properties

    lengthOfEvaluationPeriod?: Duration
    noMonitoring?: false
    numberOfEvaluationPeriodsAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    snsTopicName: string
    toleratedErrorPercentage: number

    Generated using TypeDoc

    \ No newline at end of file +
    lengthOfEvaluationPeriod?: Duration
    noMonitoring?: false
    numberOfEvaluationPeriodsAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    snsTopicName: string
    toleratedErrorPercentage: number

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_cloudwatch.GuLambdaThrottlingMonitoringProps.html b/interfaces/constructs_cloudwatch.GuLambdaThrottlingMonitoringProps.html index c2b85f9163..c92a17c479 100644 --- a/interfaces/constructs_cloudwatch.GuLambdaThrottlingMonitoringProps.html +++ b/interfaces/constructs_cloudwatch.GuLambdaThrottlingMonitoringProps.html @@ -1,4 +1,4 @@ -GuLambdaThrottlingMonitoringProps | @guardian/cdk
    interface GuLambdaThrottlingMonitoringProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        noMonitoring?: false;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        snsTopicName: string;
        toleratedThrottlingCount?: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "metric" | "threshold" | "comparisonOperator" | "evaluationPeriods" | "treatMissingData" | "app">
      • GuLambdaThrottlingMonitoringProps

    Properties

    actionsEnabled? +GuLambdaThrottlingMonitoringProps | @guardian/cdk
    interface GuLambdaThrottlingMonitoringProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        noMonitoring?: false;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        snsTopicName: string;
        toleratedThrottlingCount?: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "metric" | "threshold" | "comparisonOperator" | "evaluationPeriods" | "treatMissingData" | "app">
      • GuLambdaThrottlingMonitoringProps

    Properties

    noMonitoring?: false
    numberOfMinutesAboveThresholdBeforeAlarm?: number

    Evaluation period in minutes for alarm.

    +
    noMonitoring?: false
    numberOfMinutesAboveThresholdBeforeAlarm?: number

    Evaluation period in minutes for alarm.

    Default Value

    1
     
    -
    okAction?: boolean
    snsTopicName: string
    toleratedThrottlingCount?: number

    Sum of thottled invocations above which to alarm.

    +
    okAction?: boolean
    snsTopicName: string
    toleratedThrottlingCount?: number

    Sum of thottled invocations above which to alarm.

    Default Value

    0
     
    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_cloudwatch.Http4xxAlarmProps.html b/interfaces/constructs_cloudwatch.Http4xxAlarmProps.html index e3cc95906d..e1d95d79d0 100644 --- a/interfaces/constructs_cloudwatch.Http4xxAlarmProps.html +++ b/interfaces/constructs_cloudwatch.Http4xxAlarmProps.html @@ -1,4 +1,4 @@ -Http4xxAlarmProps | @guardian/cdk
    interface Http4xxAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        tolerated4xxPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "snsTopicName" | "evaluationPeriods" | "metric" | "period" | "threshold" | "treatMissingData" | "app">
      • Http4xxAlarmProps

    Properties

    actionsEnabled? +Http4xxAlarmProps | @guardian/cdk
    interface Http4xxAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        tolerated4xxPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "snsTopicName" | "evaluationPeriods" | "metric" | "period" | "threshold" | "treatMissingData" | "app">
      • Http4xxAlarmProps

    Properties

    numberOfMinutesAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    tolerated4xxPercentage: number

    Generated using TypeDoc

    \ No newline at end of file +
    numberOfMinutesAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    tolerated4xxPercentage: number

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_cloudwatch.Http5xxAlarmProps.html b/interfaces/constructs_cloudwatch.Http5xxAlarmProps.html index af201fee91..592530ef0b 100644 --- a/interfaces/constructs_cloudwatch.Http5xxAlarmProps.html +++ b/interfaces/constructs_cloudwatch.Http5xxAlarmProps.html @@ -1,4 +1,4 @@ -Http5xxAlarmProps | @guardian/cdk
    interface Http5xxAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        tolerated5xxPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "snsTopicName" | "evaluationPeriods" | "metric" | "period" | "threshold" | "treatMissingData" | "app">
      • Http5xxAlarmProps

    Properties

    actionsEnabled? +Http5xxAlarmProps | @guardian/cdk
    interface Http5xxAlarmProps {
        actionsEnabled?: boolean;
        alarmDescription?: string;
        alarmName?: string;
        comparisonOperator?: ComparisonOperator;
        datapointsToAlarm?: number;
        evaluateLowSampleCountPercentile?: string;
        numberOfMinutesAboveThresholdBeforeAlarm?: number;
        okAction?: boolean;
        tolerated5xxPercentage: number;
    }

    Hierarchy

    • Omit<GuAlarmProps, "snsTopicName" | "evaluationPeriods" | "metric" | "period" | "threshold" | "treatMissingData" | "app">
      • Http5xxAlarmProps

    Properties

    numberOfMinutesAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    tolerated5xxPercentage: number

    Generated using TypeDoc

    \ No newline at end of file +
    numberOfMinutesAboveThresholdBeforeAlarm?: number
    okAction?: boolean
    tolerated5xxPercentage: number

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_cloudwatch.NoMonitoring.html b/interfaces/constructs_cloudwatch.NoMonitoring.html index 1bed74a3fb..06a927820a 100644 --- a/interfaces/constructs_cloudwatch.NoMonitoring.html +++ b/interfaces/constructs_cloudwatch.NoMonitoring.html @@ -1,2 +1,2 @@ -NoMonitoring | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +NoMonitoring | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_core.AppIdentity.html b/interfaces/constructs_core.AppIdentity.html index 885a9d289f..38fabe3f92 100644 --- a/interfaces/constructs_core.AppIdentity.html +++ b/interfaces/constructs_core.AppIdentity.html @@ -1,2 +1,2 @@ -AppIdentity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +AppIdentity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_core.GuParameterProps.html b/interfaces/constructs_core.GuParameterProps.html index 1ae1d86d29..1d0fd95202 100644 --- a/interfaces/constructs_core.GuParameterProps.html +++ b/interfaces/constructs_core.GuParameterProps.html @@ -1,4 +1,4 @@ -GuParameterProps | @guardian/cdk
    interface GuParameterProps {
        allowedPattern?: string;
        allowedValues?: string[];
        constraintDescription?: string;
        default?: any;
        description?: string;
        fromSSM?: boolean;
        maxLength?: number;
        maxValue?: number;
        minLength?: number;
        minValue?: number;
        noEcho?: boolean;
        type?: string;
    }

    Hierarchy

    • CfnParameterProps
      • GuParameterProps

    Properties

    allowedPattern? +GuParameterProps | @guardian/cdk
    interface GuParameterProps {
        allowedPattern?: string;
        allowedValues?: string[];
        constraintDescription?: string;
        default?: any;
        description?: string;
        fromSSM?: boolean;
        maxLength?: number;
        maxValue?: number;
        minLength?: number;
        minValue?: number;
        noEcho?: boolean;
        type?: string;
    }

    Hierarchy

    • CfnParameterProps
      • GuParameterProps

    Properties

    description?: string

    A string of up to 4000 characters that describes the parameter.

    Default

    - No description for the parameter.
     
    -
    fromSSM?: boolean
    maxLength?: number

    An integer value that determines the largest number of characters you want to allow for String types.

    +
    fromSSM?: boolean
    maxLength?: number

    An integer value that determines the largest number of characters you want to allow for String types.

    Default

    - None.
     
    maxValue?: number

    A numeric value that determines the largest numeric value you want to allow for Number types.

    diff --git a/interfaces/constructs_core.GuStackProps.html b/interfaces/constructs_core.GuStackProps.html index ed6477615d..2bf81ed565 100644 --- a/interfaces/constructs_core.GuStackProps.html +++ b/interfaces/constructs_core.GuStackProps.html @@ -1,4 +1,4 @@ -GuStackProps | @guardian/cdk
    interface GuStackProps {
        analyticsReporting?: boolean;
        app?: string;
        cloudFormationStackName?: string;
        crossRegionReferences?: boolean;
        description?: string;
        env?: Environment;
        permissionsBoundary?: PermissionsBoundary;
        stack: string;
        stage: string;
        suppressTemplateIndentation?: boolean;
        synthesizer?: IStackSynthesizer;
        tags?: {
            [key: string]: string;
        };
        terminationProtection?: boolean;
        withBackup?: boolean;
        withoutMetadata?: boolean;
        withoutTags?: boolean;
    }

    Hierarchy

    • Omit<StackProps, "stackName">
      • GuStackProps

    Properties

    analyticsReporting? +GuStackProps | @guardian/cdk
    interface GuStackProps {
        analyticsReporting?: boolean;
        app?: string;
        cloudFormationStackName?: string;
        crossRegionReferences?: boolean;
        description?: string;
        env?: Environment;
        permissionsBoundary?: PermissionsBoundary;
        stack: string;
        stage: string;
        suppressTemplateIndentation?: boolean;
        synthesizer?: IStackSynthesizer;
        tags?: {
            [key: string]: string;
        };
        terminationProtection?: boolean;
        withBackup?: boolean;
        withoutMetadata?: boolean;
        withoutTags?: boolean;
    }

    Hierarchy

    • Omit<StackProps, "stackName">
      • GuStackProps

    Properties

    Default

    analyticsReporting setting of containing App, or value of 'aws:cdk:version-reporting' context key

    app?: string

    Optional name of the app. If defined, all resources will have an App tag.

    -
    cloudFormationStackName?: string

    The AWS CloudFormation stack name (as shown in the AWS CloudFormation UI).

    +
    cloudFormationStackName?: string

    The AWS CloudFormation stack name (as shown in the AWS CloudFormation UI).

    Default Value

    the GU_CFN_STACK_NAME environment variable

    -
    crossRegionReferences?: boolean

    Enable this flag to allow native cross region stack references.

    +
    crossRegionReferences?: boolean

    Enable this flag to allow native cross region stack references.

    Enabling this will create a CloudFormation custom resource in both the producing stack and consuming stack in order to perform the export/import

    This feature is currently experimental

    @@ -58,7 +58,7 @@

    Default

    stack: string

    The Guardian stack being used (as defined in your riff-raff.yaml). This will be applied as a tag to all of your resources.

    -
    stage: string
    suppressTemplateIndentation?: boolean

    Enable this flag to suppress indentation in generated +

    stage: string
    suppressTemplateIndentation?: boolean

    Enable this flag to suppress indentation in generated CloudFormation templates.

    If not specified, the value of the @aws-cdk/core:suppressTemplateIndentation context key will be used. If that is not specified, then the @@ -88,9 +88,9 @@

    Default

    Default

    false - backups are not enabled
     

    See

    https://github.com/guardian/aws-backup

    -
    withoutMetadata?: boolean

    Set to disable CDK metadata. Only for internal use (for disabling for some +

    withoutMetadata?: boolean

    Set to disable CDK metadata. Only for internal use (for disabling for some snapshot tests). We rely on tracking data to prioritise future work so please do not override this.

    -
    withoutTags?: boolean

    Set this to true to stop the GuStack from tagging all of your AWS resources. +

    withoutTags?: boolean

    Set this to true to stop the GuStack from tagging all of your AWS resources. This should only be turned on as part of an initial migration from CloudFormation.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_core.GuStaticLogicalId.html b/interfaces/constructs_core.GuStaticLogicalId.html index e5a607d173..7c59e10aa0 100644 --- a/interfaces/constructs_core.GuStaticLogicalId.html +++ b/interfaces/constructs_core.GuStaticLogicalId.html @@ -1,5 +1,5 @@ -GuStaticLogicalId | @guardian/cdk
    interface GuStaticLogicalId {
        logicalId: string;
        reason: string;
    }

    Properties

    logicalId +GuStaticLogicalId | @guardian/cdk
    interface GuStaticLogicalId {
        logicalId: string;
        reason: string;
    }

    Properties

    Properties

    logicalId: string

    The logical ID to use in the synthesised template for this resource.

    -
    reason: string

    A short description to help developers understand why this resource's logical ID is being set.

    -

    Generated using TypeDoc

    \ No newline at end of file +
    reason: string

    A short description to help developers understand why this resource's logical ID is being set.

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_core.Identity.html b/interfaces/constructs_core.Identity.html index 339c345448..57f267a0d0 100644 --- a/interfaces/constructs_core.Identity.html +++ b/interfaces/constructs_core.Identity.html @@ -1,4 +1,4 @@ -Identity | @guardian/cdk
    interface Identity {
        app: string;
        stack: string;
        stage: string;
    }

    Hierarchy

    Properties

    app +Identity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    app: string
    stack: string
    stage: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_core.StackStageIdentity.html b/interfaces/constructs_core.StackStageIdentity.html index b4df1e0670..7c207e1339 100644 --- a/interfaces/constructs_core.StackStageIdentity.html +++ b/interfaces/constructs_core.StackStageIdentity.html @@ -1,3 +1,3 @@ -StackStageIdentity | @guardian/cdk
    interface StackStageIdentity {
        stack: string;
        stage: string;
    }

    Hierarchy

    Implemented by

    Properties

    stack +StackStageIdentity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    stack: string
    stage: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_dns.GuCnameProps.html b/interfaces/constructs_dns.GuCnameProps.html index a81e1d1471..f2693a12d8 100644 --- a/interfaces/constructs_dns.GuCnameProps.html +++ b/interfaces/constructs_dns.GuCnameProps.html @@ -1,13 +1,13 @@ -GuCnameProps | @guardian/cdk
    interface GuCnameProps {
        app: string;
        domainName: string;
        hostedZoneId?: string;
        resourceRecord: string;
        ttl: Duration;
    }

    Hierarchy

    Properties

    app +GuCnameProps | @guardian/cdk
    interface GuCnameProps {
        app: string;
        domainName: string;
        hostedZoneId?: string;
        resourceRecord: string;
        ttl: Duration;
    }

    Hierarchy

    Properties

    app: string
    domainName: string

    The Fully Qualified Domain Name.

    +

    Properties

    app: string
    domainName: string

    The Fully Qualified Domain Name.

    Example

    "riff-raff.gutools.co.uk"
     
    -
    hostedZoneId?: string

    Route53 Zone ID.

    +
    hostedZoneId?: string

    Route53 Zone ID.

    To be provided only if the zone for domainName is managed by Route53.

    -
    resourceRecord: string

    The record your CNAME should point to, for example your Load Balancer DNS name

    -
    ttl: Duration

    The time to live for the DNS record

    -

    Generated using TypeDoc

    \ No newline at end of file +
    resourceRecord: string

    The record your CNAME should point to, for example your Load Balancer DNS name

    +
    ttl: Duration

    The time to live for the DNS record

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_dns.GuDnsRecordSetProps.html b/interfaces/constructs_dns.GuDnsRecordSetProps.html index a9d1c7152c..6f1a253870 100644 --- a/interfaces/constructs_dns.GuDnsRecordSetProps.html +++ b/interfaces/constructs_dns.GuDnsRecordSetProps.html @@ -1,5 +1,5 @@ -GuDnsRecordSetProps | @guardian/cdk
    interface GuDnsRecordSetProps {
        name: string;
        recordType: CNAME;
        resourceRecords: string[];
        ttl: Duration;
    }

    Properties

    name +GuDnsRecordSetProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    name: string
    recordType: CNAME
    resourceRecords: string[]
    ttl: Duration

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_ec2.GuBaseSecurityGroupProps.html b/interfaces/constructs_ec2.GuBaseSecurityGroupProps.html index 5d4469ed97..dfe64b269a 100644 --- a/interfaces/constructs_ec2.GuBaseSecurityGroupProps.html +++ b/interfaces/constructs_ec2.GuBaseSecurityGroupProps.html @@ -1,4 +1,4 @@ -GuBaseSecurityGroupProps | @guardian/cdk

    Interface GuBaseSecurityGroupProps

    interface GuBaseSecurityGroupProps {
        allowAllIpv6Outbound?: boolean;
        allowAllOutbound?: boolean;
        description?: string;
        disableInlineRules?: boolean;
        egresses?: SecurityGroupAccessRule[];
        ingresses?: SecurityGroupAccessRule[];
        securityGroupName?: string;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    allowAllIpv6Outbound? +GuBaseSecurityGroupProps | @guardian/cdk

    Interface GuBaseSecurityGroupProps

    interface GuBaseSecurityGroupProps {
        allowAllIpv6Outbound?: boolean;
        allowAllOutbound?: boolean;
        description?: string;
        disableInlineRules?: boolean;
        egresses?: SecurityGroupAccessRule[];
        ingresses?: SecurityGroupAccessRule[];
        securityGroupName?: string;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    allowAllIpv6Outbound? allowAllOutbound? description? disableInlineRules? @@ -32,7 +32,7 @@ '@aws-cdk/aws-ec2.securityGroupDisableInlineRules'.

    Default

    false
     
    -
    securityGroupName?: string

    The name of the security group. For valid values, see the GroupName +

    securityGroupName?: string

    The name of the security group. For valid values, see the GroupName parameter of the CreateSecurityGroup action in the Amazon EC2 API Reference.

    It is not recommended to use an explicit group name.

    diff --git a/interfaces/constructs_ec2.GuSecurityGroupProps.html b/interfaces/constructs_ec2.GuSecurityGroupProps.html index c058ccc695..6de4f8b40a 100644 --- a/interfaces/constructs_ec2.GuSecurityGroupProps.html +++ b/interfaces/constructs_ec2.GuSecurityGroupProps.html @@ -1,4 +1,4 @@ -GuSecurityGroupProps | @guardian/cdk
    interface GuSecurityGroupProps {
        allowAllIpv6Outbound?: boolean;
        allowAllOutbound?: boolean;
        app: string;
        description?: string;
        disableInlineRules?: boolean;
        egresses?: SecurityGroupAccessRule[];
        ingresses?: SecurityGroupAccessRule[];
        securityGroupName?: string;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    allowAllIpv6Outbound? +GuSecurityGroupProps | @guardian/cdk
    interface GuSecurityGroupProps {
        allowAllIpv6Outbound?: boolean;
        allowAllOutbound?: boolean;
        app: string;
        description?: string;
        disableInlineRules?: boolean;
        egresses?: SecurityGroupAccessRule[];
        ingresses?: SecurityGroupAccessRule[];
        securityGroupName?: string;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    allowAllIpv6Outbound? allowAllOutbound? app description? @@ -21,7 +21,7 @@

    To allow all ipv6 traffic use allowAllIpv6Outbound

    Default

    true
     
    -
    app: string
    description?: string

    A description of the security group.

    +
    app: string
    description?: string

    A description of the security group.

    Default

    The default name will be the construct's CDK path.
     
    disableInlineRules?: boolean

    Whether to disable inline ingress and egress rule optimization.

    @@ -33,7 +33,7 @@ '@aws-cdk/aws-ec2.securityGroupDisableInlineRules'.

    Default

    false
     
    -
    securityGroupName?: string

    The name of the security group. For valid values, see the GroupName +

    securityGroupName?: string

    The name of the security group. For valid values, see the GroupName parameter of the CreateSecurityGroup action in the Amazon EC2 API Reference.

    It is not recommended to use an explicit group name.

    diff --git a/interfaces/constructs_ec2.GuSubnetProps.html b/interfaces/constructs_ec2.GuSubnetProps.html index 7092befca1..2c55894f75 100644 --- a/interfaces/constructs_ec2.GuSubnetProps.html +++ b/interfaces/constructs_ec2.GuSubnetProps.html @@ -1,3 +1,3 @@ -GuSubnetProps | @guardian/cdk
    interface GuSubnetProps {
        app?: string;
        type?: SubnetType;
    }

    Properties

    app? +GuSubnetProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    app?: string
    type?: SubnetType

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_ec2.SecurityGroupAccessRule.html b/interfaces/constructs_ec2.SecurityGroupAccessRule.html index 93e932f1ad..c9d928085f 100644 --- a/interfaces/constructs_ec2.SecurityGroupAccessRule.html +++ b/interfaces/constructs_ec2.SecurityGroupAccessRule.html @@ -1,12 +1,12 @@ SecurityGroupAccessRule | @guardian/cdk

    A way to describe an ingress or egress rule for a security group.

    See [[transformToSecurityGroupAccessRule]] for a handy helper function.

    -
    interface SecurityGroupAccessRule {
        description: string;
        port: number | Port;
        range: IPeer;
    }

    Properties

    interface SecurityGroupAccessRule {
        description: string;
        port: number | Port;
        range: IPeer;
    }

    Properties

    description: string

    A short explanation for this rule.

    -
    port: number | Port

    The port to open in a security group. +

    port: number | Port

    The port to open in a security group. The default protocol is TCP. Use Port.udp(port) for the UDP protocol.

    -
    range: IPeer

    The CIDR address for this rule. +

    range: IPeer

    The CIDR address for this rule. Use Peer.anyIpv4() for global access.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_ecs.GuEcsTaskProps.html b/interfaces/constructs_ecs.GuEcsTaskProps.html index 5e999b8f57..e2f4cc0a9b 100644 --- a/interfaces/constructs_ecs.GuEcsTaskProps.html +++ b/interfaces/constructs_ecs.GuEcsTaskProps.html @@ -27,7 +27,7 @@ VERSION environment variable. Alternatively, you could hard code a value for the variable in CDK. See https://docs.aws.amazon.com/step-functions/latest/dg/connect-ecs.html for further detail and other override options - this construct currently only supports environment variables.

    -
    interface GuEcsTaskProps {
        app: string;
        containerConfiguration: ContainerConfiguration;
        cpu?: number;
        customTaskPolicies?: PolicyStatement[];
        enableDistributablePolicy?: boolean;
        environmentOverrides?: TaskEnvironmentVariable[];
        memory?: number;
        monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps;
        securityGroups?: ISecurityGroup[];
        storage?: number;
        taskCommand?: string;
        taskTimeoutInMinutes?: number;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    app +
    interface GuEcsTaskProps {
        app: string;
        containerConfiguration: ContainerConfiguration;
        cpu?: number;
        customTaskPolicies?: PolicyStatement[];
        enableDistributablePolicy?: boolean;
        environmentOverrides?: TaskEnvironmentVariable[];
        memory?: number;
        monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps;
        securityGroups?: ISecurityGroup[];
        storage?: number;
        taskCommand?: string;
        taskTimeoutInMinutes?: number;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    app: string
    containerConfiguration: ContainerConfiguration
    cpu?: number
    customTaskPolicies?: PolicyStatement[]
    enableDistributablePolicy?: boolean

    Whether to give the task IAM role access to the account's dist bucket. +

    Properties

    app: string
    containerConfiguration: ContainerConfiguration
    cpu?: number
    customTaskPolicies?: PolicyStatement[]
    enableDistributablePolicy?: boolean

    Whether to give the task IAM role access to the account's dist bucket. This is enabled by default to avoid breaking changes, but consumers of this pattern that pull a container image that doesn't need extra dependencies from S3 shoud set this value to false.

    -
    environmentOverrides?: TaskEnvironmentVariable[]
    memory?: number
    monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps
    securityGroups?: ISecurityGroup[]
    storage?: number
    taskCommand?: string
    taskTimeoutInMinutes?: number
    vpc: IVpc

    Generated using TypeDoc

    \ No newline at end of file +
    environmentOverrides?: TaskEnvironmentVariable[]
    memory?: number
    monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps
    securityGroups?: ISecurityGroup[]
    storage?: number
    taskCommand?: string
    taskTimeoutInMinutes?: number
    vpc: IVpc

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_iam.GuAllowPolicyProps.html b/interfaces/constructs_iam.GuAllowPolicyProps.html index 890ef97340..515da3e6bb 100644 --- a/interfaces/constructs_iam.GuAllowPolicyProps.html +++ b/interfaces/constructs_iam.GuAllowPolicyProps.html @@ -1,4 +1,4 @@ -GuAllowPolicyProps | @guardian/cdk
    interface GuAllowPolicyProps {
        actions: string[];
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        policyName?: string;
        resources: string[];
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    actions +GuAllowPolicyProps | @guardian/cdk
    interface GuAllowPolicyProps {
        actions: string[];
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        policyName?: string;
        resources: string[];
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    Properties

    actions: string[]
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any +

    Properties

    actions: string[]
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any PolicyStatement provided in the statements property will be applied against the empty default PolicyDocument.

    Default

    - An empty policy.
    @@ -30,7 +30,7 @@
     an IAM role, each policy must have a unique name.

    Default

    - Uses the logical ID of the policy resource, which is ensured
    to be unique within the stack.
    -
    resources: string[]
    roles?: IRole[]

    Roles to attach this policy to. +

    resources: string[]
    roles?: IRole[]

    Roles to attach this policy to. You can also use attachToRole(role) to attach this policy to a role.

    Default

    - No roles.
     
    diff --git a/interfaces/constructs_iam.GuAssumeRolePolicyProps.html b/interfaces/constructs_iam.GuAssumeRolePolicyProps.html index f7ad631219..f6e5aa375b 100644 --- a/interfaces/constructs_iam.GuAssumeRolePolicyProps.html +++ b/interfaces/constructs_iam.GuAssumeRolePolicyProps.html @@ -1,4 +1,4 @@ -GuAssumeRolePolicyProps | @guardian/cdk
    interface GuAssumeRolePolicyProps {
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        policyName?: string;
        resources: string[];
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    document? +GuAssumeRolePolicyProps | @guardian/cdk
    interface GuAssumeRolePolicyProps {
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        policyName?: string;
        resources: string[];
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    document? force? groups? policyName? @@ -29,7 +29,7 @@ an IAM role, each policy must have a unique name.

    Default

    - Uses the logical ID of the policy resource, which is ensured
    to be unique within the stack.
    -
    resources: string[]
    roles?: IRole[]

    Roles to attach this policy to. +

    resources: string[]
    roles?: IRole[]

    Roles to attach this policy to. You can also use attachToRole(role) to attach this policy to a role.

    Default

    - No roles.
     
    diff --git a/interfaces/constructs_iam.GuFastlyLogsIamRoleProps.html b/interfaces/constructs_iam.GuFastlyLogsIamRoleProps.html index ab518b7593..1124218a50 100644 --- a/interfaces/constructs_iam.GuFastlyLogsIamRoleProps.html +++ b/interfaces/constructs_iam.GuFastlyLogsIamRoleProps.html @@ -1,7 +1,7 @@ -GuFastlyLogsIamRoleProps | @guardian/cdk

    Interface GuFastlyLogsIamRoleProps

    interface GuFastlyLogsIamRoleProps {
        bucketName: string;
        path?: string;
    }

    Properties

    bucketName +GuFastlyLogsIamRoleProps | @guardian/cdk

    Interface GuFastlyLogsIamRoleProps

    interface GuFastlyLogsIamRoleProps {
        bucketName: string;
        path?: string;
    }

    Properties

    Properties

    bucketName: string

    S3 bucket name that Fastly will ship logs

    -
    path?: string

    Path within the S3 bucket where Fastly will ship logs.

    +
    path?: string

    Path within the S3 bucket where Fastly will ship logs.

    Default

    - '*'
    If path is not specified, access will be granted to the entire S3 bucket.
    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_iam.GuGetS3ObjectPolicyProps.html b/interfaces/constructs_iam.GuGetS3ObjectPolicyProps.html index 881970c819..f05963a57e 100644 --- a/interfaces/constructs_iam.GuGetS3ObjectPolicyProps.html +++ b/interfaces/constructs_iam.GuGetS3ObjectPolicyProps.html @@ -1,4 +1,4 @@ -GuGetS3ObjectPolicyProps | @guardian/cdk

    Interface GuGetS3ObjectPolicyProps

    interface GuGetS3ObjectPolicyProps {
        bucketName: string;
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        paths?: string[];
        policyName?: string;
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    bucketName +GuGetS3ObjectPolicyProps | @guardian/cdk

    Interface GuGetS3ObjectPolicyProps

    interface GuGetS3ObjectPolicyProps {
        bucketName: string;
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        paths?: string[];
        policyName?: string;
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    bucketName: string
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any +

    Properties

    bucketName: string
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any PolicyStatement provided in the statements property will be applied against the empty default PolicyDocument.

    Default

    - An empty policy.
    @@ -25,7 +25,7 @@
     You can also use attachToGroup(group) to attach this policy to a group.

    Default

    - No groups.
     
    -
    paths?: string[]
    policyName?: string

    The name of the policy. If you specify multiple policies for an entity, +

    paths?: string[]
    policyName?: string

    The name of the policy. If you specify multiple policies for an entity, specify unique names. For example, if you specify a list of policies for an IAM role, each policy must have a unique name.

    Default

    - Uses the logical ID of the policy resource, which is ensured
    to be unique within the stack. diff --git a/interfaces/constructs_iam.GuGithubActionsRepositoryCondition.html b/interfaces/constructs_iam.GuGithubActionsRepositoryCondition.html index 6df0be15dc..a33889775e 100644 --- a/interfaces/constructs_iam.GuGithubActionsRepositoryCondition.html +++ b/interfaces/constructs_iam.GuGithubActionsRepositoryCondition.html @@ -1,5 +1,5 @@ -GuGithubActionsRepositoryCondition | @guardian/cdk

    Interface GuGithubActionsRepositoryCondition

    interface GuGithubActionsRepositoryCondition {
        githubOrganisation: string;
        repositories?: string;
    }

    Properties

    githubOrganisation +GuGithubActionsRepositoryCondition | @guardian/cdk

    Interface GuGithubActionsRepositoryCondition

    interface GuGithubActionsRepositoryCondition {
        githubOrganisation: string;
        repositories?: string;
    }

    Properties

    githubOrganisation: string

    The GitHub organisation/user to constrain the IAM Role to.

    -
    repositories?: string

    Repositories to constrain the IAM Role to.

    -

    Generated using TypeDoc

    \ No newline at end of file +
    repositories?: string

    Repositories to constrain the IAM Role to.

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_iam.GuGithubActionsRoleProps.html b/interfaces/constructs_iam.GuGithubActionsRoleProps.html index 7320421a58..14c4ee1e0b 100644 --- a/interfaces/constructs_iam.GuGithubActionsRoleProps.html +++ b/interfaces/constructs_iam.GuGithubActionsRoleProps.html @@ -1,6 +1,6 @@ -GuGithubActionsRoleProps | @guardian/cdk

    Interface GuGithubActionsRoleProps

    interface GuGithubActionsRoleProps {
        condition?: GuGithubActionsRepositoryCondition;
        policies: GuPolicy[];
    }

    Properties

    condition? +GuGithubActionsRoleProps | @guardian/cdk

    Interface GuGithubActionsRoleProps

    interface GuGithubActionsRoleProps {
        condition?: GuGithubActionsRepositoryCondition;
        policies: GuPolicy[];
    }

    Properties

    Properties

    Repositories where GitHub Actions can assumes this role. Defaults to [[ALL_GUARDIAN_REPOSITORIES]].

    -
    policies: GuPolicy[]

    A list of IAM Policies for the GitHub Action.

    -

    Generated using TypeDoc

    \ No newline at end of file +
    policies: GuPolicy[]

    A list of IAM Policies for the GitHub Action.

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_iam.GuInstanceRoleProps.html b/interfaces/constructs_iam.GuInstanceRoleProps.html index bc4ed99d88..27e9333378 100644 --- a/interfaces/constructs_iam.GuInstanceRoleProps.html +++ b/interfaces/constructs_iam.GuInstanceRoleProps.html @@ -1,7 +1,7 @@ -GuInstanceRoleProps | @guardian/cdk
    interface GuInstanceRoleProps {
        additionalPolicies?: GuPolicy[];
        withoutLogShipping?: boolean;
    }

    Properties

    additionalPolicies? +GuInstanceRoleProps | @guardian/cdk
    interface GuInstanceRoleProps {
        additionalPolicies?: GuPolicy[];
        withoutLogShipping?: boolean;
    }

    Properties

    additionalPolicies?: GuPolicy[]
    withoutLogShipping?: boolean

    By default, instances are given permissions to write to Kinesis. Set to +

    Properties

    additionalPolicies?: GuPolicy[]
    withoutLogShipping?: boolean

    By default, instances are given permissions to write to Kinesis. Set to 'true' to prevent this. Note, disabling will prevent not just application logs being shipped but also anything else - for example, automatic log shipping of Cloud Init and other logs by the cdk-base role in your AMI.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_iam.GuPutS3ObjectPolicyProps.html b/interfaces/constructs_iam.GuPutS3ObjectPolicyProps.html index 955a2d7e1b..e21acfa3c8 100644 --- a/interfaces/constructs_iam.GuPutS3ObjectPolicyProps.html +++ b/interfaces/constructs_iam.GuPutS3ObjectPolicyProps.html @@ -1,4 +1,4 @@ -GuPutS3ObjectPolicyProps | @guardian/cdk

    Interface GuPutS3ObjectPolicyProps

    interface GuPutS3ObjectPolicyProps {
        bucketName: string;
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        paths?: string[];
        policyName?: string;
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    bucketName +GuPutS3ObjectPolicyProps | @guardian/cdk

    Interface GuPutS3ObjectPolicyProps

    interface GuPutS3ObjectPolicyProps {
        bucketName: string;
        document?: PolicyDocument;
        force?: boolean;
        groups?: IGroup[];
        paths?: string[];
        policyName?: string;
        roles?: IRole[];
        users?: IUser[];
    }

    Hierarchy

    Properties

    bucketName: string
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any +

    Properties

    bucketName: string
    document?: PolicyDocument

    Initial PolicyDocument to use for this Policy. If omited, any PolicyStatement provided in the statements property will be applied against the empty default PolicyDocument.

    Default

    - An empty policy.
    @@ -25,7 +25,7 @@
     You can also use attachToGroup(group) to attach this policy to a group.

    Default

    - No groups.
     
    -
    paths?: string[]
    policyName?: string

    The name of the policy. If you specify multiple policies for an entity, +

    paths?: string[]
    policyName?: string

    The name of the policy. If you specify multiple policies for an entity, specify unique names. For example, if you specify a list of policies for an IAM role, each policy must have a unique name.

    Default

    - Uses the logical ID of the policy resource, which is ensured
    to be unique within the stack. diff --git a/interfaces/constructs_lambda.GuFunctionProps.html b/interfaces/constructs_lambda.GuFunctionProps.html index 798b9a189f..c68e8773de 100644 --- a/interfaces/constructs_lambda.GuFunctionProps.html +++ b/interfaces/constructs_lambda.GuFunctionProps.html @@ -1,4 +1,4 @@ -GuFunctionProps | @guardian/cdk
    interface GuFunctionProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        errorPercentageMonitoring?: GuLambdaErrorPercentageMonitoringProps;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? +GuFunctionProps | @guardian/cdk
    interface GuFunctionProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        errorPercentageMonitoring?: GuLambdaErrorPercentageMonitoringProps;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? allowAllOutbound? allowPublicSubnet? app @@ -61,7 +61,7 @@

    Default

    - 
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    +
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    Default

    Architecture.X86_64
     
    bucketNamePath?: string

    SSM parameter for the S3 bucket that contains your lambda file.

    @@ -69,7 +69,7 @@

    Default

    false
     you are referencing a file that is shared across many apps and/or AWS
     accounts.

    Default Value

    [[GuDistributionBucketParameter]]

    -
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    +
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    Default

    - Not Sign the Code
     
    currentVersionOptions?: VersionOptions

    Options for the lambda.Version resource automatically created by the @@ -99,7 +99,7 @@

    Default

    false
     on versioning (e.g. SnapStart or Provisioned Concurrency).

    If you enable versioning you must ensure that your Lambda function is updated whenever a new build is deployed via CloudFormation. The simplest way to do this is to include the build number in the fileName prop.

    -
    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda +

    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda functions. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Lambda function source code.

    @@ -112,13 +112,13 @@

    Default

    false
     

    Default

    512 MiB
     
    errorPercentageMonitoring?: GuLambdaErrorPercentageMonitoringProps

    Alarm if error percentage exceeds a threshold.

    -
    events?: IEventSource[]

    Event sources for this function.

    +
    events?: IEventSource[]

    Event sources for this function.

    You can also add event sources using addEventSource.

    Default

    - No event sources.
     
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    +
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    Default

    - will not mount any filesystem
     
    functionName?: string

    A name for the function.

    @@ -239,7 +239,7 @@

    See

    See

    https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html

    -
    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates +

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates the function. Because the execution time affects cost, set this value based on the function's expected execution time.

    Default

    Duration.seconds(3)
    @@ -263,8 +263,8 @@ 

    See

    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    +
    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    Typically you should not override this but you may need to if, for example, you are referencing a file that is shared across many apps and/or AWS accounts.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_loadbalancing.GuApplicationListenerProps.html b/interfaces/constructs_loadbalancing.GuApplicationListenerProps.html index 5ca1f70b35..b644076c12 100644 --- a/interfaces/constructs_loadbalancing.GuApplicationListenerProps.html +++ b/interfaces/constructs_loadbalancing.GuApplicationListenerProps.html @@ -1,4 +1,4 @@ -GuApplicationListenerProps | @guardian/cdk
    interface GuApplicationListenerProps {
        app: string;
        certificates?: IListenerCertificate[];
        defaultAction?: ListenerAction;
        defaultTargetGroups?: IApplicationTargetGroup[];
        loadBalancer: IApplicationLoadBalancer;
        open?: boolean;
        port?: number;
        protocol?: ApplicationProtocol;
        sslPolicy?: SslPolicy;
    }

    Hierarchy

    • ApplicationListenerProps
    • AppIdentity
      • GuApplicationListenerProps

    Properties

    app +GuApplicationListenerProps | @guardian/cdk
    interface GuApplicationListenerProps {
        app: string;
        certificates?: IListenerCertificate[];
        defaultAction?: ListenerAction;
        defaultTargetGroups?: IApplicationTargetGroup[];
        loadBalancer: IApplicationLoadBalancer;
        open?: boolean;
        port?: number;
        protocol?: ApplicationProtocol;
        sslPolicy?: SslPolicy;
    }

    Hierarchy

    • ApplicationListenerProps
    • AppIdentity
      • GuApplicationListenerProps

    Properties

    app: string
    certificates?: IListenerCertificate[]

    Certificate list of ACM cert ARNs. You must provide exactly one certificate if the listener protocol is HTTPS or TLS.

    +

    Properties

    app: string
    certificates?: IListenerCertificate[]

    Certificate list of ACM cert ARNs. You must provide exactly one certificate if the listener protocol is HTTPS or TLS.

    Default

    - No certificates.
     
    defaultAction?: ListenerAction

    Default action to take for requests to this listener

    diff --git a/interfaces/constructs_loadbalancing.GuApplicationTargetGroupProps.html b/interfaces/constructs_loadbalancing.GuApplicationTargetGroupProps.html index 4379feda1b..ab142ddd4f 100644 --- a/interfaces/constructs_loadbalancing.GuApplicationTargetGroupProps.html +++ b/interfaces/constructs_loadbalancing.GuApplicationTargetGroupProps.html @@ -1,4 +1,4 @@ -GuApplicationTargetGroupProps | @guardian/cdk
    interface GuApplicationTargetGroupProps {
        app: string;
        deregistrationDelay?: Duration;
        healthCheck?: HealthCheck;
        loadBalancingAlgorithmType?: TargetGroupLoadBalancingAlgorithmType;
        port?: number;
        protocol?: ApplicationProtocol;
        protocolVersion?: ApplicationProtocolVersion;
        slowStart?: Duration;
        stickinessCookieDuration?: Duration;
        stickinessCookieName?: string;
        targetGroupName?: string;
        targetType?: TargetType;
        targets?: IApplicationLoadBalancerTarget[];
        vpc?: IVpc;
    }

    Hierarchy

    • ApplicationTargetGroupProps
    • AppIdentity
      • GuApplicationTargetGroupProps

    Properties

    app +GuApplicationTargetGroupProps | @guardian/cdk
    interface GuApplicationTargetGroupProps {
        app: string;
        deregistrationDelay?: Duration;
        healthCheck?: HealthCheck;
        loadBalancingAlgorithmType?: TargetGroupLoadBalancingAlgorithmType;
        port?: number;
        protocol?: ApplicationProtocol;
        protocolVersion?: ApplicationProtocolVersion;
        slowStart?: Duration;
        stickinessCookieDuration?: Duration;
        stickinessCookieName?: string;
        targetGroupName?: string;
        targetType?: TargetType;
        targets?: IApplicationLoadBalancerTarget[];
        vpc?: IVpc;
    }

    Hierarchy

    • ApplicationTargetGroupProps
    • AppIdentity
      • GuApplicationTargetGroupProps

    Properties

    app: string
    deregistrationDelay?: Duration

    The amount of time for Elastic Load Balancing to wait before deregistering a target.

    +

    Properties

    app: string
    deregistrationDelay?: Duration

    The amount of time for Elastic Load Balancing to wait before deregistering a target.

    The range is 0-3600 seconds.

    Default

    300
     
    diff --git a/interfaces/constructs_loadbalancing.GuHttpsApplicationListenerProps.html b/interfaces/constructs_loadbalancing.GuHttpsApplicationListenerProps.html index 64320eb953..debe26929d 100644 --- a/interfaces/constructs_loadbalancing.GuHttpsApplicationListenerProps.html +++ b/interfaces/constructs_loadbalancing.GuHttpsApplicationListenerProps.html @@ -1,4 +1,4 @@ -GuHttpsApplicationListenerProps | @guardian/cdk
    interface GuHttpsApplicationListenerProps {
        app: string;
        certificate?: GuCertificate;
        defaultTargetGroups?: IApplicationTargetGroup[];
        loadBalancer: IApplicationLoadBalancer;
        open?: boolean;
        port?: number;
        protocol?: ApplicationProtocol;
        sslPolicy?: SslPolicy;
        targetGroup: GuApplicationTargetGroup;
    }

    Hierarchy

    Properties

    app +GuHttpsApplicationListenerProps | @guardian/cdk
    interface GuHttpsApplicationListenerProps {
        app: string;
        certificate?: GuCertificate;
        defaultTargetGroups?: IApplicationTargetGroup[];
        loadBalancer: IApplicationLoadBalancer;
        open?: boolean;
        port?: number;
        protocol?: ApplicationProtocol;
        sslPolicy?: SslPolicy;
        targetGroup: GuApplicationTargetGroup;
    }

    Hierarchy

    Properties

    app: string
    certificate?: GuCertificate
    defaultTargetGroups?: IApplicationTargetGroup[]

    Default target groups to load balance to

    +

    Properties

    app: string
    certificate?: GuCertificate
    defaultTargetGroups?: IApplicationTargetGroup[]

    Default target groups to load balance to

    All target groups will be load balanced to with equal weight and without stickiness. For a more complex configuration than that, use either defaultAction or addAction().

    @@ -33,4 +33,4 @@
    sslPolicy?: SslPolicy

    The security policy that defines which ciphers and protocols are supported.

    Default

    - The current predefined security policy.
     
    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/constructs_rds.GuDatabaseInstanceProps.html b/interfaces/constructs_rds.GuDatabaseInstanceProps.html index 3f812290b3..6e43bf7958 100644 --- a/interfaces/constructs_rds.GuDatabaseInstanceProps.html +++ b/interfaces/constructs_rds.GuDatabaseInstanceProps.html @@ -1,4 +1,4 @@ -GuDatabaseInstanceProps | @guardian/cdk
    interface GuDatabaseInstanceProps {
        allocatedStorage?: number;
        allowMajorVersionUpgrade?: boolean;
        app: string;
        autoMinorVersionUpgrade?: boolean;
        availabilityZone?: string;
        backupRetention?: Duration;
        caCertificate?: CaCertificate;
        characterSetName?: string;
        cloudwatchLogsExports?: string[];
        cloudwatchLogsRetention?: RetentionDays;
        cloudwatchLogsRetentionRole?: IRole;
        copyTagsToSnapshot?: boolean;
        credentials?: Credentials;
        databaseName?: string;
        deleteAutomatedBackups?: boolean;
        deletionProtection?: boolean;
        domain?: string;
        domainRole?: IRole;
        enablePerformanceInsights?: boolean;
        engine: IInstanceEngine;
        iamAuthentication?: boolean;
        instanceIdentifier?: string;
        instanceType: string;
        iops?: number;
        licenseModel?: LicenseModel;
        maxAllocatedStorage?: number;
        monitoringInterval?: Duration;
        monitoringRole?: IRole;
        multiAz?: boolean;
        networkType?: NetworkType;
        optionGroup?: IOptionGroup;
        parameterGroup?: IParameterGroup;
        parameters?: {
            [key: string]: string;
        };
        performanceInsightEncryptionKey?: IKey;
        performanceInsightRetention?: PerformanceInsightRetention;
        port?: number;
        preferredBackupWindow?: string;
        preferredMaintenanceWindow?: string;
        processorFeatures?: ProcessorFeatures;
        publiclyAccessible?: boolean;
        removalPolicy?: RemovalPolicy;
        s3ExportBuckets?: IBucket[];
        s3ExportRole?: IRole;
        s3ImportBuckets?: IBucket[];
        s3ImportRole?: IRole;
        securityGroups?: ISecurityGroup[];
        storageEncrypted?: boolean;
        storageEncryptionKey?: IKey;
        storageThroughput?: number;
        storageType?: StorageType;
        subnetGroup?: ISubnetGroup;
        timezone?: string;
        vpc: IVpc;
        vpcSubnets?: SubnetSelection;
    }

    Hierarchy

    • Omit<DatabaseInstanceProps, "instanceType">
    • AppIdentity
      • GuDatabaseInstanceProps

    Properties

    allocatedStorage? +GuDatabaseInstanceProps | @guardian/cdk
    interface GuDatabaseInstanceProps {
        allocatedStorage?: number;
        allowMajorVersionUpgrade?: boolean;
        app: string;
        autoMinorVersionUpgrade?: boolean;
        availabilityZone?: string;
        backupRetention?: Duration;
        caCertificate?: CaCertificate;
        characterSetName?: string;
        cloudwatchLogsExports?: string[];
        cloudwatchLogsRetention?: RetentionDays;
        cloudwatchLogsRetentionRole?: IRole;
        copyTagsToSnapshot?: boolean;
        credentials?: Credentials;
        databaseName?: string;
        deleteAutomatedBackups?: boolean;
        deletionProtection?: boolean;
        domain?: string;
        domainRole?: IRole;
        enablePerformanceInsights?: boolean;
        engine: IInstanceEngine;
        iamAuthentication?: boolean;
        instanceIdentifier?: string;
        instanceType: string;
        iops?: number;
        licenseModel?: LicenseModel;
        maxAllocatedStorage?: number;
        monitoringInterval?: Duration;
        monitoringRole?: IRole;
        multiAz?: boolean;
        networkType?: NetworkType;
        optionGroup?: IOptionGroup;
        parameterGroup?: IParameterGroup;
        parameters?: {
            [key: string]: string;
        };
        performanceInsightEncryptionKey?: IKey;
        performanceInsightRetention?: PerformanceInsightRetention;
        port?: number;
        preferredBackupWindow?: string;
        preferredMaintenanceWindow?: string;
        processorFeatures?: ProcessorFeatures;
        publiclyAccessible?: boolean;
        removalPolicy?: RemovalPolicy;
        s3ExportBuckets?: IBucket[];
        s3ExportRole?: IRole;
        s3ImportBuckets?: IBucket[];
        s3ImportRole?: IRole;
        securityGroups?: ISecurityGroup[];
        storageEncrypted?: boolean;
        storageEncryptionKey?: IKey;
        storageThroughput?: number;
        storageType?: StorageType;
        subnetGroup?: ISubnetGroup;
        timezone?: string;
        vpc: IVpc;
        vpcSubnets?: SubnetSelection;
    }

    Hierarchy

    • Omit<DatabaseInstanceProps, "instanceType">
    • AppIdentity
      • GuDatabaseInstanceProps

    Properties

    allowMajorVersionUpgrade?: boolean

    Whether to allow major version upgrades.

    Default

    false
     
    -
    app: string
    autoMinorVersionUpgrade?: boolean

    Indicates that minor engine upgrades are applied automatically to the +

    app: string
    autoMinorVersionUpgrade?: boolean

    Indicates that minor engine upgrades are applied automatically to the DB instance during the maintenance window.

    Default

    true
     
    @@ -137,7 +137,7 @@

    Default

    - 
     

    Default

    - a CloudFormation generated name
     
    -
    instanceType: string
    iops?: number

    The number of I/O operations per second (IOPS) that the database provisions. +

    instanceType: string
    iops?: number

    The number of I/O operations per second (IOPS) that the database provisions. The value must be equal to or greater than 1000.

    Default

    - no provisioned iops if storage type is not specified. For GP3: 3,000 IOPS if allocated
    storage is less than 400 GiB for MariaDB, MySQL, and PostgreSQL, less than 200 GiB for Oracle and
    less than 20 GiB for SQL Server. 12,000 IOPS otherwise (except for SQL Server where the default is
    always 3,000 IOPS).
    diff --git a/interfaces/constructs_s3.GuS3BucketProps.html b/interfaces/constructs_s3.GuS3BucketProps.html index b86022669d..1ca6cccae6 100644 --- a/interfaces/constructs_s3.GuS3BucketProps.html +++ b/interfaces/constructs_s3.GuS3BucketProps.html @@ -1,4 +1,4 @@ -GuS3BucketProps | @guardian/cdk
    interface GuS3BucketProps {
        accessControl?: BucketAccessControl;
        app: string;
        autoDeleteObjects?: boolean;
        blockPublicAccess?: BlockPublicAccess;
        bucketKeyEnabled?: boolean;
        bucketName?: string;
        cors?: CorsRule[];
        encryption?: BucketEncryption;
        encryptionKey?: IKey;
        enforceSSL?: boolean;
        eventBridgeEnabled?: boolean;
        intelligentTieringConfigurations?: IntelligentTieringConfiguration[];
        inventories?: Inventory[];
        lifecycleRules?: LifecycleRule[];
        metrics?: BucketMetrics[];
        minimumTLSVersion?: number;
        notificationsHandlerRole?: IRole;
        objectLockDefaultRetention?: ObjectLockRetention;
        objectLockEnabled?: boolean;
        objectOwnership?: ObjectOwnership;
        publicReadAccess?: boolean;
        serverAccessLogsBucket?: IBucket;
        serverAccessLogsPrefix?: string;
        transferAcceleration?: boolean;
        versioned?: boolean;
        websiteErrorDocument?: string;
        websiteIndexDocument?: string;
        websiteRedirect?: RedirectTarget;
        websiteRoutingRules?: RoutingRule[];
    }

    Hierarchy

    • Omit<BucketProps, "removalPolicy">
    • AppIdentity
      • GuS3BucketProps

    Properties

    accessControl? +GuS3BucketProps | @guardian/cdk
    interface GuS3BucketProps {
        accessControl?: BucketAccessControl;
        app: string;
        autoDeleteObjects?: boolean;
        blockPublicAccess?: BlockPublicAccess;
        bucketKeyEnabled?: boolean;
        bucketName?: string;
        cors?: CorsRule[];
        encryption?: BucketEncryption;
        encryptionKey?: IKey;
        enforceSSL?: boolean;
        eventBridgeEnabled?: boolean;
        intelligentTieringConfigurations?: IntelligentTieringConfiguration[];
        inventories?: Inventory[];
        lifecycleRules?: LifecycleRule[];
        metrics?: BucketMetrics[];
        minimumTLSVersion?: number;
        notificationsHandlerRole?: IRole;
        objectLockDefaultRetention?: ObjectLockRetention;
        objectLockEnabled?: boolean;
        objectOwnership?: ObjectOwnership;
        publicReadAccess?: boolean;
        serverAccessLogsBucket?: IBucket;
        serverAccessLogsPrefix?: string;
        transferAcceleration?: boolean;
        versioned?: boolean;
        websiteErrorDocument?: string;
        websiteIndexDocument?: string;
        websiteRedirect?: RedirectTarget;
        websiteRoutingRules?: RoutingRule[];
    }

    Hierarchy

    • Omit<BucketProps, "removalPolicy">
    • AppIdentity
      • GuS3BucketProps

    Properties

    accessControl?: BucketAccessControl

    Specifies a canned ACL that grants predefined permissions to the bucket.

    Default

    BucketAccessControl.PRIVATE
     
    -
    app: string
    autoDeleteObjects?: boolean

    Whether all objects should be automatically deleted when the bucket is +

    app: string
    autoDeleteObjects?: boolean

    Whether all objects should be automatically deleted when the bucket is removed from the stack or when the stack is deleted.

    Requires the removalPolicy to be set to RemovalPolicy.DESTROY.

    Warning if you have deployed a bucket with autoDeleteObjects: true, diff --git a/interfaces/constructs_ses.GuEmailIdentityProps.html b/interfaces/constructs_ses.GuEmailIdentityProps.html index f1d3a20b36..bd4cc22aa1 100644 --- a/interfaces/constructs_ses.GuEmailIdentityProps.html +++ b/interfaces/constructs_ses.GuEmailIdentityProps.html @@ -2,7 +2,7 @@ domainName: The domain name to use for this identity The domain name must be one of GuEmailIdentity.validDomains

    interface GuEmailIdentityProps {
        app: string;
        configurationSet?: IConfigurationSet;
        dkimIdentity?: DkimIdentity;
        dkimSigning?: boolean;
        domainName: string;
        feedbackForwarding?: boolean;
        mailFromBehaviorOnMxFailure?: MailFromBehaviorOnMxFailure;
        mailFromDomain?: string;
    }

    Hierarchy

    • Omit<EmailIdentityProps, "identity">
    • AppIdentity
      • GuEmailIdentityProps

    Properties

    app +
    interface GuEmailIdentityProps {
        app: string;
        configurationSet?: IConfigurationSet;
        dkimIdentity?: DkimIdentity;
        dkimSigning?: boolean;
        domainName: string;
        feedbackForwarding?: boolean;
        mailFromBehaviorOnMxFailure?: MailFromBehaviorOnMxFailure;
        mailFromDomain?: string;
    }

    Hierarchy

    • Omit<EmailIdentityProps, "identity">
    • AppIdentity
      • GuEmailIdentityProps

    Properties

    app: string
    configurationSet?: IConfigurationSet

    The configuration set to associate with the email identity

    +

    Properties

    app: string
    configurationSet?: IConfigurationSet

    The configuration set to associate with the email identity

    Default

    - do not use a specific configuration set
     
    dkimIdentity?: DkimIdentity

    The type of DKIM identity to use

    @@ -19,7 +19,7 @@
    dkimSigning?: boolean

    Whether the messages that are sent from the identity are signed using DKIM

    Default

    true
     
    -
    domainName: string
    feedbackForwarding?: boolean

    Whether to receive email notifications when bounce or complaint events occur. +

    domainName: string
    feedbackForwarding?: boolean

    Whether to receive email notifications when bounce or complaint events occur. These notifications are sent to the address that you specified in the Return-Path header of the original email.

    You're required to have a method of tracking bounces and complaints. If you haven't set diff --git a/interfaces/experimental_patterns.ExistingKinesisStream.html b/interfaces/experimental_patterns.ExistingKinesisStream.html index 8e2317bfc9..c52ec320f9 100644 --- a/interfaces/experimental_patterns.ExistingKinesisStream.html +++ b/interfaces/experimental_patterns.ExistingKinesisStream.html @@ -1,5 +1,5 @@ ExistingKinesisStream | @guardian/cdk

    Used to provide information about an existing Kinesis stream to the [[GuKinesisLambda]] pattern.

    Specify an externalKinesisStreamName to link the lambda to a Kinesis stream owned by a different stack (or created outside of version control).

    -
    interface ExistingKinesisStream {
        externalKinesisStreamName: string;
    }

    Properties

    externalKinesisStreamName: string

    Generated using TypeDoc

    \ No newline at end of file +
    interface ExistingKinesisStream {
        externalKinesisStreamName: string;
    }

    Properties

    externalKinesisStreamName: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/experimental_patterns.ExistingSnsTopic.html b/interfaces/experimental_patterns.ExistingSnsTopic.html index 491e3cdb3e..3c28e6302f 100644 --- a/interfaces/experimental_patterns.ExistingSnsTopic.html +++ b/interfaces/experimental_patterns.ExistingSnsTopic.html @@ -1,5 +1,5 @@ ExistingSnsTopic | @guardian/cdk

    Used to provide information about an existing SNS topic to the [[GuSnsLambda]] pattern.

    Specify an externalTopicName to link the lambda to an SNS topic owned by a different stack (or created outside of version control).

    -
    interface ExistingSnsTopic {
        externalTopicName: string;
    }

    Properties

    Properties

    externalTopicName: string

    Generated using TypeDoc

    \ No newline at end of file +
    interface ExistingSnsTopic {
        externalTopicName: string;
    }

    Properties

    Properties

    externalTopicName: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/experimental_patterns.GuKinesisLambdaProps.html b/interfaces/experimental_patterns.GuKinesisLambdaProps.html index 1331635b81..900e3cbea1 100644 --- a/interfaces/experimental_patterns.GuKinesisLambdaProps.html +++ b/interfaces/experimental_patterns.GuKinesisLambdaProps.html @@ -18,7 +18,7 @@

    If your team do not use CloudWatch, it's possible to opt-out with the following configuration:

     monitoringConfiguration: { noMonitoring: true } as NoMonitoring
     
    -
    interface GuKinesisLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        errorHandlingConfiguration: StreamErrorHandlingProps;
        events?: IEventSource[];
        existingKinesisStream?: ExistingKinesisStream;
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        kinesisStreamProps?: StreamProps;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        processingProps?: StreamProcessingProps;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    interface GuKinesisLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        errorHandlingConfiguration: StreamErrorHandlingProps;
        events?: IEventSource[];
        existingKinesisStream?: ExistingKinesisStream;
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        kinesisStreamProps?: StreamProps;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        processingProps?: StreamProcessingProps;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? allowAllOutbound? allowPublicSubnet? app @@ -85,7 +85,7 @@

    Default

    - 
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    +
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    Default

    Architecture.X86_64
     
    bucketNamePath?: string

    SSM parameter for the S3 bucket that contains your lambda file.

    @@ -93,7 +93,7 @@

    Default

    false
     you are referencing a file that is shared across many apps and/or AWS
     accounts.

    Default Value

    [[GuDistributionBucketParameter]]

    -
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    +
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    Default

    - Not Sign the Code
     
    currentVersionOptions?: VersionOptions

    Options for the lambda.Version resource automatically created by the @@ -123,7 +123,7 @@

    Default

    false
     on versioning (e.g. SnapStart or Provisioned Concurrency).

    If you enable versioning you must ensure that your Lambda function is updated whenever a new build is deployed via CloudFormation. The simplest way to do this is to include the build number in the fileName prop.

    -
    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda +

    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda functions. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Lambda function source code.

    @@ -135,13 +135,13 @@

    Default

    false
     
    ephemeralStorageSize?: Size

    The size of the function’s /tmp directory in MiB.

    Default

    512 MiB
     
    -
    errorHandlingConfiguration: StreamErrorHandlingProps
    events?: IEventSource[]

    Event sources for this function.

    +
    errorHandlingConfiguration: StreamErrorHandlingProps
    events?: IEventSource[]

    Event sources for this function.

    You can also add event sources using addEventSource.

    Default

    - No event sources.
     
    -
    existingKinesisStream?: ExistingKinesisStream
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. +

    existingKinesisStream?: ExistingKinesisStream
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    +
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    Default

    - will not mount any filesystem
     
    functionName?: string

    A name for the function.

    @@ -170,7 +170,7 @@

    Default

    false
     
     

    Default

    - No Lambda Insights
     
    -
    kinesisStreamProps?: StreamProps
    layers?: ILayerVersion[]

    A list of layers to add to the function's execution environment. You can configure your Lambda function to pull in +

    kinesisStreamProps?: StreamProps
    layers?: ILayerVersion[]

    A list of layers to add to the function's execution environment. You can configure your Lambda function to pull in additional code during initialization in the form of layers. Layers are packages of libraries or other dependencies that can be used by multiple functions.

    Default

    - No layers.
    @@ -200,7 +200,7 @@ 

    Default

    - 
     

    Default

    128
     
    -
    onFailure?: IDestination

    The destination for failed invocations.

    +
    onFailure?: IDestination

    The destination for failed invocations.

    Default

    - no destination
     
    onSuccess?: IDestination

    The destination for successful invocations.

    @@ -213,7 +213,7 @@

    Default

    - 
     

    Default

    - No Parameters and Secrets Extension
     
    -
    processingProps?: StreamProcessingProps
    profiling?: boolean

    Enable profiling.

    +
    processingProps?: StreamProcessingProps
    profiling?: boolean

    Enable profiling.

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates +

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates the function. Because the execution time affects cost, set this value based on the function's expected execution time.

    Default

    Duration.seconds(3)
    @@ -286,8 +286,8 @@ 

    See

    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    +
    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    Typically you should not override this but you may need to if, for example, you are referencing a file that is shared across many apps and/or AWS accounts.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/experimental_patterns.GuSnsLambdaProps.html b/interfaces/experimental_patterns.GuSnsLambdaProps.html index 94a205526c..6e6b2bd0b0 100644 --- a/interfaces/experimental_patterns.GuSnsLambdaProps.html +++ b/interfaces/experimental_patterns.GuSnsLambdaProps.html @@ -12,7 +12,7 @@

    If your team do not use CloudWatch, it's possible to opt-out with the following configuration:

     monitoringConfiguration: { noMonitoring: true } as NoMonitoring
     
    -
    interface GuSnsLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        existingSnsTopic?: ExistingSnsTopic;
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    interface GuSnsLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        existingSnsTopic?: ExistingSnsTopic;
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? allowAllOutbound? allowPublicSubnet? app @@ -76,7 +76,7 @@

    Default

    - 
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    +
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    Default

    Architecture.X86_64
     
    bucketNamePath?: string

    SSM parameter for the S3 bucket that contains your lambda file.

    @@ -84,7 +84,7 @@

    Default

    false
     you are referencing a file that is shared across many apps and/or AWS
     accounts.

    Default Value

    [[GuDistributionBucketParameter]]

    -
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    +
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    Default

    - Not Sign the Code
     
    currentVersionOptions?: VersionOptions

    Options for the lambda.Version resource automatically created by the @@ -114,7 +114,7 @@

    Default

    false
     on versioning (e.g. SnapStart or Provisioned Concurrency).

    If you enable versioning you must ensure that your Lambda function is updated whenever a new build is deployed via CloudFormation. The simplest way to do this is to include the build number in the fileName prop.

    -
    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda +

    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda functions. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Lambda function source code.

    @@ -130,9 +130,9 @@

    Default

    false
     

    You can also add event sources using addEventSource.

    Default

    - No event sources.
     
    -
    existingSnsTopic?: ExistingSnsTopic
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. +

    existingSnsTopic?: ExistingSnsTopic
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    +
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    Default

    - will not mount any filesystem
     
    functionName?: string

    A name for the function.

    @@ -191,7 +191,7 @@

    Default

    - 
     

    Default

    128
     
    -
    onFailure?: IDestination

    The destination for failed invocations.

    +
    onFailure?: IDestination

    The destination for failed invocations.

    Default

    - no destination
     
    onSuccess?: IDestination

    The destination for successful invocations.

    @@ -253,7 +253,7 @@

    See

    See

    https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html

    -
    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates +

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates the function. Because the execution time affects cost, set this value based on the function's expected execution time.

    Default

    Duration.seconds(3)
    @@ -277,8 +277,8 @@ 

    See

    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    +
    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    Typically you should not override this but you may need to if, for example, you are referencing a file that is shared across many apps and/or AWS accounts.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.AccessLoggingProps.html b/interfaces/patterns.AccessLoggingProps.html index 1b7c8bbf75..d6a0a4d31c 100644 --- a/interfaces/patterns.AccessLoggingProps.html +++ b/interfaces/patterns.AccessLoggingProps.html @@ -1,10 +1,10 @@ -AccessLoggingProps | @guardian/cdk

    Interface AccessLoggingProps

    interface AccessLoggingProps {
        enabled: boolean;
        prefix?: string;
    }

    Properties

    enabled +AccessLoggingProps | @guardian/cdk

    Interface AccessLoggingProps

    interface AccessLoggingProps {
        enabled: boolean;
        prefix?: string;
    }

    Properties

    Properties

    enabled: boolean

    Enable (load balancer) access logs.

    Note, you will need to specify a region in your stack declaration to use this. Seehttps://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-elasticloadbalancingv2.ApplicationLoadBalancer.html#logwbraccesswbrlogsbucket-prefix

    -
    prefix?: string

    S3 prefix for the logs.

    +
    prefix?: string

    S3 prefix for the logs.

    Default Value

    no prefix
     
    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.Alarms.html b/interfaces/patterns.Alarms.html index 084da43b5c..a016a21aa8 100644 --- a/interfaces/patterns.Alarms.html +++ b/interfaces/patterns.Alarms.html @@ -1,11 +1,11 @@ -Alarms | @guardian/cdk
    interface Alarms {
        http4xxAlarm?: false | Http4xxAlarmProps;
        http5xxAlarm: false | Http5xxAlarmProps;
        noMonitoring?: false;
        snsTopicName: string;
        unhealthyInstancesAlarm: boolean;
    }

    Properties

    http4xxAlarm? +Alarms | @guardian/cdk
    interface Alarms {
        http4xxAlarm?: false | Http4xxAlarmProps;
        http5xxAlarm: false | Http5xxAlarmProps;
        noMonitoring?: false;
        snsTopicName: string;
        unhealthyInstancesAlarm: boolean;
    }

    Properties

    http4xxAlarm?: false | Http4xxAlarmProps

    Enable the 4xx alarm with settings.

    -
    http5xxAlarm: false | Http5xxAlarmProps

    Enable the 5xx alarm with settings.

    -
    noMonitoring?: false

    Internal flag - users of this library should ignore this setting.

    -
    snsTopicName: string

    Name of the target (SNS Topic) for alarm notifications.

    -
    unhealthyInstancesAlarm: boolean

    Enable the unhealthy instances alarm.

    -

    Generated using TypeDoc

    \ No newline at end of file +
    http5xxAlarm: false | Http5xxAlarmProps

    Enable the 5xx alarm with settings.

    +
    noMonitoring?: false

    Internal flag - users of this library should ignore this setting.

    +
    snsTopicName: string

    Name of the target (SNS Topic) for alarm notifications.

    +
    unhealthyInstancesAlarm: boolean

    Enable the unhealthy instances alarm.

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.ApiGatewayAlarms.html b/interfaces/patterns.ApiGatewayAlarms.html index c6cd6a0f86..1c63236a64 100644 --- a/interfaces/patterns.ApiGatewayAlarms.html +++ b/interfaces/patterns.ApiGatewayAlarms.html @@ -1,8 +1,8 @@ ApiGatewayAlarms | @guardian/cdk

    Interface ApiGatewayAlarms

    Alarm props.

    -
    interface ApiGatewayAlarms {
        http5xxAlarm: Http5xxAlarmProps;
        noMonitoring?: false;
        snsTopicName: string;
    }

    Properties

    interface ApiGatewayAlarms {
        http5xxAlarm: Http5xxAlarmProps;
        noMonitoring?: false;
        snsTopicName: string;
    }

    Properties

    http5xxAlarm: Http5xxAlarmProps

    Configuration the 5xx alarm.

    -
    noMonitoring?: false

    Internal flag - users of this library should ignore this setting.

    -
    snsTopicName: string

    (SNS) Topic name where alarm notifications will be sent.

    -

    Generated using TypeDoc

    \ No newline at end of file +
    noMonitoring?: false

    Internal flag - users of this library should ignore this setting.

    +
    snsTopicName: string

    (SNS) Topic name where alarm notifications will be sent.

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.ApiTarget.html b/interfaces/patterns.ApiTarget.html index aca681651b..db749af92d 100644 --- a/interfaces/patterns.ApiTarget.html +++ b/interfaces/patterns.ApiTarget.html @@ -1,10 +1,10 @@ ApiTarget | @guardian/cdk

    API target props.

    -
    interface ApiTarget {
        apiKeyRequired?: true;
        httpMethod: HttpMethod;
        lambda: GuLambdaFunction;
        path: string;
    }

    Properties

    interface ApiTarget {
        apiKeyRequired?: true;
        httpMethod: HttpMethod;
        lambda: GuLambdaFunction;
        path: string;
    }

    Properties

    apiKeyRequired?: true

    Whether an apiKey is required for this method.

    -
    httpMethod: HttpMethod

    The [[HttpMethod]] for the target (e.g. GET, POST, PUT).

    -

    The Lambda function responsible for handling the request.

    -
    path: string

    The path for the request (e.g. /test).

    -

    Generated using TypeDoc

    \ No newline at end of file +
    httpMethod: HttpMethod

    The [[HttpMethod]] for the target (e.g. GET, POST, PUT).

    +

    The Lambda function responsible for handling the request.

    +
    path: string

    The path for the request (e.g. /test).

    +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.ApplicationLoggingProps.html b/interfaces/patterns.ApplicationLoggingProps.html index b9b5ecf4c4..95d93cf844 100644 --- a/interfaces/patterns.ApplicationLoggingProps.html +++ b/interfaces/patterns.ApplicationLoggingProps.html @@ -8,7 +8,7 @@

    Unless you have explicitly opted-out, appropriate IAM permissions for logging to Kinesis will be configured automatically via the [[GuEc2App]] pattern.

    -
    interface ApplicationLoggingProps {
        enabled: boolean;
        systemdUnitName?: string;
    }

    Properties

    interface ApplicationLoggingProps {
        enabled: boolean;
        systemdUnitName?: string;
    }

    Properties

    enabled: boolean

    Enables forwarding of application logs to the Guardian ELK stack.

    Note, to work, you will need to also do the following non-CDK things:

    @@ -22,7 +22,7 @@ logging to Kinesis will be configured automatically via the [[GuEc2App]] pattern.

    systemdUnitName?: string

    This needs to match the name of your SystemD unit.

    +
    systemdUnitName?: string

    This needs to match the name of your SystemD unit.

    If your systemd unit is not <app>.service set this value.

    Default Value

    <app>.service

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.GuApiGatewayWithLambdaByPathProps.html b/interfaces/patterns.GuApiGatewayWithLambdaByPathProps.html index 813e545670..dbb1f59c5b 100644 --- a/interfaces/patterns.GuApiGatewayWithLambdaByPathProps.html +++ b/interfaces/patterns.GuApiGatewayWithLambdaByPathProps.html @@ -1,4 +1,4 @@ -GuApiGatewayWithLambdaByPathProps | @guardian/cdk

    Interface GuApiGatewayWithLambdaByPathProps

    interface GuApiGatewayWithLambdaByPathProps {
        apiKeySourceType?: ApiKeySourceType;
        app: string;
        binaryMediaTypes?: string[];
        cloneFrom?: IRestApi;
        cloudWatchRole?: boolean;
        cloudWatchRoleRemovalPolicy?: RemovalPolicy;
        defaultCorsPreflightOptions?: CorsOptions;
        defaultIntegration?: Integration;
        defaultMethodOptions?: MethodOptions;
        deploy?: boolean;
        deployOptions?: StageOptions;
        description?: string;
        disableExecuteApiEndpoint?: boolean;
        domainName?: DomainNameOptions;
        endpointConfiguration?: EndpointConfiguration;
        endpointExportName?: string;
        endpointTypes?: EndpointType[];
        failOnWarnings?: boolean;
        minCompressionSize?: Size;
        minimumCompressionSize?: number;
        monitoringConfiguration: NoMonitoring | ApiGatewayAlarms;
        parameters?: {
            [key: string]: string;
        };
        policy?: PolicyDocument;
        restApiName?: string;
        retainDeployments?: boolean;
        targets: ApiTarget[];
    }

    Hierarchy

    • RestApiProps
    • AppIdentity
      • GuApiGatewayWithLambdaByPathProps

    Properties

    apiKeySourceType? +GuApiGatewayWithLambdaByPathProps | @guardian/cdk

    Interface GuApiGatewayWithLambdaByPathProps

    interface GuApiGatewayWithLambdaByPathProps {
        apiKeySourceType?: ApiKeySourceType;
        app: string;
        binaryMediaTypes?: string[];
        cloneFrom?: IRestApi;
        cloudWatchRole?: boolean;
        cloudWatchRoleRemovalPolicy?: RemovalPolicy;
        defaultCorsPreflightOptions?: CorsOptions;
        defaultIntegration?: Integration;
        defaultMethodOptions?: MethodOptions;
        deploy?: boolean;
        deployOptions?: StageOptions;
        description?: string;
        disableExecuteApiEndpoint?: boolean;
        domainName?: DomainNameOptions;
        endpointConfiguration?: EndpointConfiguration;
        endpointExportName?: string;
        endpointTypes?: EndpointType[];
        failOnWarnings?: boolean;
        minCompressionSize?: Size;
        minimumCompressionSize?: number;
        monitoringConfiguration: NoMonitoring | ApiGatewayAlarms;
        parameters?: {
            [key: string]: string;
        };
        policy?: PolicyDocument;
        restApiName?: string;
        retainDeployments?: boolean;
        targets: ApiTarget[];
    }

    Hierarchy

    • RestApiProps
    • AppIdentity
      • GuApiGatewayWithLambdaByPathProps

    Properties

    Default

    - Metering is disabled.
     
    -
    app: string
    binaryMediaTypes?: string[]

    The list of binary media mime-types that are supported by the RestApi +

    app: string
    binaryMediaTypes?: string[]

    The list of binary media mime-types that are supported by the RestApi resource, such as "image/png" or "application/octet-stream"

    Default

    - RestApi supports only UTF-8-encoded text payloads.
     
    @@ -130,7 +130,7 @@

    Deprecated

      If your team do not use CloudWatch, it's possible to opt-out with the following configuration:

       monitoringConfiguration: { noMonitoring: true }
       
      -
    parameters?: {
        [key: string]: string;
    }

    Custom header parameters for the request.

    +
    parameters?: {
        [key: string]: string;
    }

    Custom header parameters for the request.

    Type declaration

    • [key: string]: string

    See

    https://docs.aws.amazon.com/cli/latest/reference/apigateway/import-rest-api.html

    Default

    - No parameters.
     
    @@ -146,4 +146,4 @@

    Default

    - 

    Default

    false
     
    targets: ApiTarget[]

    A list of [[ApiTarget]]s to configure for the API Gateway instance.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.GuApiLambdaProps.html b/interfaces/patterns.GuApiLambdaProps.html index 21730cfb47..f8a16adc4e 100644 --- a/interfaces/patterns.GuApiLambdaProps.html +++ b/interfaces/patterns.GuApiLambdaProps.html @@ -1,4 +1,4 @@ -GuApiLambdaProps | @guardian/cdk

    Interface GuApiLambdaProps

    interface GuApiLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        api: ApiProps;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: NoMonitoring | ApiGatewayAlarms;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? +GuApiLambdaProps | @guardian/cdk

    Interface GuApiLambdaProps

    interface GuApiLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        api: ApiProps;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: NoMonitoring | ApiGatewayAlarms;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? allowAllOutbound? allowPublicSubnet? api @@ -63,7 +63,7 @@

    Default

    - Default
    false
     
    api: ApiProps

    [[LambdaRestApiProps]] to configure for the lambda.

    -
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    +
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    Default

    Architecture.X86_64
     
    bucketNamePath?: string

    SSM parameter for the S3 bucket that contains your lambda file.

    @@ -71,7 +71,7 @@

    Default

    false
     you are referencing a file that is shared across many apps and/or AWS
     accounts.

    Default Value

    [[GuDistributionBucketParameter]]

    -
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    +
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    Default

    - Not Sign the Code
     
    currentVersionOptions?: VersionOptions

    Options for the lambda.Version resource automatically created by the @@ -101,7 +101,7 @@

    Default

    false
     on versioning (e.g. SnapStart or Provisioned Concurrency).

    If you enable versioning you must ensure that your Lambda function is updated whenever a new build is deployed via CloudFormation. The simplest way to do this is to include the build number in the fileName prop.

    -
    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda +

    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda functions. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Lambda function source code.

    @@ -119,7 +119,7 @@

    Default

    false
     
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    +
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    Default

    - will not mount any filesystem
     
    functionName?: string

    A name for the function.

    @@ -182,7 +182,7 @@

    Default

    - If your team do not use CloudWatch, it's possible to opt-out with the following configuration:

     monitoringConfiguration: { noMonitoring: true }
     
    -
    onFailure?: IDestination

    The destination for failed invocations.

    +
    onFailure?: IDestination

    The destination for failed invocations.

    Default

    - no destination
     
    onSuccess?: IDestination

    The destination for successful invocations.

    @@ -244,7 +244,7 @@

    See

    See

    https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html

    -
    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates +

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates the function. Because the execution time affects cost, set this value based on the function's expected execution time.

    Default

    Duration.seconds(3)
    @@ -268,8 +268,8 @@ 

    See

    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    +
    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    Typically you should not override this but you may need to if, for example, you are referencing a file that is shared across many apps and/or AWS accounts.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.GuEc2AppProps.html b/interfaces/patterns.GuEc2AppProps.html index e631cac88d..685062c804 100644 --- a/interfaces/patterns.GuEc2AppProps.html +++ b/interfaces/patterns.GuEc2AppProps.html @@ -1,4 +1,4 @@ -GuEc2AppProps | @guardian/cdk

    Interface GuEc2AppProps

    interface GuEc2AppProps {
        access: AppAccess;
        accessLogging?: AccessLoggingProps;
        app: string;
        applicationLogging?: ApplicationLoggingProps;
        applicationPort: number;
        blockDevices?: BlockDevice[];
        certificateProps?: GuDomainName;
        googleAuth?: {
            allowedGroups?: string[];
            credentialsSecretsManagerPath?: string;
            domain: string;
            enabled: true;
            sessionTimeoutInMinutes?: number;
        };
        healthcheck?: HealthCheck;
        imageRecipe?: string | AmigoProps;
        instanceMetadataHopLimit?: number;
        instanceType: InstanceType;
        monitoringConfiguration: NoMonitoring | Alarms;
        privateSubnets?: ISubnet[];
        publicSubnets?: ISubnet[];
        roleConfiguration?: GuInstanceRoleProps;
        scaling: GuAsgCapacity;
        userData: string | GuUserDataProps;
        vpc?: IVpc;
        withoutImdsv2?: boolean;
    }

    Hierarchy

    Properties

    access +GuEc2AppProps | @guardian/cdk

    Interface GuEc2AppProps

    interface GuEc2AppProps {
        access: AppAccess;
        accessLogging?: AccessLoggingProps;
        app: string;
        applicationLogging?: ApplicationLoggingProps;
        applicationPort: number;
        blockDevices?: BlockDevice[];
        certificateProps?: GuDomainName;
        googleAuth?: {
            allowedGroups?: string[];
            credentialsSecretsManagerPath?: string;
            domain: string;
            enabled: true;
            sessionTimeoutInMinutes?: number;
        };
        healthcheck?: HealthCheck;
        imageRecipe?: string | AmigoProps;
        instanceMetadataHopLimit?: number;
        instanceType: InstanceType;
        monitoringConfiguration: NoMonitoring | Alarms;
        privateSubnets?: ISubnet[];
        publicSubnets?: ISubnet[];
        roleConfiguration?: GuInstanceRoleProps;
        scaling: GuAsgCapacity;
        userData: string | GuUserDataProps;
        vpc?: IVpc;
        withoutImdsv2?: boolean;
    }

    Hierarchy

    Properties

    access accessLogging? app applicationLogging? @@ -22,12 +22,12 @@

    Note, this merely provides defence in depth; you should, for example, limit access to the VPN and then treat that as sufficient. Instead, use Google Auth for human access, or a suitable machine auth mechanism.

    -
    accessLogging?: AccessLoggingProps

    Enable and configures access logs.

    -
    app: string
    applicationLogging?: ApplicationLoggingProps

    Enable and configures application logs.

    -
    applicationPort: number

    The port your application runs on.

    -
    blockDevices?: BlockDevice[]

    Add block devices (additional storage).

    -
    certificateProps?: GuDomainName

    Specify certificate for the load balancer.

    -
    googleAuth?: {
        allowedGroups?: string[];
        credentialsSecretsManagerPath?: string;
        domain: string;
        enabled: true;
        sessionTimeoutInMinutes?: number;
    }

    Configure Google Auth.

    +
    accessLogging?: AccessLoggingProps

    Enable and configures access logs.

    +
    app: string
    applicationLogging?: ApplicationLoggingProps

    Enable and configures application logs.

    +
    applicationPort: number

    The port your application runs on.

    +
    blockDevices?: BlockDevice[]

    Add block devices (additional storage).

    +
    certificateProps?: GuDomainName

    Specify certificate for the load balancer.

    +
    googleAuth?: {
        allowedGroups?: string[];
        credentialsSecretsManagerPath?: string;
        domain: string;
        enabled: true;
        sessionTimeoutInMinutes?: number;
    }

    Configure Google Auth.

    Type declaration

    • Optional allowedGroups?: string[]

      Groups used for membership checks.

      If specified, cannot be empty. Users must be a member of at least one group to gain access.

      @@ -61,23 +61,23 @@

      Default Value

      /:STAGE
       

      NOTE: This value cannot be larger than 60 minutes.

      Default Value

      15
       
      -
    healthcheck?: HealthCheck

    Specify custom healthcheck

    -
    imageRecipe?: string | AmigoProps

    Configure AMIgo image recipe. This is only necessary if you are using GuCDK to generate your riff-raff.yaml file.

    -
    instanceMetadataHopLimit?: number

    Set http put response hop limit for the launch template. +

    healthcheck?: HealthCheck

    Specify custom healthcheck

    +
    imageRecipe?: string | AmigoProps

    Configure AMIgo image recipe. This is only necessary if you are using GuCDK to generate your riff-raff.yaml file.

    +
    instanceMetadataHopLimit?: number

    Set http put response hop limit for the launch template. It can be necessary to raise this value from the default of 1 for example when sharing the instance profile with a docker container running on the instance.

    -
    instanceType: InstanceType

    EC2 instance type. Note, ensure your code is built for the same +

    instanceType: InstanceType

    EC2 instance type. Note, ensure your code is built for the same architecture family (arm64 - 'Graviton' instances - or x64).

    -
    monitoringConfiguration: NoMonitoring | Alarms

    Enable and configure alarms.

    -
    privateSubnets?: ISubnet[]

    Specify private subnets if using a non-default VPC or (generally +

    monitoringConfiguration: NoMonitoring | Alarms

    Enable and configure alarms.

    +
    privateSubnets?: ISubnet[]

    Specify private subnets if using a non-default VPC or (generally discouraged) to limit to a subset of the available subnets.

    -
    publicSubnets?: ISubnet[]

    Specify private subnets if using a non-default VPC or (generally +

    publicSubnets?: ISubnet[]

    Specify private subnets if using a non-default VPC or (generally discouraged) to limit to a subset of the available subnets.

    -
    roleConfiguration?: GuInstanceRoleProps

    Configure IAM roles for autoscaling group EC2 instances.

    -
    scaling: GuAsgCapacity

    Autoscaling group min and max sizes.

    -
    userData: string | GuUserDataProps

    User data for the autoscaling group.

    -
    vpc?: IVpc

    Specify the VPC to use.

    +
    roleConfiguration?: GuInstanceRoleProps

    Configure IAM roles for autoscaling group EC2 instances.

    +
    scaling: GuAsgCapacity

    Autoscaling group min and max sizes.

    +
    userData: string | GuUserDataProps

    User data for the autoscaling group.

    +
    vpc?: IVpc

    Specify the VPC to use.

    withoutImdsv2?: boolean

    Disable imdsv2. Most of the time you should not set this.

    +
    withoutImdsv2?: boolean

    Disable imdsv2. Most of the time you should not set this.

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.GuScheduledEcsTaskProps.html b/interfaces/patterns.GuScheduledEcsTaskProps.html index 0c33dfde8f..499d96a366 100644 --- a/interfaces/patterns.GuScheduledEcsTaskProps.html +++ b/interfaces/patterns.GuScheduledEcsTaskProps.html @@ -27,7 +27,7 @@ VERSION environment variable. Alternatively, you could hard code a value for the variable in CDK. See https://docs.aws.amazon.com/step-functions/latest/dg/connect-ecs.html for further detail and other override options - this construct currently only supports environment variables.

    -
    interface GuScheduledEcsTaskProps {
        app: string;
        containerConfiguration: ContainerConfiguration;
        cpu?: number;
        customTaskPolicies?: PolicyStatement[];
        enableDistributablePolicy?: boolean;
        environmentOverrides?: TaskEnvironmentVariable[];
        memory?: number;
        monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps;
        schedule: Schedule;
        securityGroups?: ISecurityGroup[];
        storage?: number;
        taskCommand?: string;
        taskTimeoutInMinutes?: number;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    app +
    interface GuScheduledEcsTaskProps {
        app: string;
        containerConfiguration: ContainerConfiguration;
        cpu?: number;
        customTaskPolicies?: PolicyStatement[];
        enableDistributablePolicy?: boolean;
        environmentOverrides?: TaskEnvironmentVariable[];
        memory?: number;
        monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps;
        schedule: Schedule;
        securityGroups?: ISecurityGroup[];
        storage?: number;
        taskCommand?: string;
        taskTimeoutInMinutes?: number;
        vpc: IVpc;
    }

    Hierarchy

    Properties

    app: string
    containerConfiguration: ContainerConfiguration
    cpu?: number
    customTaskPolicies?: PolicyStatement[]
    enableDistributablePolicy?: boolean

    Whether to give the task IAM role access to the account's dist bucket. +

    Properties

    app: string
    containerConfiguration: ContainerConfiguration
    cpu?: number
    customTaskPolicies?: PolicyStatement[]
    enableDistributablePolicy?: boolean

    Whether to give the task IAM role access to the account's dist bucket. This is enabled by default to avoid breaking changes, but consumers of this pattern that pull a container image that doesn't need extra dependencies from S3 shoud set this value to false.

    -
    environmentOverrides?: TaskEnvironmentVariable[]
    memory?: number
    monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps
    schedule: Schedule

    Schedule for the task.

    +
    environmentOverrides?: TaskEnvironmentVariable[]
    memory?: number
    monitoringConfiguration: NoMonitoring | GuEcsTaskMonitoringProps
    schedule: Schedule

    Schedule for the task.

    E.g.:

    • Schedule.expression("cron(0 8 ? * MON-FRI *)")
    • Schedule.rate(Duration.minutes(5))
    -
    securityGroups?: ISecurityGroup[]
    storage?: number
    taskCommand?: string
    taskTimeoutInMinutes?: number
    vpc: IVpc

    Generated using TypeDoc

    \ No newline at end of file +
    securityGroups?: ISecurityGroup[]
    storage?: number
    taskCommand?: string
    taskTimeoutInMinutes?: number
    vpc: IVpc

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/patterns.GuScheduledLambdaProps.html b/interfaces/patterns.GuScheduledLambdaProps.html index d71f0d6284..9c0b48941b 100644 --- a/interfaces/patterns.GuScheduledLambdaProps.html +++ b/interfaces/patterns.GuScheduledLambdaProps.html @@ -1,4 +1,4 @@ -GuScheduledLambdaProps | @guardian/cdk

    Interface GuScheduledLambdaProps

    interface GuScheduledLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        rules: {
            description?: string;
            schedule: Schedule;
        }[];
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? +GuScheduledLambdaProps | @guardian/cdk

    Interface GuScheduledLambdaProps

    interface GuScheduledLambdaProps {
        adotInstrumentation?: AdotInstrumentationConfig;
        allowAllOutbound?: boolean;
        allowPublicSubnet?: boolean;
        app: string;
        architecture?: Architecture;
        bucketNamePath?: string;
        codeSigningConfig?: ICodeSigningConfig;
        currentVersionOptions?: VersionOptions;
        deadLetterQueue?: IQueue;
        deadLetterQueueEnabled?: boolean;
        deadLetterTopic?: ITopic;
        description?: string;
        enableVersioning?: boolean;
        environment?: {
            [key: string]: string;
        };
        environmentEncryption?: IKey;
        ephemeralStorageSize?: Size;
        events?: IEventSource[];
        fileName: string;
        filesystem?: FileSystem;
        functionName?: string;
        handler: string;
        initialPolicy?: PolicyStatement[];
        insightsVersion?: LambdaInsightsVersion;
        layers?: ILayerVersion[];
        logRetention?: RetentionDays;
        logRetentionRetryOptions?: LogRetentionRetryOptions;
        logRetentionRole?: IRole;
        maxEventAge?: Duration;
        memorySize?: number;
        monitoringConfiguration: GuLambdaErrorPercentageMonitoringProps | NoMonitoring;
        onFailure?: IDestination;
        onSuccess?: IDestination;
        paramsAndSecrets?: ParamsAndSecretsLayerVersion;
        profiling?: boolean;
        profilingGroup?: IProfilingGroup;
        reservedConcurrentExecutions?: number;
        retryAttempts?: number;
        role?: IRole;
        rules: {
            description?: string;
            schedule: Schedule;
        }[];
        runtime: Runtime;
        runtimeManagementMode?: RuntimeManagementMode;
        securityGroups?: ISecurityGroup[];
        snapStart?: SnapStartConf;
        throttlingMonitoring?: GuLambdaThrottlingMonitoringProps;
        timeout?: Duration;
        tracing?: Tracing;
        vpc?: IVpc;
        vpcSubnets?: SubnetSelection;
        withoutArtifactUpload?: boolean;
        withoutFilePrefix?: boolean;
    }

    Hierarchy

    Properties

    adotInstrumentation? allowAllOutbound? allowPublicSubnet? app @@ -62,7 +62,7 @@

    Default

    - 
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    +
    app: string
    architecture?: Architecture

    The system architectures compatible with this lambda function.

    Default

    Architecture.X86_64
     
    bucketNamePath?: string

    SSM parameter for the S3 bucket that contains your lambda file.

    @@ -70,7 +70,7 @@

    Default

    false
     you are referencing a file that is shared across many apps and/or AWS
     accounts.

    Default Value

    [[GuDistributionBucketParameter]]

    -
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    +
    codeSigningConfig?: ICodeSigningConfig

    Code signing config associated with this function

    Default

    - Not Sign the Code
     
    currentVersionOptions?: VersionOptions

    Options for the lambda.Version resource automatically created by the @@ -100,7 +100,7 @@

    Default

    false
     on versioning (e.g. SnapStart or Provisioned Concurrency).

    If you enable versioning you must ensure that your Lambda function is updated whenever a new build is deployed via CloudFormation. The simplest way to do this is to include the build number in the fileName prop.

    -
    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda +

    environment?: {
        [key: string]: string;
    }

    Key-value pairs that Lambda caches and makes available for your Lambda functions. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Lambda function source code.

    @@ -118,7 +118,7 @@

    Default

    false
     
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    +
    filesystem?: FileSystem

    The filesystem configuration for the lambda function

    Default

    - will not mount any filesystem
     
    functionName?: string

    A name for the function.

    @@ -179,7 +179,7 @@

    Default

    - 

    Monitoring configuration for the lambda.

    Opting-out via the NoMonitoring type is supported but discouraged.

    -
    onFailure?: IDestination

    The destination for failed invocations.

    +
    onFailure?: IDestination

    The destination for failed invocations.

    Default

    - no destination
     
    onSuccess?: IDestination

    The destination for successful invocations.

    @@ -229,7 +229,7 @@

    See

    runtime: Runtime

    The runtime environment for the Lambda function that you are uploading. +

    runtime: Runtime

    The runtime environment for the Lambda function that you are uploading. For valid values, see the Runtime property in the AWS Lambda Developer Guide.

    Use Runtime.FROM_IMAGE when defining a function from a Docker image.

    @@ -248,7 +248,7 @@

    See

    See

    https://docs.aws.amazon.com/lambda/latest/dg/concurrent-executions.html

    -
    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates +

    timeout?: Duration

    The function execution time (in seconds) after which Lambda terminates the function. Because the execution time affects cost, set this value based on the function's expected execution time.

    Default

    Duration.seconds(3)
    @@ -272,8 +272,8 @@ 

    See

    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    +
    withoutFilePrefix?: boolean

    Set to true to use the filename without the stage/stack/app prefix.

    Typically you should not override this but you may need to if, for example, you are referencing a file that is shared across many apps and/or AWS accounts.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.Access.html b/interfaces/types.Access.html index ccc2d0abea..b3a5121169 100644 --- a/interfaces/types.Access.html +++ b/interfaces/types.Access.html @@ -1,2 +1,2 @@ -Access | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +Access | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.GuAsgCapacity.html b/interfaces/types.GuAsgCapacity.html index 72fa3e059a..36c4370f43 100644 --- a/interfaces/types.GuAsgCapacity.html +++ b/interfaces/types.GuAsgCapacity.html @@ -1,4 +1,4 @@ -GuAsgCapacity | @guardian/cdk

    Interface GuAsgCapacity

    interface GuAsgCapacity {
        maximumInstances?: number;
        minimumInstances: number;
    }

    Hierarchy

    Properties

    maximumInstances? +GuAsgCapacity | @guardian/cdk

    Interface GuAsgCapacity

    interface GuAsgCapacity {
        maximumInstances?: number;
        minimumInstances: number;
    }

    Hierarchy

    Properties

    maximumInstances?: number

    The maximum number of EC2 instances. If omitted, this will be set to minimumInstances * 2. @@ -6,6 +6,6 @@

    Should only be set if you need to scale beyond the default limit (e.g. due to heavy traffic), or restrict scaling for a specific reason.

    Note: If minimumInstances is defined with a Mapping maximumInstances must also be defined as a Mapping.

    -
    minimumInstances: number

    The number of EC2 instances running under normal circumstances, +

    minimumInstances: number

    The number of EC2 instances running under normal circumstances, i.e. when there are no deployment or scaling events in progress.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.GuDistributable.html b/interfaces/types.GuDistributable.html index c3f0e75b9c..db8258934c 100644 --- a/interfaces/types.GuDistributable.html +++ b/interfaces/types.GuDistributable.html @@ -1,4 +1,4 @@ -GuDistributable | @guardian/cdk

    Interface GuDistributable

    interface GuDistributable {
        fileName: string;
    }

    Properties

    fileName +GuDistributable | @guardian/cdk

    Interface GuDistributable

    interface GuDistributable {
        fileName: string;
    }

    Properties

    Properties

    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.GuDistributableForEc2.html b/interfaces/types.GuDistributableForEc2.html index d058ef27b3..78dea0c83f 100644 --- a/interfaces/types.GuDistributableForEc2.html +++ b/interfaces/types.GuDistributableForEc2.html @@ -1,7 +1,7 @@ -GuDistributableForEc2 | @guardian/cdk

    Interface GuDistributableForEc2

    interface GuDistributableForEc2 {
        executionStatement: string;
        fileName: string;
    }

    Hierarchy

    Properties

    executionStatement +GuDistributableForEc2 | @guardian/cdk

    Interface GuDistributableForEc2

    interface GuDistributableForEc2 {
        executionStatement: string;
        fileName: string;
    }

    Hierarchy

    Properties

    executionStatement: string

    The command to run fileName. For example dpkg -i application.deb or service foo start.

    -
    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. +

    fileName: string

    The filename for an executable package within the bucket [[GuDistributionBucketParameter]]. We'll look for fileName on the path "bucket/stack/stage/app/".

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.GuDomainName.html b/interfaces/types.GuDomainName.html index 9dacb204f6..1126d595cd 100644 --- a/interfaces/types.GuDomainName.html +++ b/interfaces/types.GuDomainName.html @@ -1,8 +1,8 @@ -GuDomainName | @guardian/cdk

    Interface GuDomainName

    interface GuDomainName {
        domainName: string;
        hostedZoneId?: string;
    }

    Hierarchy

    Properties

    domainName +GuDomainName | @guardian/cdk

    Interface GuDomainName

    interface GuDomainName {
        domainName: string;
        hostedZoneId?: string;
    }

    Hierarchy

    Properties

    domainName: string

    The Fully Qualified Domain Name.

    Example

    "riff-raff.gutools.co.uk"
     
    -
    hostedZoneId?: string

    Route53 Zone ID.

    +
    hostedZoneId?: string

    Route53 Zone ID.

    To be provided only if the zone for domainName is managed by Route53.

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.InternalAccess.html b/interfaces/types.InternalAccess.html index 3f48c0a371..c167a6bff6 100644 --- a/interfaces/types.InternalAccess.html +++ b/interfaces/types.InternalAccess.html @@ -4,6 +4,6 @@

    Example usage:

    {
    scope: AccessScope.INTERNAL,
    cidrRanges: [Peer.ipv4("10.0.0.0/8")]
    }
    -
    interface InternalAccess {
        cidrRanges: IPeer[];
        scope: INTERNAL;
    }

    Hierarchy

    Properties

    interface InternalAccess {
        cidrRanges: IPeer[];
        scope: INTERNAL;
    }

    Hierarchy

    Properties

    Properties

    cidrRanges: IPeer[]
    scope: INTERNAL

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    cidrRanges: IPeer[]
    scope: INTERNAL

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.PublicAccess.html b/interfaces/types.PublicAccess.html index 1614a37c46..3747509766 100644 --- a/interfaces/types.PublicAccess.html +++ b/interfaces/types.PublicAccess.html @@ -4,5 +4,5 @@

    Example usage:

    { scope: AccessScope.PUBLIC }
     
    -
    interface PublicAccess {
        scope: PUBLIC;
    }

    Hierarchy

    Properties

    Properties

    scope: PUBLIC

    Generated using TypeDoc

    \ No newline at end of file +
    interface PublicAccess {
        scope: PUBLIC;
    }

    Hierarchy

    Properties

    Properties

    scope: PUBLIC

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/types.RestrictedAccess.html b/interfaces/types.RestrictedAccess.html index 55181e49f4..6d481f7d46 100644 --- a/interfaces/types.RestrictedAccess.html +++ b/interfaces/types.RestrictedAccess.html @@ -3,6 +3,6 @@

    Example usage:

    {
    scope: AccessScope.RESTRICTED,
    cidrRanges: [Peer.ipv4("192.168.1.1/32"), Peer.ipv4("8.8.8.8/32")]
    }
    -
    interface RestrictedAccess {
        cidrRanges: IPeer[];
        scope: RESTRICTED;
    }

    Hierarchy

    Properties

    interface RestrictedAccess {
        cidrRanges: IPeer[];
        scope: RESTRICTED;
    }

    Hierarchy

    Properties

    Properties

    cidrRanges: IPeer[]
    scope: RESTRICTED

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    cidrRanges: IPeer[]
    scope: RESTRICTED

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/utils_ec2.GuPrivateS3ConfigurationProps.html b/interfaces/utils_ec2.GuPrivateS3ConfigurationProps.html index 1c06812816..b054a408ca 100644 --- a/interfaces/utils_ec2.GuPrivateS3ConfigurationProps.html +++ b/interfaces/utils_ec2.GuPrivateS3ConfigurationProps.html @@ -1,6 +1,6 @@ GuPrivateS3ConfigurationProps | @guardian/cdk

    Interface GuPrivateS3ConfigurationProps

    Information about an ec2 app's private configuration. files are paths from the root of the bucket. TODO change this once we have defined best practice for configuration.

    -
    interface GuPrivateS3ConfigurationProps {
        bucket: GuPrivateConfigBucketParameter;
        files: string[];
    }

    Properties

    interface GuPrivateS3ConfigurationProps {
        bucket: GuPrivateConfigBucketParameter;
        files: string[];
    }

    Properties

    Properties

    files: string[]

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    files: string[]

    Generated using TypeDoc

    \ No newline at end of file diff --git a/interfaces/utils_lambda.StreamErrorHandlingProps.html b/interfaces/utils_lambda.StreamErrorHandlingProps.html index c129bcd2b8..3279c746c4 100644 --- a/interfaces/utils_lambda.StreamErrorHandlingProps.html +++ b/interfaces/utils_lambda.StreamErrorHandlingProps.html @@ -7,8 +7,8 @@

    Records which could not be processed successfully can (optionally) be sent to a dead letter queue via deadLetterQueueForSkippedRecords.

    -
    interface StreamErrorHandlingProps {
        bisectBatchOnError: boolean;
        blockProcessingAndRetryIndefinitely?: false;
        deadLetterQueueForSkippedRecords?: IEventSourceDlq;
        retryBehaviour: StreamRetry;
    }

    Properties

    interface StreamErrorHandlingProps {
        bisectBatchOnError: boolean;
        blockProcessingAndRetryIndefinitely?: false;
        deadLetterQueueForSkippedRecords?: IEventSourceDlq;
        retryBehaviour: StreamRetry;
    }

    Properties

    bisectBatchOnError: boolean
    blockProcessingAndRetryIndefinitely?: false
    deadLetterQueueForSkippedRecords?: IEventSourceDlq
    retryBehaviour: StreamRetry

    Generated using TypeDoc

    \ No newline at end of file +

    Properties

    bisectBatchOnError: boolean
    blockProcessingAndRetryIndefinitely?: false
    deadLetterQueueForSkippedRecords?: IEventSourceDlq
    retryBehaviour: StreamRetry

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constants.html b/modules/constants.html index 3af02297cd..f05a545d56 100644 --- a/modules/constants.html +++ b/modules/constants.html @@ -1,4 +1,4 @@ -constants | @guardian/cdk

    Module constants

    Index

    Enumerations

    AccessScope +constants | @guardian/cdk

    Module constants

    Index

    Enumerations

    Interfaces

    Variables

    ALL_SSM_PARAMETER_PATHS ContextKeys diff --git a/modules/constructs_acm.html b/modules/constructs_acm.html index 463999e119..9babd0dbd2 100644 --- a/modules/constructs_acm.html +++ b/modules/constructs_acm.html @@ -1,3 +1,3 @@ -constructs/acm | @guardian/cdk

    Module constructs/acm

    Index

    Classes

    GuCertificate +constructs/acm | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_autoscaling.html b/modules/constructs_autoscaling.html index 5220cc7e47..d250d45d3f 100644 --- a/modules/constructs_autoscaling.html +++ b/modules/constructs_autoscaling.html @@ -1,4 +1,4 @@ -constructs/autoscaling | @guardian/cdk

    Module constructs/autoscaling

    Index

    Classes

    GuAutoScalingGroup +constructs/autoscaling | @guardian/cdk

    Module constructs/autoscaling

    Index

    Classes

    Interfaces

    GuAutoScalingGroupProps GuUserDataProps diff --git a/modules/constructs_cloudwatch.html b/modules/constructs_cloudwatch.html index d61b2b02d4..8f836d4686 100644 --- a/modules/constructs_cloudwatch.html +++ b/modules/constructs_cloudwatch.html @@ -1,4 +1,4 @@ -constructs/cloudwatch | @guardian/cdk

    Module constructs/cloudwatch

    Index

    Classes

    GuAlarm +constructs/cloudwatch | @guardian/cdk

    Module constructs/cloudwatch

    Index

    Classes

    GuAlarm GuAlb4xxPercentageAlarm GuAlb5xxPercentageAlarm GuLambdaErrorPercentageAlarm diff --git a/modules/constructs_core.html b/modules/constructs_core.html index 521c19acf0..0604fe98c7 100644 --- a/modules/constructs_core.html +++ b/modules/constructs_core.html @@ -1,4 +1,4 @@ -constructs/core | @guardian/cdk

    Module constructs/core

    Index

    Classes

    GuAmiParameter +constructs/core | @guardian/cdk

    Module constructs/core

    Index

    Classes

    GuAmiParameter GuAnghammaradTopicParameter GuArnParameter GuCertificateArnParameter diff --git a/modules/constructs_dns.html b/modules/constructs_dns.html index 15713406b0..6116d43d4b 100644 --- a/modules/constructs_dns.html +++ b/modules/constructs_dns.html @@ -1,4 +1,4 @@ -constructs/dns | @guardian/cdk

    Module constructs/dns

    Index

    Enumerations

    RecordType +constructs/dns | @guardian/cdk

    Module constructs/dns

    Index

    Enumerations

    Classes

    Interfaces

    GuCnameProps diff --git a/modules/constructs_ec2.html b/modules/constructs_ec2.html index 81a89d19b4..00287fc34c 100644 --- a/modules/constructs_ec2.html +++ b/modules/constructs_ec2.html @@ -1,4 +1,4 @@ -constructs/ec2 | @guardian/cdk

    Module constructs/ec2

    Index

    Enumerations

    SubnetType +constructs/ec2 | @guardian/cdk

    Module constructs/ec2

    Index

    Enumerations

    Classes

    GuBaseSecurityGroup GuHttpsEgressSecurityGroup GuSecurityGroup diff --git a/modules/constructs_ecs.html b/modules/constructs_ecs.html index 98910c505e..36eaf9689d 100644 --- a/modules/constructs_ecs.html +++ b/modules/constructs_ecs.html @@ -1,4 +1,4 @@ -constructs/ecs | @guardian/cdk

    Module constructs/ecs

    Index

    Classes

    GuEcsTask +constructs/ecs | @guardian/cdk

    Module constructs/ecs

    Index

    Classes

    Interfaces

    Type Aliases

    ContainerConfiguration GuEcsTaskMonitoringProps diff --git a/modules/constructs_iam.html b/modules/constructs_iam.html index 5ee46249e9..004253951f 100644 --- a/modules/constructs_iam.html +++ b/modules/constructs_iam.html @@ -1,4 +1,4 @@ -constructs/iam | @guardian/cdk

    Module constructs/iam

    Index

    Classes

    GuAllowPolicy +constructs/iam | @guardian/cdk

    Module constructs/iam

    Index

    Classes

    GuAllowPolicy GuAnghammaradSenderPolicy GuAssumeRolePolicy GuDenyPolicy diff --git a/modules/constructs_kinesis.html b/modules/constructs_kinesis.html index ad359cf448..30f57fedad 100644 --- a/modules/constructs_kinesis.html +++ b/modules/constructs_kinesis.html @@ -1,3 +1,3 @@ -constructs/kinesis | @guardian/cdk

    Module constructs/kinesis

    Index

    Classes

    GuKinesisStream +constructs/kinesis | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_lambda.html b/modules/constructs_lambda.html index ad82c0cc54..658a2f8f20 100644 --- a/modules/constructs_lambda.html +++ b/modules/constructs_lambda.html @@ -1,3 +1,3 @@ -constructs/lambda | @guardian/cdk

    Module constructs/lambda

    Index

    Classes

    GuLambdaFunction +constructs/lambda | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_loadbalancing.html b/modules/constructs_loadbalancing.html index 0e19f7cd78..97cf7d7c13 100644 --- a/modules/constructs_loadbalancing.html +++ b/modules/constructs_loadbalancing.html @@ -1,4 +1,4 @@ -constructs/loadbalancing | @guardian/cdk

    Module constructs/loadbalancing

    Index

    Classes

    GuApplicationListener +constructs/loadbalancing | @guardian/cdk

    Module constructs/loadbalancing

    Index

    Classes

    GuApplicationListener GuApplicationLoadBalancer GuApplicationTargetGroup GuHttpsApplicationListener diff --git a/modules/constructs_rds.html b/modules/constructs_rds.html index 1eb1eb3d4b..97b4b5519d 100644 --- a/modules/constructs_rds.html +++ b/modules/constructs_rds.html @@ -1,3 +1,3 @@ -constructs/rds | @guardian/cdk

    Module constructs/rds

    Index

    Classes

    GuDatabaseInstance +constructs/rds | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_s3.html b/modules/constructs_s3.html index 5e49c29923..3d69737c4e 100644 --- a/modules/constructs_s3.html +++ b/modules/constructs_s3.html @@ -1,3 +1,3 @@ -constructs/s3 | @guardian/cdk

    Module constructs/s3

    Index

    Classes

    GuS3Bucket +constructs/s3 | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_ses.html b/modules/constructs_ses.html index 37e633db71..6541c9d264 100644 --- a/modules/constructs_ses.html +++ b/modules/constructs_ses.html @@ -1,3 +1,3 @@ -constructs/ses | @guardian/cdk

    Module constructs/ses

    Index

    Classes

    GuEmailIdentity +constructs/ses | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_stack_set.html b/modules/constructs_stack_set.html index c6c686d510..8ccccfb07d 100644 --- a/modules/constructs_stack_set.html +++ b/modules/constructs_stack_set.html @@ -1,2 +1,2 @@ -constructs/stack-set | @guardian/cdk

    Module constructs/stack-set

    Index

    Classes

    GuStackSet +constructs/stack-set | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/constructs_vpc.html b/modules/constructs_vpc.html index 2d029ced36..86e445ac03 100644 --- a/modules/constructs_vpc.html +++ b/modules/constructs_vpc.html @@ -1,3 +1,3 @@ -constructs/vpc | @guardian/cdk

    Module constructs/vpc

    Index

    Classes

    GuVpc +constructs/vpc | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/experimental_patterns.html b/modules/experimental_patterns.html index 517b11f49a..944df2d208 100644 --- a/modules/experimental_patterns.html +++ b/modules/experimental_patterns.html @@ -1,4 +1,4 @@ -experimental/patterns | @guardian/cdk

    Module experimental/patterns

    Index

    Classes

    GuKinesisLambdaExperimental +experimental/patterns | @guardian/cdk

    Module experimental/patterns

    Index

    Classes

    Interfaces

    ExistingKinesisStream ExistingSnsTopic diff --git a/modules/patterns.html b/modules/patterns.html index bd0c7b41bf..2950e1bf81 100644 --- a/modules/patterns.html +++ b/modules/patterns.html @@ -1,4 +1,4 @@ -patterns | @guardian/cdk

    Module patterns

    Index

    Classes

    GuApiGatewayWithLambdaByPath +patterns | @guardian/cdk

    Module patterns

    Index

    Classes

    GuApiGatewayWithLambdaByPath GuApiLambda GuEc2App GuNodeApp diff --git a/modules/types.html b/modules/types.html index 9dafdf6262..d1c65f8341 100644 --- a/modules/types.html +++ b/modules/types.html @@ -1,4 +1,4 @@ -types | @guardian/cdk

    Module types

    Index

    Interfaces

    Access +types | @guardian/cdk

    Module types

    Index

    Interfaces

    Access GuAsgCapacity GuDistributable GuDistributableForEc2 diff --git a/modules/utils_ec2.html b/modules/utils_ec2.html index 4592cdc711..298913b644 100644 --- a/modules/utils_ec2.html +++ b/modules/utils_ec2.html @@ -1,2 +1,2 @@ -utils/ec2 | @guardian/cdk

    Module utils/ec2

    Index

    Interfaces

    GuPrivateS3ConfigurationProps +utils/ec2 | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/utils_lambda.html b/modules/utils_lambda.html index 8d61328843..0dc4802690 100644 --- a/modules/utils_lambda.html +++ b/modules/utils_lambda.html @@ -1,4 +1,4 @@ -utils/lambda | @guardian/cdk

    Module utils/lambda

    Index

    Classes

    StreamRetry +utils/lambda | @guardian/cdk

    Module utils/lambda

    Index

    Classes

    Interfaces

    Type Aliases

    Functions

    toAwsErrorHandlingProps diff --git a/modules/utils_security_groups.html b/modules/utils_security_groups.html index 9b75fca988..57d4d445d3 100644 --- a/modules/utils_security_groups.html +++ b/modules/utils_security_groups.html @@ -1,2 +1,2 @@ -utils/security-groups | @guardian/cdk

    Module utils/security-groups

    Index

    Functions

    transformToSecurityGroupAccessRule +utils/security-groups | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/modules/utils_test.html b/modules/utils_test.html index 3ff8ed6c22..aca14c1b8e 100644 --- a/modules/utils_test.html +++ b/modules/utils_test.html @@ -1,4 +1,4 @@ -utils/test | @guardian/cdk

    Module utils/test

    Index

    Classes

    GuTemplate +utils/test | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_acm.GuCertificatePropsWithApp.html b/types/constructs_acm.GuCertificatePropsWithApp.html index ecdd4a6163..9089086588 100644 --- a/types/constructs_acm.GuCertificatePropsWithApp.html +++ b/types/constructs_acm.GuCertificatePropsWithApp.html @@ -1 +1 @@ -GuCertificatePropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuCertificatePropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_autoscaling.GuUserDataPropsWithApp.html b/types/constructs_autoscaling.GuUserDataPropsWithApp.html index d77358aad8..292ec3cf6d 100644 --- a/types/constructs_autoscaling.GuUserDataPropsWithApp.html +++ b/types/constructs_autoscaling.GuUserDataPropsWithApp.html @@ -1 +1 @@ -GuUserDataPropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuUserDataPropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_core.GuNoTypeParameterProps.html b/types/constructs_core.GuNoTypeParameterProps.html index 521a195dab..a0eda522c0 100644 --- a/types/constructs_core.GuNoTypeParameterProps.html +++ b/types/constructs_core.GuNoTypeParameterProps.html @@ -1 +1 @@ -GuNoTypeParameterProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuNoTypeParameterProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_core.GuNoTypeParameterPropsWithAppIdentity.html b/types/constructs_core.GuNoTypeParameterPropsWithAppIdentity.html index 1c21217d64..6844dfa89b 100644 --- a/types/constructs_core.GuNoTypeParameterPropsWithAppIdentity.html +++ b/types/constructs_core.GuNoTypeParameterPropsWithAppIdentity.html @@ -1 +1 @@ -GuNoTypeParameterPropsWithAppIdentity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuNoTypeParameterPropsWithAppIdentity | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_ecs.ContainerConfiguration.html b/types/constructs_ecs.ContainerConfiguration.html index af640db4f9..73dd9bcc6d 100644 --- a/types/constructs_ecs.ContainerConfiguration.html +++ b/types/constructs_ecs.ContainerConfiguration.html @@ -1 +1 @@ -ContainerConfiguration | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +ContainerConfiguration | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_ecs.GuEcsTaskMonitoringProps.html b/types/constructs_ecs.GuEcsTaskMonitoringProps.html index 54cc996251..33fe731c0c 100644 --- a/types/constructs_ecs.GuEcsTaskMonitoringProps.html +++ b/types/constructs_ecs.GuEcsTaskMonitoringProps.html @@ -1 +1 @@ -GuEcsTaskMonitoringProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuEcsTaskMonitoringProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_ecs.RegistryContainer.html b/types/constructs_ecs.RegistryContainer.html index e5ff1bbaf8..7bda760c50 100644 --- a/types/constructs_ecs.RegistryContainer.html +++ b/types/constructs_ecs.RegistryContainer.html @@ -1 +1 @@ -RegistryContainer | @guardian/cdk
    RegistryContainer: {
        id?: string;
        imageProps?: RepositoryImageProps;
        type: "registry";
    }

    Type declaration

    • Optional id?: string
    • Optional imageProps?: RepositoryImageProps
    • type: "registry"

    Generated using TypeDoc

    \ No newline at end of file +RegistryContainer | @guardian/cdk
    RegistryContainer: {
        id?: string;
        imageProps?: RepositoryImageProps;
        type: "registry";
    }

    Type declaration

    • Optional id?: string
    • Optional imageProps?: RepositoryImageProps
    • type: "registry"

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_ecs.RepositoryContainer.html b/types/constructs_ecs.RepositoryContainer.html index ff136bd27c..7a0463a2bc 100644 --- a/types/constructs_ecs.RepositoryContainer.html +++ b/types/constructs_ecs.RepositoryContainer.html @@ -5,4 +5,4 @@

    Alternatively you can specify a repository and version, for example for an ECR repository:

    import { Repository } from "aws-cdk-lib/aws-ecr";
    const repository = new Repository(scope, `${app}-repository`, {
    repositoryName: app,
    });
    const containerConfiguration = {
    repository: Repository.fromRepositoryArn("<repository arn>"),
    version: '1'
    }
    -

    Type declaration

    • repository: IRepository
    • type: "repository"
    • version: string

    Generated using TypeDoc

    \ No newline at end of file +

    Type declaration

    • repository: IRepository
    • type: "repository"
    • version: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_iam.GuDenyPolicyProps.html b/types/constructs_iam.GuDenyPolicyProps.html index 15e51ec93a..f307d768aa 100644 --- a/types/constructs_iam.GuDenyPolicyProps.html +++ b/types/constructs_iam.GuDenyPolicyProps.html @@ -1 +1 @@ -GuDenyPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuDenyPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_iam.GuInstanceRolePropsWithApp.html b/types/constructs_iam.GuInstanceRolePropsWithApp.html index 2db1ede217..691566eec6 100644 --- a/types/constructs_iam.GuInstanceRolePropsWithApp.html +++ b/types/constructs_iam.GuInstanceRolePropsWithApp.html @@ -1 +1 @@ -GuInstanceRolePropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuInstanceRolePropsWithApp | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_iam.GuNoStatementsPolicyProps.html b/types/constructs_iam.GuNoStatementsPolicyProps.html index c2624726de..ff5c3c8cde 100644 --- a/types/constructs_iam.GuNoStatementsPolicyProps.html +++ b/types/constructs_iam.GuNoStatementsPolicyProps.html @@ -1 +1 @@ -GuNoStatementsPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuNoStatementsPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_iam.GuPolicyProps.html b/types/constructs_iam.GuPolicyProps.html index beaf1368a8..8592bd7035 100644 --- a/types/constructs_iam.GuPolicyProps.html +++ b/types/constructs_iam.GuPolicyProps.html @@ -1 +1 @@ -GuPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuPolicyProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_iam.GuRoleProps.html b/types/constructs_iam.GuRoleProps.html index aa06701e18..872c84b2c6 100644 --- a/types/constructs_iam.GuRoleProps.html +++ b/types/constructs_iam.GuRoleProps.html @@ -1 +1 @@ -GuRoleProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuRoleProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_kinesis.GuKinesisStreamProps.html b/types/constructs_kinesis.GuKinesisStreamProps.html index 692033e7fe..d09b072362 100644 --- a/types/constructs_kinesis.GuKinesisStreamProps.html +++ b/types/constructs_kinesis.GuKinesisStreamProps.html @@ -1 +1 @@ -GuKinesisStreamProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuKinesisStreamProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/constructs_vpc.GuVpcProps.html b/types/constructs_vpc.GuVpcProps.html index 067dbf29f5..bf95114fd3 100644 --- a/types/constructs_vpc.GuVpcProps.html +++ b/types/constructs_vpc.GuVpcProps.html @@ -1 +1 @@ -GuVpcProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +GuVpcProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/patterns.HttpMethod.html b/types/patterns.HttpMethod.html index e0decee9b5..ab21b566bf 100644 --- a/types/patterns.HttpMethod.html +++ b/types/patterns.HttpMethod.html @@ -1,2 +1,2 @@ HttpMethod | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/types.AppAccess.html b/types/types.AppAccess.html index f2e63dcaed..d349548e2b 100644 --- a/types/types.AppAccess.html +++ b/types/types.AppAccess.html @@ -1 +1 @@ -AppAccess | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +AppAccess | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/types/utils_lambda.StreamProcessingProps.html b/types/utils_lambda.StreamProcessingProps.html index 93a0837755..a9db752974 100644 --- a/types/utils_lambda.StreamProcessingProps.html +++ b/types/utils_lambda.StreamProcessingProps.html @@ -1 +1 @@ -StreamProcessingProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +StreamProcessingProps | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.ALL_SSM_PARAMETER_PATHS.html b/variables/constants.ALL_SSM_PARAMETER_PATHS.html index 453dcf4099..e1e532006e 100644 --- a/variables/constants.ALL_SSM_PARAMETER_PATHS.html +++ b/variables/constants.ALL_SSM_PARAMETER_PATHS.html @@ -1 +1 @@ -ALL_SSM_PARAMETER_PATHS | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +ALL_SSM_PARAMETER_PATHS | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.ContextKeys.html b/variables/constants.ContextKeys.html index 048ea6ca6e..49f3577478 100644 --- a/variables/constants.ContextKeys.html +++ b/variables/constants.ContextKeys.html @@ -1,2 +1,2 @@ ContextKeys | @guardian/cdk

    Variable ContextKeysConst

    ContextKeys: {
        REPOSITORY_URL: string;
    } = ...

    A list of items we will read from the CDK context

    -

    Type declaration

    • REPOSITORY_URL: string

    Generated using TypeDoc

    \ No newline at end of file +

    Type declaration

    • REPOSITORY_URL: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.FASTLY_AWS_ACCOUNT_ID.html b/variables/constants.FASTLY_AWS_ACCOUNT_ID.html index f33c9c1fee..f7bfa39e95 100644 --- a/variables/constants.FASTLY_AWS_ACCOUNT_ID.html +++ b/variables/constants.FASTLY_AWS_ACCOUNT_ID.html @@ -2,4 +2,4 @@ This is needed by IAM roles assumed by Fastly in order to write into an S3 bucket or a Kinesis stream. See https://docs.fastly.com/en/guides/creating-an-aws-iam-role-for-fastly-logging

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.LibraryInfo.html b/variables/constants.LibraryInfo.html index 218dc72c0c..742637efb8 100644 --- a/variables/constants.LibraryInfo.html +++ b/variables/constants.LibraryInfo.html @@ -4,4 +4,4 @@ You need to match this version exactly.

  • NAME: string

    The name of this package

  • VERSION: string

    The current version of @guardian/cdk.

    -
  • Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.MetadataKeys.html b/variables/constants.MetadataKeys.html index 0d256b053e..baee057bca 100644 --- a/variables/constants.MetadataKeys.html +++ b/variables/constants.MetadataKeys.html @@ -1 +1 @@ -MetadataKeys | @guardian/cdk

    Variable MetadataKeysConst

    MetadataKeys: {
        CONSTRUCTS_KEY: string;
        LOG_KINESIS_STREAM_NAME: string;
        REPOSITORY_NAME: string;
        SYSTEMD_UNIT: string;
        VERSION: string;
    } = ...

    Type declaration

    • CONSTRUCTS_KEY: string
    • LOG_KINESIS_STREAM_NAME: string
    • REPOSITORY_NAME: string
    • SYSTEMD_UNIT: string
    • VERSION: string

    Generated using TypeDoc

    \ No newline at end of file +MetadataKeys | @guardian/cdk

    Variable MetadataKeysConst

    MetadataKeys: {
        CONSTRUCTS_KEY: string;
        LOG_KINESIS_STREAM_NAME: string;
        REPOSITORY_NAME: string;
        SYSTEMD_UNIT: string;
        VERSION: string;
    } = ...

    Type declaration

    • CONSTRUCTS_KEY: string
    • LOG_KINESIS_STREAM_NAME: string
    • REPOSITORY_NAME: string
    • SYSTEMD_UNIT: string
    • VERSION: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.NAMED_SSM_PARAMETER_PATHS.html b/variables/constants.NAMED_SSM_PARAMETER_PATHS.html index a97afcea4d..573734cafb 100644 --- a/variables/constants.NAMED_SSM_PARAMETER_PATHS.html +++ b/variables/constants.NAMED_SSM_PARAMETER_PATHS.html @@ -1 +1 @@ -NAMED_SSM_PARAMETER_PATHS | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +NAMED_SSM_PARAMETER_PATHS | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.RegexPattern.html b/variables/constants.RegexPattern.html index 6a31e193ff..1cd67716f6 100644 --- a/variables/constants.RegexPattern.html +++ b/variables/constants.RegexPattern.html @@ -1 +1 @@ -RegexPattern | @guardian/cdk

    Variable RegexPatternConst

    RegexPattern: {
        ACM_ARN: string;
        ARN: string;
        S3ARN: string;
    } = ...

    Type declaration

    • ACM_ARN: string
    • ARN: string
    • S3ARN: string

    Generated using TypeDoc

    \ No newline at end of file +RegexPattern | @guardian/cdk

    Variable RegexPatternConst

    RegexPattern: {
        ACM_ARN: string;
        ARN: string;
        S3ARN: string;
    } = ...

    Type declaration

    • ACM_ARN: string
    • ARN: string
    • S3ARN: string

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.TrackingTag.html b/variables/constants.TrackingTag.html index c1424403de..88ad2ad062 100644 --- a/variables/constants.TrackingTag.html +++ b/variables/constants.TrackingTag.html @@ -1 +1 @@ -TrackingTag | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +TrackingTag | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constants.VPC_SSM_PARAMETER_PREFIX.html b/variables/constants.VPC_SSM_PARAMETER_PREFIX.html index da3c1d7c80..c54cc2bfa7 100644 --- a/variables/constants.VPC_SSM_PARAMETER_PREFIX.html +++ b/variables/constants.VPC_SSM_PARAMETER_PREFIX.html @@ -1 +1 @@ -VPC_SSM_PARAMETER_PREFIX | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file +VPC_SSM_PARAMETER_PREFIX | @guardian/cdk

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/constructs_core.AppIdentity-1.html b/variables/constructs_core.AppIdentity-1.html index eff615a0ca..3024a11df2 100644 --- a/variables/constructs_core.AppIdentity-1.html +++ b/variables/constructs_core.AppIdentity-1.html @@ -1 +1 @@ -AppIdentity | @guardian/cdk
    AppIdentity: {
        isAppIdentity(props): props is AppIdentity;
        suffixText(appIdentity, text): string;
        taggedConstruct<T>(appIdentity, construct): T;
    }

    Type declaration

    Generated using TypeDoc

    \ No newline at end of file +AppIdentity | @guardian/cdk
    AppIdentity: {
        isAppIdentity(props): props is AppIdentity;
        suffixText(appIdentity, text): string;
        taggedConstruct<T>(appIdentity, construct): T;
    }

    Type declaration

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/types.AppAccess-1.html b/variables/types.AppAccess-1.html index c7021c209e..4441617975 100644 --- a/variables/types.AppAccess-1.html +++ b/variables/types.AppAccess-1.html @@ -3,4 +3,4 @@ Restricted - Must not include global CIDR ranges as doing so makes other listed CIDR ranges redundant Internal - All CIDR ranges must start 10.

    Parameters

    Returns void

    Throws

    Error when CIDR rules are invalid

    -

    Generated using TypeDoc

    \ No newline at end of file +

    Generated using TypeDoc

    \ No newline at end of file diff --git a/variables/types.GuDistributable-1.html b/variables/types.GuDistributable-1.html index d222ba4e22..3ff499e94e 100644 --- a/variables/types.GuDistributable-1.html +++ b/variables/types.GuDistributable-1.html @@ -1 +1 @@ -GuDistributable | @guardian/cdk

    Variable GuDistributable

    GuDistributable: {
        getObjectKey(__namedParameters, __namedParameters, __namedParameters): string;
    }

    Type declaration

    Generated using TypeDoc

    \ No newline at end of file +GuDistributable | @guardian/cdk

    Variable GuDistributable

    GuDistributable: {
        getObjectKey(__namedParameters, __namedParameters, __namedParameters): string;
    }

    Type declaration

    Generated using TypeDoc

    \ No newline at end of file