ProviderProps

All Known Implementing Classes:: ProviderProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:45.245Z")
public interface ProviderProps

Initialization properties for the `Provider` construct.

Example:

 import software.amazon.awscdk.customresources.*;
 import software.amazon.awscdk.services.lambda.*;
 import software.amazon.awscdk.core.Stack;
 Function myOnEventLambda;
 Function myIsCompleteLambda;
 Stack stack = new Stack();
 Provider provider = Provider.Builder.create(stack, "myProvider")
         .onEventHandler(myOnEventLambda)
         .isCompleteHandler(myIsCompleteLambda)
         .build();

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static class`	`ProviderProps.Builder` A builder for `ProviderProps`
`static class`	`ProviderProps.Jsii$Proxy` An implementation for `ProviderProps`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static ProviderProps.Builder`	`builder()`
`default IFunction`	`getIsCompleteHandler()` The AWS Lambda function to invoke in order to determine if the operation is complete.
`default RetentionDays`	`getLogRetention()` The number of days framework log events are kept in CloudWatch Logs.
`IFunction`	`getOnEventHandler()` The AWS Lambda function to invoke for all resource lifecycle operations (CREATE/UPDATE/DELETE).
`default java.lang.String`	`getProviderFunctionName()` Provider Lambda name.
`default Duration`	`getQueryInterval()` Time between calls to the `isComplete` handler which determines if the resource has been stabilized.
`default IRole`	`getRole()` AWS Lambda execution role.
`default java.util.List<ISecurityGroup>`	`getSecurityGroups()` Security groups to attach to the provider functions.
`default Duration`	`getTotalTimeout()` Total timeout for the entire operation.
`default IVpc`	`getVpc()` The vpc to provision the lambda functions in.
`default SubnetSelection`	`getVpcSubnets()` Which subnets from the VPC to place the lambda functions in.

- Method Detail
  - getOnEventHandler
```
IFunction getOnEventHandler()
```
    The AWS Lambda function to invoke for all resource lifecycle operations (CREATE/UPDATE/DELETE).
    This function is responsible to begin the requested resource operation (CREATE/UPDATE/DELETE) and return any additional properties to add to the event, which will later be passed to isComplete. The PhysicalResourceId property must be included in the response.
  - getIsCompleteHandler
```
default IFunction getIsCompleteHandler()
```
    The AWS Lambda function to invoke in order to determine if the operation is complete.
    This function will be called immediately after onEvent and then periodically based on the configured query interval as long as it returns false. If the function still returns false and the alloted timeout has passed, the operation will fail.
    Default: - provider is synchronous. This means that the `onEvent` handler is expected to finish all lifecycle operations within the initial invocation.
  - getLogRetention
```
default RetentionDays getLogRetention()
```
    The number of days framework log events are kept in CloudWatch Logs.
    When updating this property, unsetting it doesn't remove the log retention policy. To remove the retention policy, set the value to INFINITE.
    Default: logs.RetentionDays.INFINITE
  - getProviderFunctionName
```
default java.lang.String getProviderFunctionName()
```
    Provider Lambda name.
    The provider lambda function name.
    Default: - CloudFormation default name from unique physical ID
  - getQueryInterval
```
default Duration getQueryInterval()
```
    Time between calls to the `isComplete` handler which determines if the resource has been stabilized.
    The first isComplete will be called immediately after handler and then every queryInterval seconds, and until timeout has been reached or until isComplete returns true.
    Default: Duration.seconds(5)
  - getRole
```
default IRole getRole()
```
    AWS Lambda execution role.
    The role that will be assumed by the AWS Lambda. Must be assumable by the 'lambda.amazonaws.com' service principal.
    Default: - A default role will be created.
  - getSecurityGroups
```
default java.util.List<ISecurityGroup> getSecurityGroups()
```
    Security groups to attach to the provider functions.
    Only used if 'vpc' is supplied
    Default: - If `vpc` is not supplied, no security groups are attached. Otherwise, a dedicated security group is created for each function.
  - getTotalTimeout
```
default Duration getTotalTimeout()
```
    Total timeout for the entire operation.
    The maximum timeout is 2 hours (yes, it can exceed the AWS Lambda 15 minutes)
    Default: Duration.minutes(30)
  - getVpc
```
default IVpc getVpc()
```
    The vpc to provision the lambda functions in.
    Default: - functions are not provisioned inside a vpc.
  - getVpcSubnets
```
default SubnetSelection getVpcSubnets()
```
    Which subnets from the VPC to place the lambda functions in.
    Only used if 'vpc' is supplied. Note: internet access for Lambdas requires a NAT gateway, so picking Public subnets is not allowed.
    Default: - the Vpc default strategy if not specified
  - builder
```
static ProviderProps.Builder builder()
```
    Returns:
    
    a ProviderProps.Builder of ProviderProps

Interface ProviderProps

Nested Class Summary

Method Summary

Method Detail

getOnEventHandler

getIsCompleteHandler

getLogRetention

getProviderFunctionName

getQueryInterval

getRole

getSecurityGroups

getTotalTimeout

getVpc

getVpcSubnets

builder