

# CreateFunction
<a name="API_CreateFunction"></a>

Crea una función de Lambda. Para crear una función, necesita un [paquete de implementación](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) y un [rol de ejecución](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role). El paquete de implementación es un archivo .zip o una imagen de contenedor que contiene el código de función. El rol de ejecución concede permiso a la función para utilizar Servicios de AWS, como Registros de Amazon CloudWatch para el flujo de registros y AWS X-Ray para el rastreo de solicitudes.

Si el paquete de despliegue es una [imagen de contenedor](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html), se establece el tipo de paquete como `Image`. Para una imagen de contenedor, la propiedad del código debe incluir el URI de una imagen de contenedor en el registro de Amazon ECR. No es necesario especificar el controlador y las propiedades del tiempo de ejecución.

Si el paquete de despliegue es un [archivo .zip](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip), se establece el tipo de paquete como `Zip`. Para un archivo .zip, la propiedad del código especifica la ubicación del archivo .zip. También debe especificar el controlador y las propiedades del tiempo de ejecución. El código del paquete de implementación debe ser compatible con la arquitectura del conjunto de instrucciones de destino de la función (`x86-64` o `arm64`). Si no especifica la arquitectura, el valor predeterminado es `x86-64`.

Cuando crea una función, Lambda aprovisiona una instancia de la función y sus recursos auxiliares. Si su función se conecta a una VPC, este proceso puede tardar un minuto más o menos. Durante este tiempo, no puede invocar o modificar la función. Los campos `State`, `StateReason` y `StateReasonCode` en la respuesta de [GetFunctionConfiguration](API_GetFunctionConfiguration.md) indica cuándo la función está lista para su invocación. Para obtener más información, consulte [Estados de función de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html).

Una función tiene una versión no publicada y puede tener versiones y alias publicados. La versión no publicada cambia al actualizar el código y la configuración de la función. Una versión publicada es una instantánea del código y la configuración de su función que no se puede cambiar. Un alias es un recurso con nombre mapeado que se asigna a una versión y se puede cambiar para asignarla a una versión diferente. Use el parámetro `Publish` para crear la versión `1` de su función desde su configuración inicial.

Los demás parámetros le permiten configurar ajustes específicos de la versión y de la función. Puede modificar la configuración específica de la versión más adelante con [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md). La configuración de nivel de función se aplica a las versiones publicadas y no publicadas de la función, e incluye etiquetas ([TagResource](API_TagResource.md)) y los límites de concurrencia por función ([PutFunctionConcurrency](API_PutFunctionConcurrency.md)).

Puede usar la firma de código si el paquete de implementación es un archivo .zip. Para habilitar la firma de código para esta función, especifique el ARN de una configuración de firma de código. Cuando un usuario intenta implementar un paquete de código con [UpdateFunctionCode](API_UpdateFunctionCode.md), Lambda comprueba que el paquete de código tenga una firma válida de un editor de confianza. La configuración de firma de código incluye un conjunto de perfiles de firma, que definen los editores de confianza para esta función.

Si otra Cuenta de AWS o Servicio de AWS invoca la función, utilice [AddPermission](API_AddPermission.md) para conceder permiso mediante la creación de una política de IAM de AWS Identity and Access Management basada en recursos. Puede conceder permisos en el nivel de la función, en una versión o en un alias.

Para invocar la función directamente, use [Invoke](API_Invoke.md). Para invocar la función en respuesta a eventos en otros Servicios de AWS, cree una asignación de orígenes de eventos ([CreateEventSourceMapping](API_CreateEventSourceMapping.md)) o configure un desencadenador de función en el otro servicio. Para obtener más información, consulte [Invocación de funciones de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html).

## Sintaxis de la solicitud
<a name="API_CreateFunction_RequestSyntax"></a>

