@aws-sdk/client-lambda

import type { StreamingBlobTypes } from "@smithy/types"; import type { ApplicationLogLevel, Architecture, CapacityProviderPredefinedMetricType, CapacityProviderScalingMode, CapacityProviderState, CodeSigningPolicy, EndPointType, EventSourceMappingMetric, EventSourceMappingSystemLogLevel, EventSourcePosition, EventType, ExecutionStatus, FullDocument, FunctionResponseType, FunctionUrlAuthType, FunctionVersion, FunctionVersionLatestPublished, InvocationType, InvokeMode, KafkaSchemaRegistryAuthType, KafkaSchemaValidationAttribute, LastUpdateStatus, LastUpdateStatusReasonCode, LogFormat, LogType, OperationAction, OperationStatus, OperationType, PackageType, ProvisionedConcurrencyStatusEnum, RecursiveLoop, ResponseStreamingInvocationType, Runtime, SchemaRegistryEventRecordFormat, SnapStartApplyOn, SnapStartOptimizationStatus, SourceAccessType, State, StateReasonCode, SystemLogLevel, TenantIsolationMode, TracingMode, UpdateRuntimeOn } from "./enums"; /** * Limits that are related to concurrency and storage. All file and storage sizes are in bytes. * @public */ export interface AccountLimit { /** * The amount of storage space that you can use for all deployment packages and layer archives. * @public */ TotalCodeSize?: number | undefined; /** * The maximum size of a function's deployment package and layers when they're extracted. * @public */ CodeSizeUnzipped?: number | undefined; /** * The maximum size of a deployment package when it's uploaded directly to Lambda. Use Amazon S3 for larger files. * @public */ CodeSizeZipped?: number | undefined; /** * The maximum number of simultaneous function executions. * @public */ ConcurrentExecutions?: number | undefined; /** * The maximum number of simultaneous function executions, minus the capacity that's reserved for individual functions with <a>PutFunctionConcurrency</a>. * @public */ UnreservedConcurrentExecutions?: number | undefined; } /** * The number of functions and amount of storage in use. * @public */ export interface AccountUsage { /** * The amount of storage space, in bytes, that's being used by deployment packages and layer archives. * @public */ TotalCodeSize?: number | undefined; /** * The number of Lambda functions. * @public */ FunctionCount?: number | undefined; } /** * @public */ export interface AddLayerVersionPermissionRequest { /** * The name or Amazon Resource Name (ARN) of the layer. * @public */ LayerName: string | undefined; /** * The version number. * @public */ VersionNumber: number | undefined; /** * An identifier that distinguishes the policy from others on the same layer version. * @public */ StatementId: string | undefined; /** * The API action that grants access to the layer. For example, <code>lambda:GetLayerVersion</code>. * @public */ Action: string | undefined; /** * An account ID, or <code>*</code> to grant layer usage permission to all accounts in an organization, or all Amazon Web Services accounts (if <code>organizationId</code> is not specified). For the last case, make sure that you really do want all Amazon Web Services accounts to have usage permission to this layer. * @public */ Principal: string | undefined; /** * With the principal set to <code>*</code>, grant permission to all accounts in the specified organization. * @public */ OrganizationId?: string | undefined; /** * Only update the policy if the revision ID matches the ID specified. Use this option to avoid modifying a policy that has changed since you last read it. * @public */ RevisionId?: string | undefined; } /** * @public */ export interface AddLayerVersionPermissionResponse { /** * The permission statement. * @public */ Statement?: string | undefined; /** * A unique identifier for the current revision of the policy. * @public */ RevisionId?: string | undefined; } /** * @public */ export interface AddPermissionRequest { /** * The name or ARN of the Lambda function, version, or alias. Name formats <ul> <li> Function name – <code>my-function</code> (name-only), <code>my-function:v1</code> (with alias). </li> <li> Function ARN – <code>arn:aws:lambda:us-west-2:123456789012:function:my-function</code>. </li> <li> Partial ARN – <code>123456789012:function:my-function</code>. </li> </ul> You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. * @public */ FunctionName: string | undefined; /** * A statement identifier that differentiates the statement from others in the same policy. * @public */ StatementId: string | undefined; /** * The action that the principal can use on the function. For example, <code>lambda:InvokeFunction</code> or <code>lambda:GetFunction</code>. * @public */ Action: string | undefined; /** * The Amazon Web Services service, Amazon Web Services account, IAM user, or IAM role that invokes the function. If you specify a service, use <code>SourceArn</code> or <code>SourceAccount</code> to limit who can invoke the function through that service. * @public */ Principal: string | undefined; /** * For Amazon Web Services services, the ARN of the Amazon Web Services resource that invokes the function. For example, an Amazon S3 bucket or Amazon SNS topic. Note that Lambda configures the comparison using the <code>StringLike</code> operator. * @public */ SourceArn?: string | undefined; /** * For Amazon Web Services service, the ID of the Amazon Web Services account that owns the resource. Use this together with <code>SourceArn</code> to ensure that the specified account owns the resource. It is possible for an Amazon S3 bucket to be deleted by its owner and recreated by another account. * @public */ SourceAccount?: string | undefined; /** * For Alexa Smart Home functions, a token that the invoker must supply. * @public */ EventSourceToken?: string | undefined; /** * Specify a version or alias to add permissions to a published version of the function. * @public */ Qualifier?: string | undefined; /** * Update the policy only if the revision ID matches the ID that's specified. Use this option to avoid modifying a policy that has changed since you last read it. * @public */ RevisionId?: string | undefined; /** * The identifier for your organization in Organizations. Use this to grant permissions to all the Amazon Web Services accounts under this organization. * @public */ PrincipalOrgID?: string | undefined; /** * The type of authentication that your function URL uses. Set to <code>AWS_IAM</code> if you want to restrict access to authenticated users only. Set to <code>NONE</code> if you want to bypass IAM authentication to create a public endpoint. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/urls-auth.html">Control access to Lambda function URLs</a>. * @public */ FunctionUrlAuthType?: FunctionUrlAuthType | undefined; /** * Indicates whether the permission applies when the function is invoked through a function URL. * @public */ InvokedViaFunctionUrl?: boolean | undefined; } /** * @public */ export interface AddPermissionResponse { /** * The permission statement that's added to the function policy. * @public */ Statement?: string | undefined; } /** * The <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html">traffic-shifting</a> configuration of a Lambda function alias. * @public */ export interface AliasRoutingConfiguration { /** * The second version, and the percentage of traffic that's routed to it. * @public */ AdditionalVersionWeights?: Record<string, number> | undefined; } /** * Provides configuration information about a Lambda function <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html">alias</a>. * @public */ export interface AliasConfiguration { /** * The Amazon Resource Name (ARN) of the alias. * @public */ AliasArn?: string | undefined; /** * The name of the alias. * @public */ Name?: string | undefined; /** * The function version that the alias invokes. * @public */ FunctionVersion?: string | undefined; /** * A description of the alias. * @public */ Description?: string | undefined; /** * The <a href="https://docs.aws.amazon.com/lambda/latest/dg/lambda-traffic-shifting-using-aliases.html">routing configuration</a> of the alias. * @public */ RoutingConfig?: AliasRoutingConfiguration | undefined; /** * A unique identifier that changes when you update the alias. * @public */ RevisionId?: string | undefined; } /** * List of signing profiles that can sign a code package. * @public */ export interface AllowedPublishers { /** * The Amazon Resource Name (ARN) for each of the signing profiles. A signing profile defines a trusted user who can sign a code package. * @public */ SigningProfileVersionArns: string[] | undefined; } /** * Specific access configuration settings that tell Lambda how to authenticate with your schema registry. If you're working with an Glue schema registry, don't provide authentication details in this object. Instead, ensure that your execution role has the required permissions for Lambda to access your cluster. If you're working with a Confluent schema registry, choose the authentication method in the <code>Type</code> field, and provide the Secrets Manager secret ARN in the <code>URI</code> field. * @public */ export interface KafkaSchemaRegistryAccessConfig { /** * The type of authentication Lambda uses to access your schema registry. * @public */ Type?: KafkaSchemaRegistryAuthType | undefined; /** * The URI of the secret (Secrets Manager secret ARN) to authenticate with your schema registry. * @public */ URI?: string | undefined; } /** * Specific schema validation configuration settings that tell Lambda the message attributes you want to validate and filter using your schema registry. * @public */ export interface KafkaSchemaValidationConfig { /** * The attributes you want your schema registry to validate and filter for. If you selected <code>JSON</code> as the <code>EventRecordFormat</code>, Lambda also deserializes the selected message attributes. * @public */ Attribute?: KafkaSchemaValidationAttribute | undefined; } /** * Specific configuration settings for a Kafka schema registry. * @public */ export interface KafkaSchemaRegistryConfig { /** * The URI for your schema registry. The correct URI format depends on the type of schema registry you're using. <ul> <li> For Glue schema registries, use the ARN of the registry. </li> <li> For Confluent schema registries, use the URL of the registry. </li> </ul> * @public */ SchemaRegistryURI?: string | undefined; /** * The record format that Lambda delivers to your function after schema validation. <ul> <li> Choose <code>JSON</code> to have Lambda deliver the record to your function as a standard JSON object. </li> <li> Choose <code>SOURCE</code> to have Lambda deliver the record to your function in its original source format. Lambda removes all schema metadata, such as the schema ID, before sending the record to your function. </li> </ul> * @public */ EventRecordFormat?: SchemaRegistryEventRecordFormat | undefined; /** * An array of access configuration objects that tell Lambda how to authenticate with your schema registry. * @public */ AccessConfigs?: KafkaSchemaRegistryAccessConfig[] | undefined; /** * An array of schema validation configuration objects, which tell Lambda the message attributes you want to validate and filter using your schema registry. * @public */ SchemaValidationConfigs?: KafkaSchemaValidationConfig[] | undefined; } /** * Specific configuration settings for an Amazon Managed Streaming for Apache Kafka (Amazon MSK) event source. * @public */ export interface AmazonManagedKafkaEventSourceConfig { /** * The identifier for the Kafka consumer group to join. The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-consumer-group-id">Customizable consumer group ID</a>. * @public */ ConsumerGroupId?: string | undefined; /** * Specific configuration settings for a Kafka schema registry. * @public */ SchemaRegistryConfig?: KafkaSchemaRegistryConfig | undefined; } /** * A scaling policy for the capacity provider that automatically adjusts capacity to maintain a target value for a specific metric. * @public */ export interface TargetTrackingScalingPolicy { /** * The predefined metric type to track for scaling decisions. * @public */ PredefinedMetricType: CapacityProviderPredefinedMetricType | undefined; /** * The target value for the metric that the scaling policy attempts to maintain through scaling actions. * @public */ TargetValue: number | undefined; } /** * Configuration that defines how the capacity provider scales compute instances based on demand and policies. * @public */ export interface CapacityProviderScalingConfig { /** * The maximum number of vCPUs that the capacity provider can provision across all compute instances. * @public */ MaxVCpuCount?: number | undefined; /** * The scaling mode that determines how the capacity provider responds to changes in demand. * @public */ ScalingMode?: CapacityProviderScalingMode | undefined; /** * A list of scaling policies that define how the capacity provider scales compute instances based on metrics and thresholds. * @public */ ScalingPolicies?: TargetTrackingScalingPolicy[] | undefined; } /** * Specifications that define the characteristics and constraints for compute instances used by the capacity provider. * @public */ export interface InstanceRequirements { /** * A list of supported CPU architectures for compute instances. Valid values include <code>x86_64</code> and <code>arm64</code>. * @public */ Architectures?: Architecture[] | undefined; /** * A list of EC2 instance types that the capacity provider is allowed to use. If not specified, all compatible instance types are allowed. * @public */ AllowedInstanceTypes?: string[] | undefined; /** * A list of EC2 instance types that the capacity provider should not use, even if they meet other requirements. * @public */ ExcludedInstanceTypes?: string[] | undefined; } /** * Configuration that specifies the permissions required for the capacity provider to manage compute resources. * @public */ export interface CapacityProviderPermissionsConfig { /** * The ARN of the IAM role that the capacity provider uses to manage compute instances and other Amazon Web Services resources. * @public */ CapacityProviderOperatorRoleArn: string | undefined; } /** * VPC configuration that specifies the network settings for compute instances managed by the capacity provider. * @public */ export interface CapacityProviderVpcConfig { /** * A list of subnet IDs where the capacity provider launches compute instances. * @public */ SubnetIds: string[] | undefined; /** * A list of security group IDs that control network access for compute instances managed by the capacity provider. * @public */ SecurityGroupIds: string[] | undefined; } /** * @public */ export interface CreateCapacityProviderRequest { /** * The name of the capacity provider. * @public */ CapacityProviderName: string | undefined; /** * The VPC configuration for the capacity provider, including subnet IDs and security group IDs where compute instances will be launched. * @public */ VpcConfig: CapacityProviderVpcConfig | undefined; /** * The permissions configuration that specifies the IAM role ARN used by the capacity provider to manage compute resources. * @public */ PermissionsConfig: CapacityProviderPermissionsConfig | undefined; /** * The instance requirements that specify the compute instance characteristics, including architectures and allowed or excluded instance types. * @public */ InstanceRequirements?: InstanceRequirements | undefined; /** * The scaling configuration that defines how the capacity provider scales compute instances, including maximum vCPU count and scaling policies. * @public */ CapacityProviderScalingConfig?: CapacityProviderScalingConfig | undefined; /** * The ARN of the KMS key used to encrypt data associated with the capacity provider. * @public */ KmsKeyArn?: string | undefined; /** * A list of tags to associate with the capacity provider. * @public */ Tags?: Record<string, string> | undefined; } /** * A capacity provider manages compute resources for Lambda functions. * @public */ export interface CapacityProvider { /** * The Amazon Resource Name (ARN) of the capacity provider. * @public */ CapacityProviderArn: string | undefined; /** * The current state of the capacity provider. * @public */ State: CapacityProviderState | undefined; /** * The VPC configuration for the capacity provider. * @public */ VpcConfig: CapacityProviderVpcConfig | undefined; /** * The permissions configuration for the capacity provider. * @public */ PermissionsConfig: CapacityProviderPermissionsConfig | undefined; /** * The instance requirements for compute resources managed by the capacity provider. * @public */ InstanceRequirements?: InstanceRequirements | undefined; /** * The scaling configuration for the capacity provider. * @public */ CapacityProviderScalingConfig?: CapacityProviderScalingConfig | undefined; /** * The ARN of the KMS key used to encrypt the capacity provider's resources. * @public */ KmsKeyArn?: string | undefined; /** * The date and time when the capacity provider was last modified. * @public */ LastModified?: string | undefined; } /** * @public */ export interface CreateCapacityProviderResponse { /** * Information about the capacity provider that was created. * @public */ CapacityProvider: CapacityProvider | undefined; } /** * @public */ export interface DeleteCapacityProviderRequest { /** * The name of the capacity provider to delete. * @public */ CapacityProviderName: string | undefined; } /** * @public */ export interface DeleteCapacityProviderResponse { /** * Information about the deleted capacity provider. * @public */ CapacityProvider: CapacityProvider | undefined; } /** * @public */ export interface GetCapacityProviderRequest { /** * The name of the capacity provider to retrieve. * @public */ CapacityProviderName: string | undefined; } /** * @public */ export interface GetCapacityProviderResponse { /** * Information about the capacity provider, including its configuration and current state. * @public */ CapacityProvider: CapacityProvider | undefined; } /** * @public */ export interface ListCapacityProvidersRequest { /** * Filter capacity providers by their current state. * @public */ State?: CapacityProviderState | undefined; /** * Specify the pagination token that's returned by a previous request to retrieve the next page of results. * @public */ Marker?: string | undefined; /** * The maximum number of capacity providers to return. * @public */ MaxItems?: number | undefined; } /** * @public */ export interface ListCapacityProvidersResponse { /** * A list of capacity providers in your account. * @public */ CapacityProviders: CapacityProvider[] | undefined; /** * The pagination token that's included if more results are available. * @public */ NextMarker?: string | undefined; } /** * @public */ export interface ListFunctionVersionsByCapacityProviderRequest { /** * The name of the capacity provider to list function versions for. * @public */ CapacityProviderName: string | undefined; /** * Specify the pagination token that's returned by a previous request to retrieve the next page of results. * @public */ Marker?: string | undefined; /** * The maximum number of function versions to return in the response. * @public */ MaxItems?: number | undefined; } /** * Information about a function version that uses a specific capacity provider, including its ARN and current state. * @public */ export interface FunctionVersionsByCapacityProviderListItem { /** * The Amazon Resource Name (ARN) of the function version. * @public */ FunctionArn: string | undefined; /** * The current state of the function version. * @public */ State: State | undefined; } /** * @public */ export interface ListFunctionVersionsByCapacityProviderResponse { /** * The Amazon Resource Name (ARN) of the capacity provider. * @public */ CapacityProviderArn: string | undefined; /** * A list of function versions that use the specified capacity provider. * @public */ FunctionVersions: FunctionVersionsByCapacityProviderListItem[] | undefined; /** * The pagination token that's included if more results are available. * @public */ NextMarker?: string | undefined; } /** * @public */ export interface UpdateCapacityProviderRequest { /** * The name of the capacity provider to update. * @public */ CapacityProviderName: string | undefined; /** * The updated scaling configuration for the capacity provider. * @public */ CapacityProviderScalingConfig?: CapacityProviderScalingConfig | undefined; } /** * @public */ export interface UpdateCapacityProviderResponse { /** * Information about the updated capacity provider. * @public */ CapacityProvider: CapacityProvider | undefined; } /** * Configuration options for callback operations in durable executions, including timeout settings and retry behavior. * @public */ export interface CallbackOptions { /** * The timeout for the callback operation in seconds. If not specified or set to 0, the callback has no timeout. * @public */ TimeoutSeconds?: number | undefined; /** * The heartbeat timeout for the callback operation, in seconds. If not specified or set to 0, heartbeat timeout is disabled. * @public */ HeartbeatTimeoutSeconds?: number | undefined; } /** * Configuration options for chained function invocations in durable executions, including retry settings and timeout configuration. * @public */ export interface ChainedInvokeOptions { /** * The name or ARN of the Lambda function to invoke. * @public */ FunctionName: string | undefined; /** * The tenant identifier for the chained invocation. * @public */ TenantId?: string | undefined; } /** * Configuration options for a durable execution context. * @public */ export interface ContextOptions { /** * Whether the state data of children of the completed context should be included in the invoke payload and <code>GetDurableExecutionState</code> response. * @public */ ReplayChildren?: boolean | undefined; } /** * An object that contains error information. * @public */ export interface ErrorObject { /** * A human-readable error message. * @public */ ErrorMessage?: string | undefined; /** * The error type. * @public */ ErrorType?: string | undefined; /** * Machine-readable error data. * @public */ ErrorData?: string | undefined; /** * Stack trace information for the error. * @public */ StackTrace?: string[] | undefined; } /** * Configuration options for a step operation. * @public */ export interface StepOptions { /** * The delay in seconds before the next retry attempt. * @public */ NextAttemptDelaySeconds?: number | undefined; } /** * Specifies how long to pause the durable execution. * @public */ export interface WaitOptions { /** * The duration to wait, in seconds. * @public */ WaitSeconds?: number | undefined; } /** * An update to be applied to an operation during checkpointing. * @public */ export interface OperationUpdate { /** * The unique identifier for this operation. * @public */ Id: string | undefined; /** * The unique identifier of the parent operation, if this operation is running within a child context. * @public */ ParentId?: string | undefined; /** * The customer-provided name for this operation. * @public */ Name?: string | undefined; /** * The type of operation to update. * @public */ Type: OperationType | undefined; /** * The subtype of the operation, providing additional categorization. * @public */ SubType?: string | undefined; /** * The action to take on the operation. * @public */ Action: OperationAction | undefined; /** * The payload for successful operations. * @public */ Payload?: string | undefined; /** * The error information for failed operations. * @public */ Error?: ErrorObject | undefined; /** * Options for context operations. * @public */ ContextOptions?: ContextOptions | undefined; /** * Options for step operations. * @public */ StepOptions?: StepOptions | undefined; /** * Options for wait operations. * @public */ WaitOptions?: WaitOptions | undefined; /** * Configuration options for callback operations in durable executions, including timeout settings and retry behavior. * @public */ CallbackOptions?: CallbackOptions | undefined; /** * Configuration options for chained function invocations in durable executions, including retry settings and timeout configuration. * @public */ ChainedInvokeOptions?: ChainedInvokeOptions | undefined; } /** * @public */ export interface CheckpointDurableExecutionRequest { /** * The Amazon Resource Name (ARN) of the durable execution. * @public */ DurableExecutionArn: string | undefined; /** * A unique token that identifies the current checkpoint state. This token is provided by the Lambda runtime and must be used to ensure checkpoints are applied in the correct order. Each checkpoint operation consumes this token and returns a new one. * @public */ CheckpointToken: string | undefined; /** * An array of state updates to apply during this checkpoint. Each update represents a change to the execution state, such as completing a step, starting a callback, or scheduling a timer. Updates are applied atomically as part of the checkpoint operation. * @public */ Updates?: OperationUpdate[] | undefined; /** * An optional idempotency token to ensure that duplicate checkpoint requests are handled correctly. If provided, Lambda uses this token to detect and handle duplicate requests within a 15-minute window. * @public */ ClientToken?: string | undefined; } /** * Contains details about a callback operation in a durable execution, including the callback token and timeout configuration. * @public */ export interface CallbackDetails { /** * The callback ID. Callback IDs are generated by the <code>DurableContext</code> when a durable function calls <code>ctx.waitForCallback</code>. * @public */ CallbackId?: string | undefined; /** * The response payload from the callback operation as a string. * @public */ Result?: string | undefined; /** * An error object that contains details about the failure. * @public */ Error?: ErrorObject | undefined; } /** * Contains details about a chained function invocation in a durable execution, including the target function and invocation parameters. * @public */ export interface ChainedInvokeDetails { /** * The response payload from the chained invocation. * @public */ Result?: string | undefined; /** * Details about the chained invocation failure. * @public */ Error?: ErrorObject | undefined; } /** * Details about a durable execution context. * @public */ export interface ContextDetails { /** * Whether the state data of child operations of this completed context should be included in the invoke payload and <code>GetDurableExecutionState</code> response. * @public */ ReplayChildren?: boolean | undefined; /** * The response payload from the context. * @public */ Result?: string | undefined; /** * Details about the context failure. * @public */ Error?: ErrorObject | undefined; } /** * Details about a <a href="https://docs.aws.amazon.com/lambda/latest/dg/durable-functions.html">durable execution</a>. * @public */ export interface ExecutionDetails { /** * The original input payload provided for the durable execution. * @public */ InputPayload?: string | undefined; } /** * Details about a step operation. * @public */ export interface StepDetails { /** * The current attempt number for this step. * @public */ Attempt?: number | undefined; /** * The date and time when the next attempt is scheduled, in <a href="https://www.w3.org/TR/NOTE-datetime">ISO-8601 format</a> (YYYY-MM-DDThh:mm:ss.sTZD). Only populated when the step is in a pending state. * @public */ NextAttemptTimestamp?: Date | undefined; /** * The JSON response payload from the step operation. * @public */ Result?: string | undefined; /** * Details about the step failure. * @public */ Error?: ErrorObject | undefined; } /** * Details about a wait operation. * @public */ export interface WaitDetails { /** * The date and time when the wait operation is scheduled to complete, in <a href="https://www.w3.org/TR/NOTE-datetime">ISO-8601 format</a> (YYYY-MM-DDThh:mm:ss.sTZD). * @public */ ScheduledEndTimestamp?: Date | undefined; } /** * Information about an operation within a durable execution. * @public */ export interface Operation { /** * The unique identifier for this operation. * @public */ Id: string | undefined; /** * The unique identifier of the parent operation, if this operation is running within a child context. * @public */ ParentId?: string | undefined; /** * The customer-provided name for this operation. * @public */ Name?: string | undefined; /** * The type of operation. * @public */ Type: OperationType | undefined; /** * The subtype of the operation, providing additional categorization. * @public */ SubType?: string | undefined; /** * The date and time when the operation started, in <a href="https://www.w3.org/TR/NOTE-datetime">ISO-8601 format</a> (YYYY-MM-DDThh:mm:ss.sTZD). * @public */ StartTimestamp: Date | undefined; /** * The date and time when the operation ended, in <a href="https://www.w3.org/TR/NOTE-datetime">ISO-8601 format</a> (YYYY-MM-DDThh:mm:ss.sTZD). * @public */ EndTimestamp?: Date | undefined; /** * The current status of the operation. * @public */ Status: OperationStatus | undefined; /** * Details about the execution, if this operation represents an execution. * @public */ ExecutionDetails?: ExecutionDetails | undefined; /** * Details about the context, if this operation represents a context. * @public */ ContextDetails?: ContextDetails | undefined; /** * Details about the step, if this operation represents a step. * @public */ StepDetails?: StepDetails | undefined; /** * Details about the wait operation, if this operation represents a wait. * @public */ WaitDetails?: WaitDetails | undefined; /** * Contains details about a callback operation in a durable execution, including the callback token and timeout configuration. * @public */ CallbackDetails?: CallbackDetails | undefined; /** * Contains details about a chained function invocation in a durable execution, including the target function and invocation parameters. * @public */ ChainedInvokeDetails?: ChainedInvokeDetails | undefined; } /** * Contains operations that have been updated since the last checkpoint, such as completed asynchronous work like timers or callbacks. * @public */ export interface CheckpointUpdatedExecutionState { /** * A list of operations that have been updated since the last checkpoint. * @public */ Operations?: Operation[] | undefined; /** * Indicates that more results are available. Use this value in a subsequent call to retrieve the next page of results. * @public */ NextMarker?: string | undefined; } /** * The response from the CheckpointDurableExecution operation. * @public */ export interface CheckpointDurableExecutionResponse { /** * A new checkpoint token to use for the next checkpoint operation. This token replaces the one provided in the request and must be used for subsequent checkpoints to maintain proper ordering. * @public */ CheckpointToken?: string | undefined; /** * Updated execution state information that includes any changes that occurred since the last checkpoint, such as completed callbacks or expired timers. This allows the SDK to update its internal state during replay. * @public */ NewExecutionState: CheckpointUpdatedExecutionState | undefined; } /** * Code signing configuration <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html#config-codesigning-policies">policies</a> specify the validation failure action for signature mismatch or expiry. * @public */ export interface CodeSigningPolicies { /** * Code signing configuration policy for deployment validation failure. If you set the policy to <code>Enforce</code>, Lambda blocks the deployment request if signature validation checks fail. If you set the policy to <code>Warn</code>, Lambda allows the deployment and issues a new Amazon CloudWatch metric (<code>SignatureValidationErrors</code>) and also stores the warning in the CloudTrail log. Default value: <code>Warn</code> * @public */ UntrustedArtifactOnDeployment?: CodeSigningPolicy | undefined; } /** * @public */ export interface CreateCodeSigningConfigRequest { /** * Descriptive name for this code signing configuration. * @public */ Description?: string | undefined; /** * Signing profiles for this code signing configuration. * @public */ AllowedPublishers: AllowedPublishers | undefined; /** * The code signing policies define the actions to take if the validation checks fail. * @public */ CodeSigningPolicies?: CodeSigningPolicies | undefined; /** * A list of tags to add to the code signing configuration. * @public */ Tags?: Record<string, string> | undefined; } /** * Details about a <a href="https://docs.aws.amazon.com/lambda/latest/dg/configuration-codesigning.html">Code signing configuration</a>. * @public */ export interface CodeSigningConfig { /** * Unique identifer for the Code signing configuration. * @public */ CodeSigningConfigId: string | undefined; /** * The Amazon Resource Name (ARN) of the Code signing configuration. * @public */ CodeSigningConfigArn: string | undefined; /** * Code signing configuration description. * @public */ Description?: string | undefined; /** * List of allowed publishers. * @public */ AllowedPublishers: AllowedPublishers | undefined; /** * The code signing policy controls the validation failure action for signature mismatch or expiry. * @public */ CodeSigningPolicies: CodeSigningPolicies | undefined; /** * The date and time that the Code signing configuration was last modified, in ISO-8601 format (YYYY-MM-DDThh:mm:ss.sTZD). * @public */ LastModified: string | undefined; } /** * @public */ export interface CreateCodeSigningConfigResponse { /** * The code signing configuration. * @public */ CodeSigningConfig: CodeSigningConfig | undefined; } /** * @public */ export interface DeleteCodeSigningConfigRequest { /** * The The Amazon Resource Name (ARN) of the code signing configuration. * @public */ CodeSigningConfigArn: string | undefined; } /** * @public */ export interface DeleteCodeSigningConfigResponse { } /** * @public */ export interface GetCodeSigningConfigRequest { /** * The The Amazon Resource Name (ARN) of the code signing configuration. * @public */ CodeSigningConfigArn: string | undefined; } /** * @public */ export interface GetCodeSigningConfigResponse { /** * The code signing configuration * @public */ CodeSigningConfig: CodeSigningConfig | undefined; } /** * @public */ export interface ListCodeSigningConfigsRequest { /** * Specify the pagination token that's returned by a previous request to retrieve the next page of results. * @public */ Marker?: string | undefined; /** * Maximum number of items to return. * @public */ MaxItems?: number | undefined; } /** * @public */ export interface ListCodeSigningConfigsResponse { /** * The pagination token that's included if more results are available. * @public */ NextMarker?: string | undefined; /** * The code signing configurations * @public */ CodeSigningConfigs?: CodeSigningConfig[] | undefined; } /** * @public */ export interface ListFunctionsByCodeSigningConfigRequest { /** * The The Amazon Resource Name (ARN) of the code signing configuration. * @public */ CodeSigningConfigArn: string | undefined; /** * Specify the pagination token that's returned by a previous request to retrieve the next page of results. * @public */ Marker?: string | undefined; /** * Maximum number of items to return. * @public */ MaxItems?: number | undefined; } /** * @public */ export interface ListFunctionsByCodeSigningConfigResponse { /** * The pagination token that's included if more results are available. * @public */ NextMarker?: string | undefined; /** * The function ARNs. * @public */ FunctionArns?: string[] | undefined; } /** * @public */ export interface UpdateCodeSigningConfigRequest { /** * The The Amazon Resource Name (ARN) of the code signing configuration. * @public */ CodeSigningConfigArn: string | undefined; /** * Descriptive name for this code signing configuration. * @public */ Description?: string | undefined; /** * Signing profiles for this code signing configuration. * @public */ AllowedPublishers?: AllowedPublishers | undefined; /** * The code signing policy. * @public */ CodeSigningPolicies?: CodeSigningPolicies | undefined; } /** * @public */ export interface UpdateCodeSigningConfigResponse { /** * The code signing configuration * @public */ CodeSigningConfig: CodeSigningConfig | undefined; } /** * @public */ export interface DeleteFunctionRequest { /** * The name or ARN of the Lambda function or version. Name formats <ul> <li> Function name – <code>my-function</code> (name-only), <code>my-function:1</code> (with version). </li> <li> Function ARN – <code>arn:aws:lambda:us-west-2:123456789012:function:my-function</code>. </li> <li> Partial ARN – <code>123456789012:function:my-function</code>. </li> </ul> You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. * @public */ FunctionName: string | undefined; /** * Specify a version to delete. You can't delete a version that an alias references. * @public */ Qualifier?: string | undefined; } /** * @public */ export interface DeleteFunctionResponse { /** * The HTTP status code returned by the operation. * @public */ StatusCode?: number | undefined; } /** * @public */ export interface DeleteFunctionEventInvokeConfigRequest { /** * The name or ARN of the Lambda function, version, or alias. Name formats <ul> <li> Function name - <code>my-function</code> (name-only), <code>my-function:v1</code> (with alias). </li> <li> Function ARN - <code>arn:aws:lambda:us-west-2:123456789012:function:my-function</code>. </li> <li> Partial ARN - <code>123456789012:function:my-function</code>. </li> </ul> You can append a version number or alias to any of the formats. The length constraint applies only to the full ARN. If you specify only the function name, it is limited to 64 characters in length. * @public */ FunctionName: string | undefined; /** * A version number or alias name. * @public */ Qualifier?: string | undefined; } /** * A destination for events that failed processing. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-async-destinations">Adding a destination</a>. * @public */ export interface OnFailure { /** * The Amazon Resource Name (ARN) of the destination resource. To retain records of failed invocations from <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html">Kinesis</a>, <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html">DynamoDB</a>, <a href="https://docs.aws.amazon.com/lambda/latest/dg/kafka-on-failure.html">self-managed Apache Kafka</a>, or <a href="https://docs.aws.amazon.com/lambda/latest/dg/kafka-on-failure.html">Amazon MSK</a>, you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, or Kafka topic as the destination. <note> Amazon SNS destinations have a message size limit of 256 KB. If the combined size of the function request and response payload exceeds the limit, Lambda will drop the payload when sending <code>OnFailure</code> event to the destination. For details on this behavior, refer to <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html">Retaining records of asynchronous invocations</a>. </note> To retain records of failed invocations from <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html">Kinesis</a>, <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html">DynamoDB</a>, <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination">self-managed Kafka</a> or <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination">Amazon MSK</a>, you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination. * @public */ Destination?: string | undefined; } /** * A destination for events that were processed successfully. To retain records of successful <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">asynchronous invocations</a>, you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or Amazon EventBridge event bus as the destination. <note> <code>OnSuccess</code> is not supported in <code>CreateEventSourceMapping</code> or <code>UpdateEventSourceMapping</code> requests. </note> * @public */ export interface OnSuccess { /** * The Amazon Resource Name (ARN) of the destination resource. <note> Amazon SNS destinations have a message size limit of 256 KB. If the combined size of the function request and response payload exceeds the limit, Lambda will drop the payload when sending <code>OnFailure</code> event to the destination. For details on this behavior, refer to <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html">Retaining records of asynchronous invocations</a>. </note> * @public */ Destination?: string | undefined; } /** * A configuration object that specifies the destination of an event after Lambda processes it. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async-retain-records.html#invocation-async-destinations">Adding a destination</a>. * @public */ export interface DestinationConfig { /** * The destination configuration for successful invocations. Not supported in <code>CreateEventSourceMapping</code> or <code>UpdateEventSourceMapping</code>. * @public */ OnSuccess?: OnSuccess | undefined; /** * The destination configuration for failed invocations. * @public */ OnFailure?: OnFailure | undefined; } /** * Specific configuration settings for a DocumentDB event source. * @public */ export interface DocumentDBEventSourceConfig { /** * The name of the database to consume within the DocumentDB cluster. * @public */ DatabaseName?: string | undefined; /** * The name of the collection to consume within the database. If you do not specify a collection, Lambda consumes all collections. * @public */ CollectionName?: string | undefined; /** * Determines what DocumentDB sends to your event stream during document update operations. If set to UpdateLookup, DocumentDB sends a delta describing the changes, along with a copy of the entire document. Otherwise, DocumentDB sends only a partial document that contains the changes. * @public */ FullDocument?: FullDocument | undefined; } /** * A structure within a <code>FilterCriteria</code> object that defines an event filtering pattern. * @public */ export interface Filter { /** * A filter pattern. For more information on the syntax of a filter pattern, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.h