import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
import { Command as $Command } from "@aws-sdk/smithy-client";
import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
import { LambdaClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../LambdaClient";
import { CreateFunctionRequest, FunctionConfiguration } from "../models/models_0";
/**
* @public
*/
export { __MetadataBearer, $Command };
/**
* @public
*
* The input for {@link CreateFunctionCommand}.
*/
export interface CreateFunctionCommandInput extends CreateFunctionRequest {
}
/**
* @public
*
* The output of {@link CreateFunctionCommand}.
*/
export interface CreateFunctionCommandOutput extends FunctionConfiguration, __MetadataBearer {
}
/**
* @public
* Creates a Lambda function. To create a function, you need a deployment package and an execution role. The
* deployment package is a .zip file archive or container image that contains your function code. The execution role
* grants the function permission to use Amazon Web Services, such as Amazon CloudWatch Logs for log
* streaming and X-Ray for request tracing.
* If the deployment package is a container
* image, then you set the package type to Image. For a container image, the code property
* must include the URI of a container image in the Amazon ECR registry. You do not need to specify the
* handler and runtime properties.
* If the deployment package is a .zip file archive, then
* you set the package type to Zip. For a .zip file archive, the code property specifies the location of
* the .zip file. You must also specify the handler and runtime properties. The code in the deployment package must
* be compatible with the target instruction set architecture of the function (x86-64 or
* arm64). If you do not specify the architecture, then the default value is
* x86-64.
* When you create a function, Lambda provisions an instance of the function and its supporting
* resources. If your function connects to a VPC, this process can take a minute or so. During this time, you can't
* invoke or modify the function. The State, StateReason, and StateReasonCode
* fields in the response from GetFunctionConfiguration indicate when the function is ready to
* invoke. For more information, see Lambda function states.
* A function has an unpublished version, and can have published versions and aliases. The unpublished version
* changes when you update your function's code and configuration. A published version is a snapshot of your function
* code and configuration that can't be changed. An alias is a named resource that maps to a version, and can be
* changed to map to a different version. Use the Publish parameter to create version 1 of
* your function from its initial configuration.
* The other parameters let you configure version-specific and function-level settings. You can modify
* version-specific settings later with UpdateFunctionConfiguration. Function-level settings apply
* to both the unpublished and published versions of the function, and include tags (TagResource)
* and per-function concurrency limits (PutFunctionConcurrency).
* You can use code signing if your deployment package is a .zip file archive. To enable code signing for this
* function, specify the ARN of a code-signing configuration. When a user attempts to deploy a code package with
* UpdateFunctionCode, Lambda checks that the code package has a valid signature from
* a trusted publisher. The code-signing configuration includes set of signing profiles, which define the trusted
* publishers for this function.
* If another Amazon Web Services account or an Amazon Web Service invokes your function, use AddPermission to grant permission by creating a resource-based Identity and Access Management (IAM) policy. You can grant permissions at the function level, on a version, or on an alias.
* To invoke your function directly, use Invoke. To invoke your function in response to events
* in other Amazon Web Services, create an event source mapping (CreateEventSourceMapping),
* or configure a function trigger in the other service. For more information, see Invoking Lambda
* functions.
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
* import { LambdaClient, CreateFunctionCommand } from "@aws-sdk/client-lambda"; // ES Modules import
* // const { LambdaClient, CreateFunctionCommand } = require("@aws-sdk/client-lambda"); // CommonJS import
* const client = new LambdaClient(config);
* const input = { // CreateFunctionRequest
* FunctionName: "STRING_VALUE", // required
* Runtime: "nodejs" || "nodejs4.3" || "nodejs6.10" || "nodejs8.10" || "nodejs10.x" || "nodejs12.x" || "nodejs14.x" || "nodejs16.x" || "java8" || "java8.al2" || "java11" || "python2.7" || "python3.6" || "python3.7" || "python3.8" || "python3.9" || "dotnetcore1.0" || "dotnetcore2.0" || "dotnetcore2.1" || "dotnetcore3.1" || "dotnet6" || "nodejs4.3-edge" || "go1.x" || "ruby2.5" || "ruby2.7" || "provided" || "provided.al2" || "nodejs18.x" || "python3.10" || "java17",
* Role: "STRING_VALUE", // required
* Handler: "STRING_VALUE",
* Code: { // FunctionCode
* ZipFile: "BLOB_VALUE",
* S3Bucket: "STRING_VALUE",
* S3Key: "STRING_VALUE",
* S3ObjectVersion: "STRING_VALUE",
* ImageUri: "STRING_VALUE",
* },
* Description: "STRING_VALUE",
* Timeout: Number("int"),
* MemorySize: Number("int"),
* Publish: true || false,
* VpcConfig: { // VpcConfig
* SubnetIds: [ // SubnetIds
* "STRING_VALUE",
* ],
* SecurityGroupIds: [ // SecurityGroupIds
* "STRING_VALUE",
* ],
* },
* PackageType: "Zip" || "Image",
* DeadLetterConfig: { // DeadLetterConfig
* TargetArn: "STRING_VALUE",
* },
* Environment: { // Environment
* Variables: { // EnvironmentVariables
* "": "STRING_VALUE",
* },
* },
* KMSKeyArn: "STRING_VALUE",
* TracingConfig: { // TracingConfig
* Mode: "Active" || "PassThrough",
* },
* Tags: { // Tags
* "": "STRING_VALUE",
* },
* Layers: [ // LayerList
* "STRING_VALUE",
* ],
* FileSystemConfigs: [ // FileSystemConfigList
* { // FileSystemConfig
* Arn: "STRING_VALUE", // required
* LocalMountPath: "STRING_VALUE", // required
* },
* ],
* ImageConfig: { // ImageConfig
* EntryPoint: [ // StringList
* "STRING_VALUE",
* ],
* Command: [
* "STRING_VALUE",
* ],
* WorkingDirectory: "STRING_VALUE",
* },
* CodeSigningConfigArn: "STRING_VALUE",
* Architectures: [ // ArchitecturesList
* "x86_64" || "arm64",
* ],
* EphemeralStorage: { // EphemeralStorage
* Size: Number("int"), // required
* },
* SnapStart: { // SnapStart
* ApplyOn: "PublishedVersions" || "None",
* },
* };
* const command = new CreateFunctionCommand(input);
* const response = await client.send(command);
* // { // FunctionConfiguration
* // FunctionName: "STRING_VALUE",
* // FunctionArn: "STRING_VALUE",
* // Runtime: "nodejs" || "nodejs4.3" || "nodejs6.10" || "nodejs8.10" || "nodejs10.x" || "nodejs12.x" || "nodejs14.x" || "nodejs16.x" || "java8" || "java8.al2" || "java11" || "python2.7" || "python3.6" || "python3.7" || "python3.8" || "python3.9" || "dotnetcore1.0" || "dotnetcore2.0" || "dotnetcore2.1" || "dotnetcore3.1" || "dotnet6" || "nodejs4.3-edge" || "go1.x" || "ruby2.5" || "ruby2.7" || "provided" || "provided.al2" || "nodejs18.x" || "python3.10" || "java17",
* // Role: "STRING_VALUE",
* // Handler: "STRING_VALUE",
* // CodeSize: Number("long"),
* // Description: "STRING_VALUE",
* // Timeout: Number("int"),
* // MemorySize: Number("int"),
* // LastModified: "STRING_VALUE",
* // CodeSha256: "STRING_VALUE",
* // Version: "STRING_VALUE",
* // VpcConfig: { // VpcConfigResponse
* // SubnetIds: [ // SubnetIds
* // "STRING_VALUE",
* // ],
* // SecurityGroupIds: [ // SecurityGroupIds
* // "STRING_VALUE",
* // ],
* // VpcId: "STRING_VALUE",
* // },
* // DeadLetterConfig: { // DeadLetterConfig
* // TargetArn: "STRING_VALUE",
* // },
* // Environment: { // EnvironmentResponse
* // Variables: { // EnvironmentVariables
* // "": "STRING_VALUE",
* // },
* // Error: { // EnvironmentError
* // ErrorCode: "STRING_VALUE",
* // Message: "STRING_VALUE",
* // },
* // },
* // KMSKeyArn: "STRING_VALUE",
* // TracingConfig: { // TracingConfigResponse
* // Mode: "Active" || "PassThrough",
* // },
* // MasterArn: "STRING_VALUE",
* // RevisionId: "STRING_VALUE",
* // Layers: [ // LayersReferenceList
* // { // Layer
* // Arn: "STRING_VALUE",
* // CodeSize: Number("long"),
* // SigningProfileVersionArn: "STRING_VALUE",
* // SigningJobArn: "STRING_VALUE",
* // },
* // ],
* // State: "Pending" || "Active" || "Inactive" || "Failed",
* // StateReason: "STRING_VALUE",
* // StateReasonCode: "Idle" || "Creating" || "Restoring" || "EniLimitExceeded" || "InsufficientRolePermissions" || "InvalidConfiguration" || "InternalError" || "SubnetOutOfIPAddresses" || "InvalidSubnet" || "InvalidSecurityGroup" || "ImageDeleted" || "ImageAccessDenied" || "InvalidImage" || "KMSKeyAccessDenied" || "KMSKeyNotFound" || "InvalidStateKMSKey" || "DisabledKMSKey" || "EFSIOError" || "EFSMountConnectivityError" || "EFSMountFailure" || "EFSMountTimeout" || "InvalidRuntime" || "InvalidZipFileException" || "FunctionError",
* // LastUpdateStatus: "Successful" || "Failed" || "InProgress",
* // LastUpdateStatusReason: "STRING_VALUE",
* // LastUpdateStatusReasonCode: "EniLimitExceeded" || "InsufficientRolePermissions" || "InvalidConfiguration" || "InternalError" || "SubnetOutOfIPAddresses" || "InvalidSubnet" || "InvalidSecurityGroup" || "ImageDeleted" || "ImageAccessDenied" || "InvalidImage" || "KMSKeyAccessDenied" || "KMSKeyNotFound" || "InvalidStateKMSKey" || "DisabledKMSKey" || "EFSIOError" || "EFSMountConnectivityError" || "EFSMountFailure" || "EFSMountTimeout" || "InvalidRuntime" || "InvalidZipFileException" || "FunctionError",
* // FileSystemConfigs: [ // FileSystemConfigList
* // { // FileSystemConfig
* // Arn: "STRING_VALUE", // required
* // LocalMountPath: "STRING_VALUE", // required
* // },
* // ],
* // PackageType: "Zip" || "Image",
* // ImageConfigResponse: { // ImageConfigResponse
* // ImageConfig: { // ImageConfig
* // EntryPoint: [ // StringList
* // "STRING_VALUE",
* // ],
* // Command: [
* // "STRING_VALUE",
* // ],
* // WorkingDirectory: "STRING_VALUE",
* // },
* // Error: { // ImageConfigError
* // ErrorCode: "STRING_VALUE",
* // Message: "STRING_VALUE",
* // },
* // },
* // SigningProfileVersionArn: "STRING_VALUE",
* // SigningJobArn: "STRING_VALUE",
* // Architectures: [ // ArchitecturesList
* // "x86_64" || "arm64",
* // ],
* // EphemeralStorage: { // EphemeralStorage
* // Size: Number("int"), // required
* // },
* // SnapStart: { // SnapStartResponse
* // ApplyOn: "PublishedVersions" || "None",
* // OptimizationStatus: "On" || "Off",
* // },
* // RuntimeVersionConfig: { // RuntimeVersionConfig
* // RuntimeVersionArn: "STRING_VALUE",
* // Error: { // RuntimeVersionError
* // ErrorCode: "STRING_VALUE",
* // Message: "STRING_VALUE",
* // },
* // },
* // };
*
* ```
*
* @param CreateFunctionCommandInput - {@link CreateFunctionCommandInput}
* @returns {@link CreateFunctionCommandOutput}
* @see {@link CreateFunctionCommandInput} for command's `input` shape.
* @see {@link CreateFunctionCommandOutput} for command's `response` shape.
* @see {@link LambdaClientResolvedConfig | config} for LambdaClient's `config` shape.
*
* @throws {@link CodeSigningConfigNotFoundException} (client fault)
* The specified code signing configuration does not exist.
*
* @throws {@link CodeStorageExceededException} (client fault)
* Your Amazon Web Services account has exceeded its maximum total code size. For more information, see Lambda quotas.
*
* @throws {@link CodeVerificationFailedException} (client fault)
* The code signature failed one or more of the validation checks for signature mismatch or expiry, and the code
* signing policy is set to ENFORCE. Lambda blocks the deployment.
*
* @throws {@link InvalidCodeSignatureException} (client fault)
* The code signature failed the integrity check. If the integrity check fails, then Lambda blocks
* deployment, even if the code signing policy is set to WARN.
*
* @throws {@link InvalidParameterValueException} (client fault)
* One of the parameters in the request is not valid.
*
* @throws {@link ResourceConflictException} (client fault)
* The resource already exists, or another operation is in progress.
*
* @throws {@link ResourceNotFoundException} (client fault)
* The resource specified in the request does not exist.
*
* @throws {@link ServiceException} (server fault)
* The Lambda service encountered an internal error.
*
* @throws {@link TooManyRequestsException} (client fault)
* The request throughput limit was exceeded. For more information, see Lambda quotas.
*
* @throws {@link LambdaServiceException}
* Base exception class for all service exceptions from Lambda service.
*
*/
export declare class CreateFunctionCommand extends $Command {
readonly input: CreateFunctionCommandInput;
static getEndpointParameterInstructions(): EndpointParameterInstructions;
/**
* @public
*/
constructor(input: CreateFunctionCommandInput);
/**
* @internal
*/
resolveMiddleware(clientStack: MiddlewareStack, configuration: LambdaClientResolvedConfig, options?: __HttpHandlerOptions): Handler;
/**
* @internal
*/
private serialize;
/**
* @internal
*/
private deserialize;
}