```
POST /2015-03-31/functions HTTP/1.1
Content-type: application/json

{
   "Architectures": [ "string" ],
   "Code": { 
      "ImageUri": "string",
      "S3Bucket": "string",
      "S3Key": "string",
      "S3ObjectVersion": "string",
      "ZipFile": blob
   },
   "CodeSigningConfigArn": "string",
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfig": { 
      "Command": [ "string" ],
      "EntryPoint": [ "string" ],
      "WorkingDirectory": "string"
   },
   "KMSKeyArn": "string",
   "Layers": [ "string" ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MemorySize": number,
   "PackageType": "string",
   "Publish": boolean,
   "Role": "string",
   "Runtime": "string",
   "SnapStart": { 
      "ApplyOn": "string"
   },
   "Tags": { 
      "string" : "string" 
   },
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ]
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateFunction_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateFunction_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
La arquitectura del conjunto de instrucciones que admite la función. Ingrese una matriz de cadenas con uno de los valores válidos (arm64 o x86\$164). El valor predeterminado es `x86_64`.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Valores válidos: `x86_64 | arm64`   
Obligatorio: no

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
Código de la función.  
Tipo: objeto [FunctionCode](API_FunctionCode.md)  
Obligatorio: sí

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
Para habilitar la firma de código para esta función, especifique el ARN de una configuración de firma de código. Una configuración de firma de código incluye un conjunto de perfiles de firma, que definen los editores de confianza para esta función.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 200 caracteres.  
Patrón: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}((-gov)|(-iso(b?)))?-[a-z]+-\d{1}:\d{12}:code-signing-config:csc-[a-z0-9]{17}`   
Obligatorio: no

 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
