

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# AWS::Serverless::WebFunction

 Crea un AWS Lambda Función web, que atiende las solicitudes HTTP a través de un punto final administrado. A diferencia de una función de eventos de Lambda, que se ejecuta en respuesta a las invocaciones y los eventos, una función web ejecuta el servidor web y recibe las solicitudes HTTP directamente. Desde una sola `AWS::Serverless::WebFunction`, AWS SAM genera la función web, una revisión inmutable que contiene el código y la configuración, y un punto final que dirige el tráfico a una o más revisiones. 

**nota**  
Cuando se implementa en AWS CloudFormation, AWS SAM transforma tu AWS SAM recursos en CloudFormation recursos. Para obtener más información, consulte [Generado CloudFormation recursos para AWS SAM](sam-specification-generated-resources.md). 

**importante**  
El código de función debe ejecutar un servidor HTTP que escuche en el host y el puerto del `AWS_LAMBDA_HTTP_ENDPOINT` variable de entorno. El tiempo de ejecución no está establecido `PORT`. De forma predeterminada, el tiempo de ejecución se ejecuta `index.js` en la raíz del paquete de implementación. Utilice [EntryPoint](#sam-webfunction-entrypoint) para ejecutar un archivo diferente.

**importante**  
El bucket de Amazon S3 que contiene su paquete de implementación debe cumplir los siguientes requisitos:  
El control de versiones está habilitado.
Una política de cubos otorga `lambda.amazonaws.com` la `s3:GetObject` y `s3:GetObjectVersion` permisos. Le recomendamos que defina el alcance de la política con un `ArnLike` con la condición de `aws:SourceArn` que coincida con las revisiones de la función, por ejemplo `arn:aws:lambda:{{us-east-1}}:{{111122223333}}:web-function/{{my-function}}/revision/*`.
Si el objeto está cifrado con SSE-KMS, utiliza una clave gestionada por el cliente cuya política de claves lo permite `lambda.amazonaws.com` para llamar `kms:Decrypt`. El AWS clave gestionada para Amazon S3 (`aws/s3`) no es compatible porque no puede cambiar su política de claves.
Para ver un ejemplo de política de cubos, consulta [Política de cubos para Lambda](https://docs.aws.amazon.com/lambda/latest/dg/web-functions-code-s3.html#web-functions-code-s3-bucket-policy) en el *AWS Lambda Guía para desarrolladores*.  
Si `CodeUri` es una ruta local, el AWS SAM CLI compila y carga el código por ti. Para obtener más información, consulte [Creación e implementación de funciones web de Lambda](using-sam-cli-deploy.md#deploying-webfunctions).

## Sintaxis
<a name="sam-resource-webfunction-syntax"></a>

Para declarar esta entidad en su AWS Serverless Application Model (AWS SAM), utilice la siguiente sintaxis.

### YAML
<a name="sam-resource-webfunction-syntax.yaml"></a>

```
Type: AWS::Serverless::WebFunction
Properties:
  [AuthType](#sam-webfunction-authtype): {{String}}
  [AutoDeploymentMode](#sam-webfunction-autodeploymentmode): {{String}}
  [CodeUri](#sam-webfunction-codeuri): {{String | CodeUri}}
  [EgressNetworkConnectorArn](#sam-webfunction-egressnetworkconnectorarn): {{String}}
  [EndpointDescription](#sam-webfunction-endpointdescription): {{String}}
  [EndpointName](#sam-webfunction-endpointname): {{String}}
  [EndpointType](#sam-webfunction-endpointtype): {{String}}
  [EntryPoint](#sam-webfunction-entrypoint): {{String}}
  [EnvironmentVariables](#sam-webfunction-environmentvariables): {{Map}}
  [ExecutionRoleArn](#sam-webfunction-executionrolearn): {{String}}
  [FunctionName](#sam-webfunction-functionname): {{String}}
  [InlineCode](#sam-webfunction-inlinecode): {{String}}
  [KmsKeyArn](#sam-webfunction-kmskeyarn): {{String}}
  [LoggingConfig](#sam-webfunction-loggingconfig): {{Map}}
  [MaxConcurrencyPerEnvironment](#sam-webfunction-maxconcurrencyperenvironment): {{Integer}}
  [ReplicaRegions](#sam-webfunction-replicaregions): {{List | ReplicaRegions}}
  [RevisionDescription](#sam-webfunction-revisiondescription): {{String}}
  [RevisionWeights](#sam-webfunction-revisionweights): {{RevisionWeights}}
  [Runtime](#sam-webfunction-runtime): {{String}}
  [ScalingConfig](#sam-webfunction-scalingconfig): {{Map}}
  [Tags](#sam-webfunction-tags): {{Map}}
  [ThrottleConfig](#sam-webfunction-throttleconfig): {{Map}}
  [Timeout](#sam-webfunction-timeout): {{Integer}}
```

## Propiedades
<a name="sam-resource-webfunction-properties"></a>

 `AuthType`   <a name="sam-webfunction-authtype"></a>
Cómo el punto final autoriza las solicitudes.  
+ `IamAuth`: Lambda autoriza las solicitudes con la versión 4 de Signature e IAM. Las personas que llaman necesitan el `lambda:InvokeWebFunctionEndpoint` permiso, otorgado a través de una política basada en los recursos de la función.
+ `ApplicationManaged`: el punto final es público. Su función debe autorizar cada solicitud por sí misma.
*Valores válidos*: `IamAuth`, `ApplicationManaged`  
*Tipo*: cadena  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [AuthType](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-authtype) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `AutoDeploymentMode`   <a name="sam-webfunction-autodeploymentmode"></a>
Cómo el punto final dirige el tráfico entre las revisiones.  
+ `LatestRevision`: envía el 100% del tráfico a la revisión que crea esta implementación.
+ `Disabled`: enruta el tráfico de acuerdo con [RevisionWeights](#sam-webfunction-revisionweights).
Qué valores puede usar y si `RevisionWeights` es obligatorio, depende de [EndpointType](#sam-webfunction-endpointtype):  
+ `HomeRegion`: utilice cualquiera de los valores. Con `Disabled`, `RevisionWeights` es obligatorio.
+ `MultiRegion` o `PerRegion`: usar `Disabled`. Si omites `RevisionWeights`, el punto final dirige el 100% del tráfico a la revisión creada en la misma pila, por lo que puede crear el punto final en una sola implementación. El tráfico no se traslada a las revisiones que crean las implementaciones posteriores.
El valor debe resolverse cuando AWS SAM transforma la plantilla. UN `Ref` se admite a un parámetro. No se admiten otras funciones intrínsecas.  
*Valores válidos*: `LatestRevision`, `Disabled`  
*Tipo:* cadena  
*Obligatorio*: no  
*Valor predeterminado*: `LatestRevision`  
*CloudFormation compatibilidad*: Esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

 `CodeUri`   <a name="sam-webfunction-codeuri"></a>
La ubicación del paquete de despliegue. Especifique un `s3://{{bucket}}/{{key}}` Un URI o un objeto con `Bucket`, `Key`, y opcional `Version` llaves. Para conocer los requisitos de los cubos, consulta la nota que aparece en la parte superior de esta página.  
También puedes especificar una ruta local. El AWS SAM CLI carga el código y reemplaza la ruta por su ubicación en Amazon S3. Para obtener más información, consulte [Creación e implementación de funciones web de Lambda](using-sam-cli-deploy.md#deploying-webfunctions).  
*Escriba*: Cadena \| [CodeUri](sam-property-webfunction-codeuri.md)  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: Esta propiedad es similar a [BuildConfig.CodeConfig.S3Object](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-s3object.html) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. AWS SAM convierte un `s3://` URI en `Bucket`, `Key`, y `VersionId`. 

 `EgressNetworkConnectorArn`   <a name="sam-webfunction-egressnetworkconnectorarn"></a>
El ARN con certificación de versión de un conector de red que dirige el tráfico saliente de la función a través de la VPC. El ARN debe terminar en un número de versión, por ejemplo `arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1`. Para usar la versión más reciente de un conector en la misma plantilla, especifique `!GetAtt {{MyConnector}}.LatestVersionArn`. El conector [ComputeTypes](sam-resource-networkconnector.md#sam-networkconnector-computetypes) debe ser `WebFunction`.  
Si especificas una cadena literal, AWS SAM comprueba que se trata de un ARN de conector de red que cumple con los requisitos de versión. El servicio transfiere y valida las funciones intrínsecas. Al cambiar este valor, se crea una nueva revisión.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.EgressNetworkConnectorArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `EndpointDescription`   <a name="sam-webfunction-endpointdescription"></a>
Una descripción del punto final.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [Descripción](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-description) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `EndpointName`   <a name="sam-webfunction-endpointname"></a>
El nombre del punto de enlace. Al cambiar el nombre, se reemplaza el punto final. Cambiando `EndpointType` también reemplaza al punto final, así que cambia `EndpointName` al mismo tiempo. CloudFormation no puede reemplazar un recurso con nombre personalizado sin un nombre nuevo.  
*Tipo:* cadena  
*Obligatorio*: no  
*Valor predeterminado*: `prod`  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [EndpointName](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-endpointname) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `EndpointType`   <a name="sam-webfunction-endpointtype"></a>
Dónde el punto final sirve al tráfico.  
+ `HomeRegion`: sirve desde la región de la pila.
+ `MultiRegion`: replica la función en las regiones de [ReplicaRegions](#sam-webfunction-replicaregions) y dirige cada solicitud a la región más cercana.
+ `PerRegion`: expone un punto final independiente en cada región de réplica.
`MultiRegion` y `PerRegion` requerir `AutoDeploymentMode: Disabled`.  
*Valores válidos*: `HomeRegion`, `MultiRegion`, `PerRegion`  
*Tipo:* cadena  
*Obligatorio*: no  
*Valor predeterminado*: `HomeRegion`  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [EndpointType](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-endpointtype) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `EntryPoint`   <a name="sam-webfunction-entrypoint"></a>
El archivo que ejecuta el motor de ejecución, en relación con la raíz del paquete de implementación. AWS SAM lo pasa al tiempo de ejecución del archivo reservado `AWS_LAMBDA_NODEJS_ENTRYPOINT` variable de entorno.  
No puede usar esta propiedad cuando `EnvironmentVariables` es una función intrínseca.  
*Tipo:* cadena  
*Obligatorio*: no  
*Valor predeterminado*: `index.js`  
*CloudFormation compatibilidad*: Esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

 `EnvironmentVariables`   <a name="sam-webfunction-environmentvariables"></a>
Key-value pares para establecer como variables de entorno para la revisión.  
+ Las claves deben empezar por una letra y contener solo letras, números y guiones bajos.
+ Los valores no deben estar vacíos y tener un máximo de 4.096 caracteres.
+ AWS SAM convierte los valores numéricos y booleanos en cadenas.
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.EnvironmentVariables](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-environmentvariables) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `ExecutionRoleArn`   <a name="sam-webfunction-executionrolearn"></a>
El ARN de la función de IAM que asume la función cuando se ejecuta. Si no especificas un rol, AWS SAM crea uno con el `AWSLambdaBasicExecutionRole` política gestionada y un identificador lógico de `{{<resource-logical-id>}}Role`.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.ExecutionRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-executionrolearn) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `FunctionName`   <a name="sam-webfunction-functionname"></a>
El nombre de la función. Los nombres de las funciones deben ser únicos en una cuenta en todas las regiones. Si no especificas un nombre, AWS SAM genera uno a partir del ID lógico y el ID de pila, con un máximo de 64 caracteres. Al cambiar el nombre, se sustituyen la función, su revisión y su punto final.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [FunctionName](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunction.html#cfn-lambda-webfunction-functionname) propiedad de un `AWS::Lambda::WebFunction` recurso. El generado `AWS::Lambda::WebFunctionRevision` y `AWS::Lambda::WebFunctionEndpoint` uso de recursos `Ref` para hacer referencia a la función. 

 `InlineCode`   <a name="sam-webfunction-inlinecode"></a>
No se admite para `AWS::Serverless::WebFunction`. Utilice [CodeUri](#sam-webfunction-codeuri).  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

 `KmsKeyArn`   <a name="sam-webfunction-kmskeyarn"></a>
El ARN del AWS KMS clave utilizada para cifrar las variables de entorno de la revisión.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionrevision.html#cfn-lambda-webfunctionrevision-kmskeyarn) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `LoggingConfig`   <a name="sam-webfunction-loggingconfig"></a>
La configuración de registro para la revisión, como el grupo de registros y los niveles de registro.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.TelemetryConfig.LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-telemetryconfig.html#cfn-lambda-webfunctionrevision-telemetryconfig-loggingconfig) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `MaxConcurrencyPerEnvironment`   <a name="sam-webfunction-maxconcurrencyperenvironment"></a>
El número máximo de solicitudes simultáneas que gestiona cada entorno de ejecución.  
*Tipo*: entero  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.MaxConcurrencyPerEnvironment](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-maxconcurrencyperenvironment) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `ReplicaRegions`   <a name="sam-webfunction-replicaregions"></a>
Las regiones en las que replicar la función. Utilice esta propiedad con `MultiRegion` y `PerRegion` puntos finales. Especifique una lista de códigos de región y grupos de regiones, o un objeto con `IncludeRegions` y opcional `ExcludeRegions`.  
*Escriba*: Lista \| [ReplicaRegions](sam-property-webfunction-replicaregions.md)  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad es similar a [Regiones](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-regions) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. AWS SAM amplía los grupos de regiones y aplica `ExcludeRegions` para producir la lista de regiones. 

 `RevisionDescription`   <a name="sam-webfunction-revisiondescription"></a>
Una descripción de la revisión que crea esta implementación.  
*Tipo:* cadena  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [Descripción](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionrevision.html#cfn-lambda-webfunctionrevision-description) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `RevisionWeights`   <a name="sam-webfunction-revisionweights"></a>
Un mapa de los ID de revisión y la ponderación del tráfico. Utilice esta propiedad cuando `AutoDeploymentMode` es `Disabled`. Especifique hasta dos revisiones. Cada peso es un número entero comprendido entre 1 y 100 y los pesos deben sumar 100.  
*Tipo:* [RevisionWeights](sam-property-webfunction-revisionweights.md)  
*Obligatorio*: condicional. Obligatorio cuando `AutoDeploymentMode` es `Disabled` y `EndpointType` es `HomeRegion`.  
*CloudFormation compatibilidad*: Esta propiedad es similar a [RevisionWeights](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-revisionweights) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. AWS SAM convierte el mapa en una lista de `RevisionId` y `Weight` objetos. 

 `Runtime`   <a name="sam-webfunction-runtime"></a>
El tiempo de ejecución de la función, por ejemplo `nodejs24.x`.  
*Tipo:* cadena  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [BuildConfig.RuntimeConfig.Runtime](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-runtimeconfig.html#cfn-lambda-webfunctionrevision-runtimeconfig-runtime) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

 `ScalingConfig`   <a name="sam-webfunction-scalingconfig"></a>
La configuración de escalado del punto final, como el número máximo de entornos de ejecución.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-scalingconfig) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `Tags`   <a name="sam-webfunction-tags"></a>
Un mapa de pares clave-valor que especifica las etiquetas agregadas a la función y al rol de ejecución que AWS SAM genera.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad es similar a [Etiquetas](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunction.html#cfn-lambda-webfunction-tags) propiedad de un `AWS::Lambda::WebFunction` recurso. El `Tags` propiedad en AWS SAM consiste en pares clave-valor (mientras que en CloudFormation esta propiedad consiste en una lista de `Tag` objetos). Además, AWS SAM añade automáticamente un `lambda:createdBy:SAM` etiqueta a la función y al rol predeterminado que se genera para ella. 

 `ThrottleConfig`   <a name="sam-webfunction-throttleconfig"></a>
La configuración de limitación para el punto final, como la velocidad máxima de solicitudes.  
*Tipo*: mapa  
*Obligatorio*: no  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ThrottleConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-throttleconfig) propiedad de un `AWS::Lambda::WebFunctionEndpoint` recurso. 

 `Timeout`   <a name="sam-webfunction-timeout"></a>
El tiempo máximo, en segundos, que la función puede ejecutarse por solicitud. Los valores válidos van de 3 a 900.  
*Tipo*: entero  
*Obligatorio*: no  
*Valor predeterminado*: `30`  
*CloudFormation compatibilidad*: Esta propiedad se pasa directamente al [ServiceConfig.TimeoutSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-timeoutseconds) propiedad de un `AWS::Lambda::WebFunctionRevision` recurso. 

## valores devueltos
<a name="sam-resource-webfunction-return-values"></a>

### Ref.
<a name="sam-resource-webfunction-return-values-ref"></a>

Cuando el identificador lógico de este recurso se proporciona al `Ref` función intrínseca, devuelve el ARN de la función web. Cuando necesite el nombre de la función, utilice el valor de `FunctionName` en su lugar.

Para obtener más información sobre el uso de la función `Ref`, consulta [`Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) en la *Guía del usuario de AWS CloudFormation *.

### Diversión::GetAtt
<a name="sam-resource-webfunction-return-values-fn--getatt"></a>

`Fn::GetAtt` devuelve un valor para un atributo especificado de este tipo. A continuación se indican los atributos disponibles y los valores devueltos de muestra.

Para obtener más información acerca de cómo usar `Fn::GetAtt`, consulta [`Fn::GetAtt`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) en la *Guía del usuario de AWS CloudFormation *.

`FunctionArn`  <a name="sam-webfunction-getatt-functionarn"></a>
El nombre de recurso de Amazon (ARN) de la función web.

`State`  <a name="sam-webfunction-getatt-state"></a>
El estado actual de la función web.

`StateReason`  <a name="sam-webfunction-getatt-statereason"></a>
El motivo del estado actual de la función web.

`CreatedAt`  <a name="sam-webfunction-getatt-createdat"></a>
La hora en que se creó la función web.

`UpdatedAt`  <a name="sam-webfunction-getatt-updatedat"></a>
Hora en la que se actualizó por última vez la función web.

Para hacer referencia a la revisión o al punto final que AWS SAM genera, usa sus ID lógicos, `{{<resource-logical-id>}}Revision` y `{{<resource-logical-id>}}Endpoint`. Por ejemplo, `!GetAtt MyWebFunctionEndpoint.DomainName` devuelve el nombre de dominio del punto final de una función web con el identificador lógico `MyWebFunction`. Para obtener más información, consulte [CloudFormation recursos generados cuando AWS::Serverless::WebFunction está especificado](sam-specification-generated-resources-webfunction.md).

## Ejemplos
<a name="sam-resource-webfunction-examples"></a>

### Función web básica
<a name="sam-resource-webfunction-example-basic"></a>

El siguiente ejemplo crea una función web con un IAM-authorized punto final en la región de la pila. AWS SAM genera el rol de ejecución y el punto final dirige todo el tráfico a la revisión que crea esta implementación.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      Timeout: 30

Outputs:
  EndpointUrl:
    Value: !Sub https://${MyWebFunctionEndpoint.DomainName}
```

### Divida el tráfico entre dos revisiones
<a name="sam-resource-webfunction-example-canary"></a>

El siguiente ejemplo desactiva la implementación automática y envía el 90% del tráfico a una revisión existente y el 10% a otra. Ambas revisiones ya deben existir.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri: s3://amzn-s3-demo-bucket/webfn-v2.zip
      AutoDeploymentMode: Disabled
      RevisionWeights:
        rev-abc123: 90
        rev-def456: 10
```

### Multi-Region Función web
<a name="sam-resource-webfunction-example-multiregion"></a>

El siguiente ejemplo replica la función en las regiones de EE. UU., excepto `us-west-1` y dirige cada solicitud a la región más cercana. Porque `RevisionWeights` se omite, el punto final dirige todo el tráfico a la revisión creada en esta pila.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      EndpointName: prodmr
      EndpointType: MultiRegion
      AutoDeploymentMode: Disabled
      ReplicaRegions:
        IncludeRegions:
          - US
        ExcludeRegions:
          - us-west-1
```

### Función web con salida de VPC
<a name="sam-resource-webfunction-example-vpc-egress"></a>

En el siguiente ejemplo, se crea un conector de red para Web Functions y se dirige el tráfico saliente de la función a través de las subredes y los grupos de seguridad del conector.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyConnector:
    Type: AWS::Serverless::NetworkConnector
    Properties:
      ComputeTypes:
        - WebFunction
      VpcConfig:
        SubnetIds:
          - subnet-0abc123def4567890
          - subnet-0def456abc7890123
        SecurityGroupIds:
          - sg-0abc1234abcde0001
        NetworkProtocol: IPv4

  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      EgressNetworkConnectorArn: !GetAtt MyConnector.LatestVersionArn
```