@aws-sdk/client-lambda
Version:
AWS SDK for JavaScript Lambda Client for Node.js, Browser and React Native
201 lines (200 loc) • 10 kB
TypeScript
import { Command as $Command } from "@smithy/smithy-client";
import { MetadataBearer as __MetadataBearer } from "@smithy/types";
import { LambdaClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../LambdaClient";
import { FunctionConfiguration, PublishVersionRequest } from "../models/models_0";
/**
* @public
*/
export type { __MetadataBearer };
export { $Command };
/**
* @public
*
* The input for {@link PublishVersionCommand}.
*/
export interface PublishVersionCommandInput extends PublishVersionRequest {
}
/**
* @public
*
* The output of {@link PublishVersionCommand}.
*/
export interface PublishVersionCommandOutput extends FunctionConfiguration, __MetadataBearer {
}
declare const PublishVersionCommand_base: {
new (input: PublishVersionCommandInput): import("@smithy/smithy-client").CommandImpl<PublishVersionCommandInput, PublishVersionCommandOutput, LambdaClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
new (__0_0: PublishVersionCommandInput): import("@smithy/smithy-client").CommandImpl<PublishVersionCommandInput, PublishVersionCommandOutput, LambdaClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
};
/**
* <p>Creates a <a href="https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html">version</a> from the
* current code and configuration of a function. Use versions to create a snapshot of your function code and
* configuration that doesn't change.</p>
* <p>Lambda doesn't publish a version if the function's configuration and code haven't changed since the last
* version. Use <a>UpdateFunctionCode</a> or <a>UpdateFunctionConfiguration</a> to update the
* function before publishing a version.</p>
* <p>Clients can invoke versions directly or with an alias. To create an alias, use <a>CreateAlias</a>.</p>
* @example
* Use a bare-bones client and the command you need to make an API call.
* ```javascript
* import { LambdaClient, PublishVersionCommand } from "@aws-sdk/client-lambda"; // ES Modules import
* // const { LambdaClient, PublishVersionCommand } = require("@aws-sdk/client-lambda"); // CommonJS import
* const client = new LambdaClient(config);
* const input = { // PublishVersionRequest
* FunctionName: "STRING_VALUE", // required
* CodeSha256: "STRING_VALUE",
* Description: "STRING_VALUE",
* RevisionId: "STRING_VALUE",
* };
* const command = new PublishVersionCommand(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" || "dotnet8" || "nodejs4.3-edge" || "go1.x" || "ruby2.5" || "ruby2.7" || "provided" || "provided.al2" || "nodejs18.x" || "python3.10" || "java17" || "ruby3.2" || "ruby3.3" || "python3.11" || "nodejs20.x" || "provided.al2023" || "python3.12" || "java21",
* // 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",
* // Ipv6AllowedForDualStack: true || false,
* // },
* // DeadLetterConfig: { // DeadLetterConfig
* // TargetArn: "STRING_VALUE",
* // },
* // Environment: { // EnvironmentResponse
* // Variables: { // EnvironmentVariables
* // "<keys>": "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",
* // },
* // },
* // LoggingConfig: { // LoggingConfig
* // LogFormat: "JSON" || "Text",
* // ApplicationLogLevel: "TRACE" || "DEBUG" || "INFO" || "WARN" || "ERROR" || "FATAL",
* // SystemLogLevel: "DEBUG" || "INFO" || "WARN",
* // LogGroup: "STRING_VALUE",
* // },
* // };
*
* ```
*
* @param PublishVersionCommandInput - {@link PublishVersionCommandInput}
* @returns {@link PublishVersionCommandOutput}
* @see {@link PublishVersionCommandInput} for command's `input` shape.
* @see {@link PublishVersionCommandOutput} for command's `response` shape.
* @see {@link LambdaClientResolvedConfig | config} for LambdaClient's `config` shape.
*
* @throws {@link CodeStorageExceededException} (client fault)
* <p>Your Amazon Web Services account has exceeded its maximum total code size. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html">Lambda quotas</a>.</p>
*
* @throws {@link InvalidParameterValueException} (client fault)
* <p>One of the parameters in the request is not valid.</p>
*
* @throws {@link PreconditionFailedException} (client fault)
* <p>The RevisionId provided does not match the latest RevisionId for the Lambda function or alias.</p>
* <ul>
* <li>
* <p>
* <b>For AddPermission and RemovePermission API operations:</b> Call <code>GetPolicy</code> to retrieve the latest RevisionId for your resource.</p>
* </li>
* <li>
* <p>
* <b>For all other API operations:</b> Call <code>GetFunction</code> or <code>GetAlias</code> to retrieve the latest RevisionId for your resource.</p>
* </li>
* </ul>
*
* @throws {@link ResourceConflictException} (client fault)
* <p>The resource already exists, or another operation is in progress.</p>
*
* @throws {@link ResourceNotFoundException} (client fault)
* <p>The resource specified in the request does not exist.</p>
*
* @throws {@link ServiceException} (server fault)
* <p>The Lambda service encountered an internal error.</p>
*
* @throws {@link TooManyRequestsException} (client fault)
* <p>The request throughput limit was exceeded. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests">Lambda quotas</a>.</p>
*
* @throws {@link LambdaServiceException}
* <p>Base exception class for all service exceptions from Lambda service.</p>
*
* @public
*/
export declare class PublishVersionCommand extends PublishVersionCommand_base {
}