La configuración de una cola de mensajes fallidos que especifica la cola o el tema donde Lambda envía los eventos asíncronos cuando no superan el procesamiento. Para obtener más información, consulte [Colas de mensajes fallidos](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).  
Tipo: objeto [DeadLetterConfig](API_DeadLetterConfig.md)  
Obligatorio: no

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
Una descripción de la función.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Obligatorio: no

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
Variables de entorno que están accesibles desde el código de la función durante la ejecución.  
Tipo: objeto [Environment](API_Environment.md)  
Obligatorio: no

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
El tamaño del directorio `/tmp` de la función en MB. El valor predeterminado es 512, pero puede ser cualquier número entero entre 512 y 10 240 MB. Para obtener más información, consulte [Configuración del almacenamiento efímero (consola)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Tipo: objeto [EphemeralStorage](API_EphemeralStorage.md)  
Obligatorio: no

 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Configuración de conexión para un sistema de archivos de Amazon EFS.  
Tipo: Matriz de objetos [FileSystemConfig](API_FileSystemConfig.md)  
Miembros de la matriz: número máximo de 1 elemento.  
Obligatorio: no

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
El nombre de la función de Lambda.  

**Formatos de nombre**
+  **Nombre de la función**: `my-function`.
+  **ARN de la función**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
La limitación de longitud se aplica únicamente al ARN completo. Si solo especifica el nombre de la función, se limita a 64 caracteres de longitud.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?`   
Obligatorio: sí

 ** [Handler](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Handler"></a>
El nombre del método dentro del código al que Lambda llama para ejecutar la función. Se requiere un controlador si el paquete de implementación es un archivo .zip. El formato incluye el nombre del archivo. También puede incluir espacios de nombres y otros calificadores, en función del tiempo de ejecución. Para obtener más información, consulte [Modelo de programación de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `[^\s]+`   
Obligatorio: no

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
[Valores de configuración](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings) de la imagen del contenedor que anulan los valores del Dockerfile de la imagen contenedor.  
Tipo: objeto [ImageConfig](API_ImageConfig.md)  
Obligatorio: no

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
El ARN de la clave administrada por el cliente de AWS Key Management Service (AWS KMS) que se usa para cifrar las [variables de entorno](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) de la función. Cuando [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) está activado, Lambda también usa esta clave para cifrar la instantánea de la función. Si implementa la función mediante una imagen de contenedor, Lambda también usa esta clave para cifrar la función cuando se implementa. Tenga en cuenta que esta no es la misma clave que se utiliza para proteger la imagen de contenedor en Amazon Elastic Container Registry (Amazon ECR). Si no proporciona ninguna clave administrada por el cliente, Lambda utiliza una clave de servicio predeterminada.  
Tipo: String  
Patrón: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Obligatorio: no

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
Lista de [capas de función](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) para añadir al entorno de ejecución de la función. Especifique cada capa por su ARN, incluida la versión.  
Tipo: matriz de cadenas  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 140 caracteres.  
Patrón: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Obligatorio: no

 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
Los ajustes de configuración de Registros de Amazon CloudWatch de la función.  
Tipo: objeto [LoggingConfig](API_LoggingConfig.md)  
Obligatorio: no

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
La cantidad de [memoria disponible para la función](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) en tiempo de ejecución. Al aumentar la memoria de la función, también se aumenta su asignación de CPU. El valor predeterminado es 128 MB. El valor puede ser cualquier múltiplo de 1 MB.  
Tipo: entero  
Rango válido: valor mínimo de 128. Valor máximo de 10240.  
Obligatorio: no

 ** [PackageType](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PackageType"></a>
El tipo de paquete de implementación. Establezca en `Image` la imagen de contenedor y establezca en `Zip` el fichero de archivos .zip.  
Tipo: cadena  
Valores válidos: `Zip | Image`   
Obligatorio: no

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
Establezca en verdadero para publicar la primera versión de la función durante la creación.  
Tipo: Booleano  
Obligatorio: no

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
El nombre de recurso de Amazon (ARN) del rol de ejecución de la función.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obligatorio: sí

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
El identificador del [tiempo de ejecución](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) de la función. Se requiere tiempo de ejecución si el paquete de implementación es un archivo .zip.  
En la siguiente lista, se incluye los tiempos de ejecución en desuso. Para obtener más información, consulte [Política de obsolescencia del tiempo de ejecución](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Tipo: cadena  
Valores válidos: `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 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21`   
Obligatorio: no

 ** [SnapStart](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
La configuración de [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) de la función.  
Tipo: objeto [SnapStart](API_SnapStart.md)  
Obligatorio: no

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
Lista de [etiquetas](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) que se aplican a la función.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
La cantidad de tiempo (en segundos) durante la cual Lambda permite que se ejecute una función antes de pararla. El valor predeterminado es de 3 segundos. El valor máximo permitido es de 900 segundos. Para obtener más información, consulte [Entorno de ejecución de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html).  
Tipo: entero  
Rango válido: valor mínimo de 1.  
Obligatorio: no

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
Establezca `Mode` en `Active` para realizar una muestra y un seguimiento de una subred de solicitudes entrantes con [X-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html).  
Tipo: objeto [TracingConfig](API_TracingConfig.md)  
Obligatorio: no

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
Para la conectividad de red con los recursos de AWS en una VPC, especifique una lista de grupos de seguridad y subredes en la VPC. Cuando conecte una función a una VPC, esta solo puede tener acceso a los recursos y a Internet a través de esa VPC. Para obtener más información, consulte [Configuración de una función de Lambda para obtener acceso a los recursos en una VPC](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html).  
Tipo: objeto [VpcConfig](API_VpcConfig.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateFunction_ResponseSyntax"></a>

```
HTTP/1.1 201
Content-type: application/json

{
   "Architectures": [ "string" ],
   "CodeSha256": "string",
   "CodeSize": number,
   "DeadLetterConfig": { 
      "TargetArn": "string"
   },
   "Description": "string",
   "Environment": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "Variables": { 
         "string" : "string" 
      }
   },
   "EphemeralStorage": { 
      "Size": number
   },
   "FileSystemConfigs": [ 
      { 
         "Arn": "string",
         "LocalMountPath": "string"
      }
   ],
   "FunctionArn": "string",
   "FunctionName": "string",
   "Handler": "string",
   "ImageConfigResponse": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "ImageConfig": { 
         "Command": [ "string" ],
         "EntryPoint": [ "string" ],
         "WorkingDirectory": "string"
      }
   },
   "KMSKeyArn": "string",
   "LastModified": "string",
   "LastUpdateStatus": "string",
   "LastUpdateStatusReason": "string",
   "LastUpdateStatusReasonCode": "string",
   "Layers": [ 
      { 
         "Arn": "string",
         "CodeSize": number,
         "SigningJobArn": "string",
         "SigningProfileVersionArn": "string"
      }
   ],
   "LoggingConfig": { 
      "ApplicationLogLevel": "string",
      "LogFormat": "string",
      "LogGroup": "string",
      "SystemLogLevel": "string"
   },
   "MasterArn": "string",
   "MemorySize": number,
   "PackageType": "string",
   "RevisionId": "string",
   "Role": "string",
   "Runtime": "string",
   "RuntimeVersionConfig": { 
      "Error": { 
         "ErrorCode": "string",
         "Message": "string"
      },
      "RuntimeVersionArn": "string"
   },
   "SigningJobArn": "string",
   "SigningProfileVersionArn": "string",
   "SnapStart": { 
      "ApplyOn": "string",
      "OptimizationStatus": "string"
   },
   "State": "string",
   "StateReason": "string",
   "StateReasonCode": "string",
   "Timeout": number,
   "TracingConfig": { 
      "Mode": "string"
   },
   "Version": "string",
   "VpcConfig": { 
      "Ipv6AllowedForDualStack": boolean,
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcId": "string"
   }
}
```

## Elementos de respuesta
<a name="API_CreateFunction_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 201.

El servicio devuelve los datos siguientes en formato JSON.

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
La arquitectura del conjunto de instrucciones que admite la función. La arquitectura es una matriz de cadenas con uno de los valores válidos. El valor de la arquitectura predeterminada es `x86_64`.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Valores válidos: `x86_64 | arm64` 

 ** [CodeSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
El hash SHA256 del paquete de implementación de la función.  
Tipo: cadena

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
El tamaño del paquete de implementación de la función, en bytes.  
Tipo: largo

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
La cola de mensajes fallidos de la función.  
Tipo: objeto [DeadLetterConfig](API_DeadLetterConfig.md)

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
Descripción de la función.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
Las [variables de entorno](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) de la función. Omitido en los registros de AWS CloudTrail.  
Tipo: objeto [EnvironmentResponse](API_EnvironmentResponse.md)

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
El tamaño del directorio `/tmp` de la función en MB. El valor predeterminado es 512, pero puede ser cualquier número entero entre 512 y 10 240 MB. Para obtener más información, consulte [Configuración del almacenamiento efímero (consola)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Tipo: objeto [EphemeralStorage](API_EphemeralStorage.md)

 ** [FileSystemConfigs](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FileSystemConfigs"></a>
Configuración de conexión para un [sistema de archivos de Amazon EFS](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Tipo: Matriz de objetos [FileSystemConfig](API_FileSystemConfig.md)  
Miembros de la matriz: número máximo de 1 elemento.

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
El nombre de recurso de Amazon (ARN) de la función.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_\.]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [FunctionName](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionName"></a>
El nombre de la función.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 170 caracteres.  
Patrón: `(arn:(aws[a-zA-Z-]*)?:lambda:)?([a-z]{2}(-gov)?-[a-z]+-\d{1}:)?(\d{12}:)?(function:)?([a-zA-Z0-9-_\.]+)(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [Handler](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Handler"></a>
La función a la que llama Lambda para comenzar a ejecutar la función.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `[^\s]+` 

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
Los valores de configuración de la imagen de la función.  
Tipo: objeto [ImageConfigResponse](API_ImageConfigResponse.md)

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
La AWS KMS key que se utiliza para cifrar las [variables de entorno](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) de la función. Cuando [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) está activada, esta clave también se usa para cifrar la instantánea de la función. Esta clave solo se devuelve si ha configurado la clave administrada por el cliente.  
Tipo: String  
Patrón: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
La fecha y hora de la última actualización de la función, en [formato ISO-8601](https://www.w3.org/TR/NOTE-datetime) (AAAA-MM-DDThh:mm:ss.sTZD).  
Tipo: cadena

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
El estado de la última actualización que se realizó en la función. Esto se establece primero en `Successful` después de que se complete la creación de la función  
Tipo: cadena  
Valores válidos: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
El motivo de la última actualización que se realizó en la función.  
Tipo: cadena

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
El código de motivo de la última actualización que se realizó en la función.  
Tipo: cadena  
Valores válidos: `EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` 

 ** [Layers](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Layers"></a>
Las [capas ](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html)de la función.  
Tipo: Matriz de objetos [Layer](API_Layer.md)

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
Los ajustes de configuración de Registros de Amazon CloudWatch de la función.  
Tipo: objeto [LoggingConfig](API_LoggingConfig.md)

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
Para las funciones Lambda@Edge, el ARN de la función principal.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?` 

 ** [MemorySize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MemorySize"></a>
La cantidad de memoria disponible para la función en tiempo de ejecución.  
Tipo: entero  
Rango válido: valor mínimo de 128. Valor máximo de 10240.

 ** [PackageType](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
El tipo de paquete de implementación. Establezca en `Image` para la imagen contenedor y configure `Zip` para el archivo de archivos .zip.  
Tipo: cadena  
Valores válidos: `Zip | Image` 

 ** [RevisionId](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
La última revisión actualizada de la función o alias.  
Tipo: cadena

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
Rol de ejecución de la función.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 

 ** [Runtime](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Runtime"></a>
El identificador del [tiempo de ejecución](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) de la función. Se requiere tiempo de ejecución si el paquete de implementación es un archivo .zip.  
En la siguiente lista, se incluye los tiempos de ejecución en desuso. Para obtener más información, consulte [Política de obsolescencia del tiempo de ejecución](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Tipo: cadena  
Valores válidos: `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 | ruby3.2 | python3.11 | nodejs20.x | provided.al2023 | python3.12 | java21` 

 ** [RuntimeVersionConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RuntimeVersionConfig"></a>
El ARN del tiempo de ejecución y cualquier error que se haya producido.  
Tipo: objeto [RuntimeVersionConfig](API_RuntimeVersionConfig.md)

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
El ARN del trabajo de firma.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SigningProfileVersionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningProfileVersionArn"></a>
El ARN de la versión del perfil de firma.  
Tipo: String  
Patrón: `arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)` 

 ** [SnapStart](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SnapStart"></a>
Establezca `ApplyOn` como `PublishedVersions` para crear una instantánea del entorno de ejecución inicializado cuando publique una versión de la función. Para obtener más información, consulte [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) (Cómo mejorar el rendimiento de inicio con Lambda SnapStart).  
Tipo: objeto [SnapStartResponse](API_SnapStartResponse.md)

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
El estado actual de la función. Cuando el estado es `Inactive`, puede reactivar la función invocándola.  
Tipo: cadena  
Valores válidos: `Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
El motivo del estado actual de la función.  
Tipo: cadena

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
El código de motivo del estado actual de la función. Cuando el código es `Creating`, no puede invocar ni modificar la función.  
Tipo: cadena  
Valores válidos: `Idle | Creating | Restoring | EniLimitExceeded | InsufficientRolePermissions | InvalidConfiguration | InternalError | SubnetOutOfIPAddresses | InvalidSubnet | InvalidSecurityGroup | ImageDeleted | ImageAccessDenied | InvalidImage | KMSKeyAccessDenied | KMSKeyNotFound | InvalidStateKMSKey | DisabledKMSKey | EFSIOError | EFSMountConnectivityError | EFSMountFailure | EFSMountTimeout | InvalidRuntime | InvalidZipFileException | FunctionError` 

 ** [Timeout](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Timeout"></a>
La cantidad de tiempo en segundos durante el cual Lambda permite que se ejecute una función antes de pararla.  
Tipo: entero  
Rango válido: valor mínimo de 1.

 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
Configuración de seguimiento de AWS X-Ray de la función.  
Tipo: objeto [TracingConfigResponse](API_TracingConfigResponse.md)

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
La versión de la función Lambda.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
Configuración de red de la función.  
Tipo: objeto [VpcConfigResponse](API_VpcConfigResponse.md)

## Errores
<a name="API_CreateFunction_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Errores comunes](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
La configuración de firma de código especificado no existe.  
Código de estado HTTP: 404

 ** CodeStorageExceededException **   
La cuenta Cuenta de AWS superó su tamaño total máximo de código. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
Código de estado HTTP: 400

 ** CodeVerificationFailedException **   
La firma de código falló en una o más de las verificaciones de validación para detectar la discrepancia o la caducidad de la firma, y la política de firma de código se establece en IMPONER. Lambda bloquea la implementación.  
Código de estado HTTP: 400

 ** InvalidCodeSignatureException **   
La firma de código falló en la verificación de integridad. Si falla la verificación de integridad, Lambda bloquea la implementación, incluso si la política de firma de código está establecida en WARN (Advertencia).  
Código de estado HTTP: 400

 ** InvalidParameterValueException **   
Uno de los parámetros de la solicitud no es válido.  
Código de estado HTTP: 400

 ** ResourceConflictException **   
El recurso ya existe o hay otra operación en marcha.  
Código de estado HTTP: 409

 ** ResourceNotFoundException **   
El recurso especificado en la solicitud no existe.  
Código de estado HTTP: 404

 ** ServiceException **   
El servicio AWS Lambda detectó un error interno.  
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha superado el límite de rendimiento de la solicitud. Para obtener más información, consulte [Cuotas de Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de estado HTTP: 429

## Véase también
<a name="API_CreateFunction_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/CreateFunction) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/CreateFunction) 