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

Cria uma função do Lambda. Para criar uma função, você precisa de um [pacote de implantação](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html) e de uma [função de execução](https://docs.aws.amazon.com/lambda/latest/dg/intro-permission-model.html#lambda-intro-execution-role). O pacote de implantação é um arquivamento de arquivo.zip ou uma imagem de contêiner que contém seu código de função. O perfil de execução concede à função permissão para usar os Serviços da AWS, como o Amazon CloudWatch Logs para streaming de logs e o AWS X-Ray para rastreamento de solicitações.

Se o pacote de implantação for uma [imagem de contêiner](https://docs.aws.amazon.com/lambda/latest/dg/lambda-images.html), defina o tipo de pacote como `Image`. Para uma imagem de contêiner, a propriedade code deve incluir o URI de uma imagem de contêiner no registro do Amazon ECR. Você não precisa especificar as propriedades do manipulador e do runtime.

Se o pacote de implantação for um [arquivo .zip](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-package.html#gettingstarted-package-zip), defina o tipo de pacote como `Zip`. Para um arquivamento de arquivo.zip, a propriedade code especifica a localização do arquivo.zip. Você também deve especificar as propriedades do manipulador e do runtime. O código no pacote de implantação deve ser compatível com a arquitetura do conjunto de instruções de destino da função (`x86-64` ou `arm64`). Se você não especificar a arquitetura, o valor padrão será `x86-64`.

Quando você cria uma função, o Lambda provisiona uma instância da função e seus recursos de suporte. Se sua função se conecta a uma VPC, esse processo pode demorar mais ou menos um minuto. Durante esse período, não será possível invocar ou modificar a função. Os campos `State`, `StateReason` e `StateReasonCode` na resposta de [GetFunctionConfiguration](API_GetFunctionConfiguration.md) indicam quando a função está pronta para ser invocada. Para obter mais informações, consulte [Estados da função do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/functions-states.html).

Uma função tem uma versão não publicada e pode ter versões e aliases publicados. A versão não publicada muda quando você atualiza o código e a configuração da função. Uma versão publicada é um snapshot do código e da configuração da função que não pode ser alterado. Um alias é um recurso nomeado que mapeia para uma versão e pode ser alterado para mapear para uma versão diferente. Use o parâmetro `Publish` para criar a versão `1` de sua função com base em sua configuração inicial.

Os outros parâmetros permitem que você defina configurações específicas da versão e em nível de função. Você pode modificar configurações específicas da versão posteriormente com [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md). As configurações em nível de função se aplicam às versões não publicadas e publicadas da função e incluem etiquetas ([TagResource](API_TagResource.md)) e limites de simultaneidade por função ([PutFunctionConcurrency](API_PutFunctionConcurrency.md)).

Você pode usar a assinatura de código se o pacote de implantação for um arquivamento do arquivo .zip. Para ativar a assinatura de código para essa função, especifique o ARN de uma configuração de assinatura de código. Quando um usuário tenta implantar um pacote de código com [UpdateFunctionCode](API_UpdateFunctionCode.md), o Lambda verifica se o pacote de código tem uma assinatura válida de um fornecedor confiável. A configuração de assinatura de código inclui um conjunto de perfis de assinatura, que define os editores confiáveis ​​para esta função.

Se outra Conta da AWS ou um AWS service (Serviço da AWS) invocar sua função, use [AddPermission](API_AddPermission.md) para conceder permissões ao criar uma política do AWS Identity and Access Management (IAM) baseada em recursos. Você pode conceder permissões em nível de função, em uma versão ou em um alias.

Para invocar sua função diretamente, use [Invoke](API_Invoke.md). Para invocar sua função em resposta a eventos em outros Serviços da AWS, crie um mapeamento da origem do evento ([CreateEventSourceMapping](API_CreateEventSourceMapping.md)) ou configure um acionador de função no outro serviço. Para obter mais informações, consulte [Invocar funções do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-invocation.html).

## Sintaxe da Solicitação
<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 da solicitação de URI
<a name="API_CreateFunction_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_CreateFunction_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [Architectures](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Architectures"></a>
A arquitetura do conjunto de instruções compatível com a função. Insira uma matriz de strings com um dos valores válidos (arm64 ou x86\$164). O valor padrão é `x86_64`.  
Tipo: matriz de strings  
Membros da matriz: número fixo de 1 item.  
Valores Válidos: `x86_64 | arm64`   
Obrigatório: não

 ** [Code](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Code"></a>
O código da função.  
Tipo: objeto [FunctionCode](API_FunctionCode.md)  
Obrigatório: sim

 ** [CodeSigningConfigArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-CodeSigningConfigArn"></a>
Para ativar a assinatura de código para essa função, especifique o ARN de uma configuração de assinatura de código. Uma configuração de assinatura de código inclui um conjunto de perfis de assinatura que define os editores confiáveis para essa função.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 200.  
Padrão: `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}`   
Obrigatório: não

 ** [DeadLetterConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-DeadLetterConfig"></a>
Uma configuração de fila de mensagens não entregues que especifica a fila ou o tópico para o qual o Lambda envia eventos assíncronos quando eles apresentam falhas no processamento. Para obter mais informações, consulte [Filas de mensagens não entregues](https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-dlq).  
Tipo: objeto [DeadLetterConfig](API_DeadLetterConfig.md)  
Obrigatório: não

 ** [Description](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Description"></a>
Uma descrição da função.  
Tipo: string  
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.  
Obrigatório: não

 ** [Environment](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Environment"></a>
As variáveis de ambiente que são acessíveis pelo código de função durante a execução.  
Tipo: objeto [Environment](API_Environment.md)  
Obrigatório: não

 ** [EphemeralStorage](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-EphemeralStorage"></a>
O tamanho do diretório `/tmp` da função em MB. O valor padrão é 512, mas pode ser qualquer número inteiro entre 512 e 10.240 MB. Para obter mais informações, consulte [Como configurar o armazenamento temporário (console)](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-ephemeral-storage).  
Tipo: objeto [EphemeralStorage](API_EphemeralStorage.md)  
Obrigatório: não

 ** [FileSystemConfigs](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FileSystemConfigs"></a>
Configurações de conexão para um sistema de arquivos do Amazon EFS.  
Tipo: matriz de objetos [FileSystemConfig](API_FileSystemConfig.md)  
Membros da matriz: número máximo de 1 item.  
Obrigatório: não

 ** [FunctionName](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-FunctionName"></a>
O nome da função do Lambda.  

**Formatos de nome**
+  **Nome da função**: `my-function`.
+  **ARN da função**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
A restrição de comprimento se aplica apenas ao ARN completo. Se você especificar apenas o nome da função, ele será limitado a 64 caracteres.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Padrão: `(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-_]+))?`   
Exigido: Sim

 ** [Handler](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Handler"></a>
O nome do método em seu código que o Lambda chama para executar a função. O manipulador é necessário quando o pacote de implantação é um arquivo do arquivo .zip. O formato inclui o nome do arquivo. Ele também pode incluir namespaces e outros qualificadores, dependendo do runtime. Para obter mais informações, consulte [Modelo de programação do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/foundation-progmodel.html).  
Tipo: string  
Restrições de tamanho: tamanho máximo de 128.  
Padrão: `[^\s]+`   
Obrigatório: não

 ** [ImageConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-ImageConfig"></a>
[Valores de configuração](https://docs.aws.amazon.com/lambda/latest/dg/configuration-images.html#configuration-images-settings) da imagem do contêiner que substituem os valores do Dockerfile da imagem do contêiner.  
Tipo: objeto [ImageConfig](API_ImageConfig.md)  
Obrigatório: não

 ** [KMSKeyArn](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-KMSKeyArn"></a>
O ARN da chave gerenciada pelo cliente do AWS Key Management Service (AWS KMS) que é usada para criptografar as [variáveis de ambiente](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) da sua função. Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) é ativado, o Lambda também usa essa chave para criptografar o snapshot da função. Se você implantar a função usando uma imagem de contêiner, o Lambda também usará essa chave para criptografar a função quando ela for implantada. Essa não é a mesma chave usada para proteger a imagem do contêiner no Amazon Elastic Container Registry (Amazon ECR). Se você não fornecer uma chave gerenciada pelo cliente, o Lambda usará uma chave de serviço padrão.  
Tipo: string  
Padrão: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()`   
Obrigatório: não

 ** [Layers](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Layers"></a>
Uma lista de [camadas de função](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) para adicionar ao ambiente de execução da função. Especifique cada camada por seu ARN, incluindo a versão.  
Tipo: matriz de strings  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 140.  
Padrão: `arn:[a-zA-Z0-9-]+:lambda:[a-zA-Z0-9-]+:\d{12}:layer:[a-zA-Z0-9-_]+:[0-9]+`   
Obrigatório: não

 ** [LoggingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-LoggingConfig"></a>
As configurações do Amazon CloudWatch Logs da função.  
Tipo: objeto [LoggingConfig](API_LoggingConfig.md)  
Obrigatório: não

 ** [MemorySize](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-MemorySize"></a>
A quantidade de [memória disponível para a função](https://docs.aws.amazon.com/lambda/latest/dg/configuration-function-common.html#configuration-memory-console) no runtime. Aumentar a memória de função também aumenta sua alocação de CPU. O valor padrão é 128 MB. O valor pode ser qualquer múltiplo de 1 MB.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 128. Valor máximo de 10240.  
Obrigatório: não

 ** [PackageType](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-PackageType"></a>
O tipo de pacote de implantação. Defina como `Image` para a imagem de contêiner e defina `Zip` para o arquivo .zip.  
Tipo: string  
Valores Válidos: `Zip | Image`   
Obrigatório: não

 ** [Publish](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Publish"></a>
Defina como “true” para publicar a primeira versão da função durante a criação.  
Tipo: booliano  
Obrigatório: não

 ** [Role](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Role"></a>
O nome de recurso da Amazon (ARN) da função de execução da função.  
Tipo: string  
Padrão: `arn:(aws[a-zA-Z-]*)?:iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Exigido: Sim

 ** [Runtime](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Runtime"></a>
O identificador do [runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) da função. O runtime é necessário quando o pacote de implantação é um arquivo .zip.  
A lista a seguir inclui os tempos de execução obsoletos. Para obter mais informações, consulte a [Política de descontinuação de runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Tipo: string  
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`   
Obrigatório: não

 ** [SnapStart](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-SnapStart"></a>
A configuração do [SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) da função.  
Tipo: objeto [SnapStart](API_SnapStart.md)  
Obrigatório: não

 ** [Tags](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Tags"></a>
Uma lista de [tags](https://docs.aws.amazon.com/lambda/latest/dg/tagging.html) para aplicar à função.  
Tipo: mapa de string para string  
Obrigatório: não

 ** [Timeout](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-Timeout"></a>
A quantidade de tempo (em segundos) que o Lambda permite que uma função seja executada antes de encerrá-la. O padrão é 3 segundos. O valor máximo permitido é de 900 segundos. Para obter mais informações, consulte [Ambiente de execução do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/runtimes-context.html).  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1.  
Obrigatório: não

 ** [TracingConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-TracingConfig"></a>
Defina `Mode` como `Active` para criar uma amostra e rastrear um subconjunto de solicitações de entrada com o [x-Ray](https://docs.aws.amazon.com/lambda/latest/dg/services-xray.html).  
Tipo: objeto [TracingConfig](API_TracingConfig.md)  
Obrigatório: não

 ** [VpcConfig](#API_CreateFunction_RequestSyntax) **   <a name="lambda-CreateFunction-request-VpcConfig"></a>
Para a conectividade de rede para os recursos da AWS em uma VPC, especifique uma lista de grupos de segurança e sub-redes na VPC. Quando você conecta uma função a uma VPC, ela poderá acessar os recursos e a Internet somente por meio dessa VPC. Para obter mais informações, consulte [Configuração de uma função do Lambda para acessar recursos em uma VPC](https://docs.aws.amazon.com/lambda/latest/dg/configuration-vpc.html).  
Tipo: objeto [VpcConfig](API_VpcConfig.md)  
Obrigatório: não

## Sintaxe da Resposta
<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 Resposta
<a name="API_CreateFunction_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 201.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [Architectures](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Architectures"></a>
A arquitetura do conjunto de instruções compatível com a função. A arquitetura é uma matriz de strings com um dos valores válidos. O valor da arquitetura padrão é `x86_64`.  
Tipo: matriz de strings  
Membros da matriz: número fixo de 1 item.  
Valores Válidos: `x86_64 | arm64` 

 ** [CodeSha256](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSha256"></a>
O hash SHA256 do pacote de implantação da função.  
Tipo: string

 ** [CodeSize](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-CodeSize"></a>
O tamanho do pacote de implantação da função em bytes.  
Tipo: longo

 ** [DeadLetterConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-DeadLetterConfig"></a>
A fila de mensagens mortas da função.  
Tipo: objeto [DeadLetterConfig](API_DeadLetterConfig.md)

 ** [Description](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Description"></a>
A descrição da função.  
Tipo: string  
Restrições de comprimento: comprimento mínimo 0. Comprimento máximo de 256.

 ** [Environment](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Environment"></a>
As [variáveis de ambiente](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html) da função. Omitido dos logs do AWS CloudTrail.  
Tipo: objeto [EnvironmentResponse](API_EnvironmentResponse.md)

 ** [EphemeralStorage](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-EphemeralStorage"></a>
O tamanho do diretório `/tmp` da função em MB. O valor padrão é 512, mas pode ser qualquer número inteiro entre 512 e 10.240 MB. Para obter mais informações, consulte [Como configurar o armazenamento temporário (console)](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>
Configurações de conexão para um [sistema de arquivos do Amazon EFS](https://docs.aws.amazon.com/lambda/latest/dg/configuration-filesystem.html).  
Tipo: matriz de objetos [FileSystemConfig](API_FileSystemConfig.md)  
Membros da matriz: número máximo de 1 item.

 ** [FunctionArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-FunctionArn"></a>
O nome do recurso da Amazon (ARN) da função.  
Tipo: string  
Padrão: `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>
Nome da função.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 170.  
Padrão: `(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>
A função que o Lambda chama para começar a executar sua função.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 128.  
Padrão: `[^\s]+` 

 ** [ImageConfigResponse](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-ImageConfigResponse"></a>
Os valores de configuração da imagem da função.  
Tipo: objeto [ImageConfigResponse](API_ImageConfigResponse.md)

 ** [KMSKeyArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-KMSKeyArn"></a>
A AWS KMS key é usada para criptografar as [variáveis de ambiente](https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-encryption) da função. Quando o [Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart-security.html) é ativado, essa chave também é usada para criptografar o snapshot da função. Essa chave será retornada somente se você tiver configurado uma chave gerenciada pelo cliente.  
Tipo: string  
Padrão: `(arn:(aws[a-zA-Z-]*)?:[a-z0-9-.]+:.*)|()` 

 ** [LastModified](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastModified"></a>
A data e a hora em que a função foi atualizada, no [formato ISO-8601](https://www.w3.org/TR/NOTE-datetime) (AAAA-MM-DDThh:mm:ss.sTZD).  
Tipo: string

 ** [LastUpdateStatus](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatus"></a>
O status da última atualização que foi executada na função. Ele é definido pela primeira vez como `Successful` após a conclusão da criação da função.  
Tipo: string  
Valores Válidos: `Successful | Failed | InProgress` 

 ** [LastUpdateStatusReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReason"></a>
O motivo pelo qual foi realizada a última atualização na função.  
Tipo: string

 ** [LastUpdateStatusReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LastUpdateStatusReasonCode"></a>
O código do motivo pelo qual foi realizada a última atualização na função.  
Tipo: string  
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>
As [camadas](https://docs.aws.amazon.com/lambda/latest/dg/configuration-layers.html) da função.  
Tipo: matriz de objetos [Layer](API_Layer.md)

 ** [LoggingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-LoggingConfig"></a>
As configurações do Amazon CloudWatch Logs da função.  
Tipo: objeto [LoggingConfig](API_LoggingConfig.md)

 ** [MasterArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-MasterArn"></a>
Para funções do Lambda@Edge, o ARN da função principal.  
Tipo: string  
Padrão: `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>
A quantidade de memória disponível para a função no runtime.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 128. Valor máximo de 10240.

 ** [PackageType](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-PackageType"></a>
O tipo de pacote de implantação. Defina como `Image` para imagem de contêiner e defina `Zip` para arquivo de documento .zip.  
Tipo: string  
Valores Válidos: `Zip | Image` 

 ** [RevisionId](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-RevisionId"></a>
A última revisão atualizada da função ou do alias.  
Tipo: string

 ** [Role](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Role"></a>
A função de execução da função.  
Tipo: string  
Padrão: `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>
O identificador do [runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) da função. O runtime é necessário quando o pacote de implantação é um arquivo .zip.  
A lista a seguir inclui os tempos de execução obsoletos. Para obter mais informações, consulte a [Política de descontinuação de runtime](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy).  
Tipo: string  
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>
O ARN do runtime e quaisquer erros ocorridos.  
Tipo: objeto [RuntimeVersionConfig](API_RuntimeVersionConfig.md)

 ** [SigningJobArn](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-SigningJobArn"></a>
O ARN do trabalho de assinatura.  
Tipo: string  
Padrão: `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>
O ARN da versão do perfil de assinatura.  
Tipo: string  
Padrão: `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>
Defina `ApplyOn` como `PublishedVersions` para criar um snapshot do ambiente de execução inicializado ao publicar uma versão de função. Para obter mais informações, consulte [Improving startup performance with Lambda SnapStart](https://docs.aws.amazon.com/lambda/latest/dg/snapstart.html) (Como aprimorar a performance da inicialização com o Lambda SnapStart).  
Tipo: objeto [SnapStartResponse](API_SnapStartResponse.md)

 ** [State](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-State"></a>
O estado atual da função. Quando o estado é `Inactive`, você pode invocar a função para reativá-la.  
Tipo: string  
Valores Válidos: `Pending | Active | Inactive | Failed` 

 ** [StateReason](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReason"></a>
O motivo para o estado atual da função.  
Tipo: string

 ** [StateReasonCode](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-StateReasonCode"></a>
O código do motivo para o estado atual da função. Quando o código for `Creating`, não será possível invocar ou modificar a função.  
Tipo: string  
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>
A quantidade de tempo, em segundos, que o Lambda permite que uma função seja executada antes de encerrá-la.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1.

 ** [TracingConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-TracingConfig"></a>
A configuração de rastreamento do AWS X-Ray da função.  
Tipo: objeto [TracingConfigResponse](API_TracingConfigResponse.md)

 ** [Version](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-Version"></a>
A versão da função do Lambda.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 1024.  
Padrão: `(\$LATEST|[0-9]+)` 

 ** [VpcConfig](#API_CreateFunction_ResponseSyntax) **   <a name="lambda-CreateFunction-response-VpcConfig"></a>
A configuração de rede da função.  
Tipo: objeto [VpcConfigResponse](API_VpcConfigResponse.md)

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

Para obter informações sobre os erros que todas as ações retornam, consulte [Erros comuns](CommonErrors.md).

 ** CodeSigningConfigNotFoundException **   
A configuração de assinatura de código especificada não existe.  
Código de Status HTTP: 404

 ** CodeStorageExceededException **   
Sua Conta da AWS excedeu o tamanho máximo total do código. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html).  
Código de Status HTTP: 400

 ** CodeVerificationFailedException **   
A assinatura de código falhou em uma ou mais verificações de validação em relação à incompatibilidade ou expiração de assinatura, e a política de assinatura de código está definida como ENFORCE. O Lambda bloqueia a implantação.  
Código de Status HTTP: 400

 ** InvalidCodeSignatureException **   
A assinatura de código falhou na verificação de integridade. Se a verificação de integridade falhar, o Lambda bloqueará a implantação, mesmo que a política de assinatura de código esteja definida como WARN.  
Código de Status HTTP: 400

 ** InvalidParameterValueException **   
Um dos parâmetros da solicitação não é válido.  
Código de Status HTTP: 400

 ** ResourceConflictException **   
O recurso já existe ou outra operação está em andamento.  
Código de status HTTP: 409

 ** ResourceNotFoundException **   
O recurso especificado na solicitação não existe.  
Código de Status HTTP: 404

 ** ServiceException **   
O serviço AWS Lambda encontrou um erro interno.  
Código de Status HTTP: 500

 ** TooManyRequestsException **   
O limite de throughput da solicitação foi excedido. Para obter mais informações, consulte [Cotas do Lambda](https://docs.aws.amazon.com/lambda/latest/dg/gettingstarted-limits.html#api-requests).  
Código de status HTTP: 429

## Ver também
<a name="API_CreateFunction_SeeAlso"></a>

Para mais informações sobre como usar essa API em um dos AWS SDKs de idiomas específicos, consulte o seguinte:
+  [AWS Interface de linha de comando](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) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for 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 for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/CreateFunction) 
+  [AWS SDK for 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)