# GetFunctionConfiguration
<a name="API_GetFunctionConfiguration"></a>

Devuelve la configuración específica de la versión de una función o versión de Lambda. La salida incluye solo opciones que pueden variar entre las versiones de una función. Para modificar esta configuración, utilice [UpdateFunctionConfiguration](API_UpdateFunctionConfiguration.md).

Para obtener todos los detalles de una función, incluida la configuración de nivel de función, use [GetFunction](API_GetFunction.md).

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

```
GET /2015-03-31/functions/FunctionName/configuration?Qualifier=Qualifier HTTP/1.1
```

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

La solicitud utiliza los siguientes parámetros URI.

 ** [FunctionName](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="lambda-GetFunctionConfiguration-request-FunctionName"></a>
El nombre de función de Lambda, la versión o el alias.  

**Formatos de nombre**
+  **Nombre de la función**: `my-function` (solo nombre), `my-function:v1` (con alias).
+  **ARN de la función**: `arn:aws:lambda:us-west-2:123456789012:function:my-function`.
+  **ARN parcial**: `123456789012:function:my-function`.
Puede incluir un número de versión o alias en cualquiera de los formatos. 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.  
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-_]+))?`   
Obligatorio: sí

 ** [Qualifier](#API_GetFunctionConfiguration_RequestSyntax) **   <a name="lambda-GetFunctionConfiguration-request-Qualifier"></a>
Especifique una versión o alias para obtener detalles sobre una versión publicada de la función.  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.  
Patrón: `(|[a-zA-Z0-9$_-]+)` 

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

La solicitud no tiene un cuerpo de la solicitud.

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

```
HTTP/1.1 200
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_GetFunctionConfiguration_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [Architectures](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-CodeSha256"></a>
El hash SHA256 del paquete de implementación de la función.  
Tipo: cadena

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

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

 ** [Description](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-ImageConfigResponse"></a>
Los valores de configuración de la imagen de la función.  
Tipo: objeto [ImageConfigResponse](API_ImageConfigResponse.md)

 ** [KMSKeyArn](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-LastUpdateStatusReason"></a>
El motivo de la última actualización que se realizó en la función.  
Tipo: cadena

 ** [LastUpdateStatusReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-RevisionId"></a>
La última revisión actualizada de la función o alias.  
Tipo: cadena

 ** [Role](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-StateReason"></a>
El motivo del estado actual de la función.  
Tipo: cadena

 ** [StateReasonCode](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-TracingConfig"></a>
Configuración de seguimiento de AWS X-Ray de la función.  
Tipo: objeto [TracingConfigResponse](API_TracingConfigResponse.md)

 ** [Version](#API_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-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_GetFunctionConfiguration_ResponseSyntax) **   <a name="lambda-GetFunctionConfiguration-response-VpcConfig"></a>
Configuración de red de la función.  
Tipo: objeto [VpcConfigResponse](API_VpcConfigResponse.md)

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

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

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

 ** 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_GetFunctionConfiguration_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/GetFunctionConfiguration) 
+  [AWS SDK para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [SDK de AWS para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/lambda-2015-03-31/GetFunctionConfiguration) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lambda-2015-03-31/GetFunctionConfiguration)