View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
SintaxisPropiedadesvalores devueltosEjemplos

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::NetworkConnector

Crea un conector AWS Lambda de red que define la conectividad de red para los recursos informáticos de Lambda. Un conector de red especifica cómo se conectan los recursos informáticos a las redes, por ejemplo, mediante el enrutamiento del tráfico de salida a través de una VPC del cliente mediante interfaces de red elásticas (ENI) que el servicio aprovisiona en subredes y grupos de seguridad específicos. Cada conector sirve para un tipo de procesamiento, ya sea microVMS o Web Functions. Para usar un conector con un AWS::Serverless:: WebFunction, ComputeTypes defina WebFunction y pase el conector LatestVersionArn a la propiedad de la función. EgressNetworkConnectorArn

nota

Cuando despliegas en AWS CloudFormation, AWS SAM transforma tus AWS SAM recursos en CloudFormation recursos. Para obtener más información, consulte Generado CloudFormation recursos para AWS SAM.

Sintaxis

Para declarar esta entidad en tu plantilla AWS Serverless Application Model (AWS SAM), usa la siguiente sintaxis.

YAML

Type: AWS::Serverless::NetworkConnector
Properties:
  ComputeTypes: List
  Name: String
  OperatorRole: String
  PropagateTags: Boolean
  Tags: Map
  VpcConfig: VpcConfig

Propiedades

ComputeTypes

El tipo de recurso informático Lambda que puede utilizar este conector de red. Especifique exactamente uno de los siguientes valores:

Tipo: lista

Obligatorio: no

Valor predeterminado: [MicroVm]

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Configuration.VpcEgressConfiguration.AssociatedComputeResourceTypes propiedad de un AWS::Lambda::NetworkConnector recurso.

Name

El nombre del conector de red. El nombre debe ser único en su cuenta y región.

Tipo: cadena

Obligatorio: no

CloudFormation compatibilidad: esta propiedad se transfiere directamente a la Name propiedad de un AWS::Lambda::NetworkConnector recurso.

OperatorRole

El ARN de la función de IAM que asume el servicio de conector de red para crear y administrar interfaces de red elásticas (ENI).

Tipo: cadena

Obligatorio: no

CloudFormation compatibilidad: esta propiedad es similar a la OperatorRole propiedad de un recurso. AWS::Lambda::NetworkConnector Esto es obligatorio en CloudFormation , pero no en AWS SAM. Si no especifica un rol, AWS SAM crea uno con un identificador lógico de<resource-logical-id>OperatorRole.

PropagateTags

Especifica si se deben pasar etiquetas de la Tags propiedad a los recursos generados, como el rol de operador generado automáticamente.

Tipo: Booleano

Obligatorio: no

Valor predeterminado: False

CloudFormation compatibilidad: esta propiedad es exclusiva de AWS SAM y no tiene un CloudFormation equivalente.

Tags

Un mapa de pares clave-valor que especifica las etiquetas agregadas a este conector de red.

Tipo: mapa

Obligatorio: no

CloudFormation compatibilidad: esta propiedad es similar a la Tags propiedad de un AWS::Lambda::NetworkConnector recurso. La Tags propiedad en se AWS SAM compone de pares clave-valor (mientras que en CloudFormation esta propiedad se compone de una lista de Tag objetos). Además, agrega AWS SAM automáticamente una lambda:createdBy:SAM etiqueta a este conector de red y a las funciones predeterminadas que se generan para él.

VpcConfig

La configuración de salida de VPC para el conector de red. Especifica las subredes, los grupos de seguridad y el protocolo de red para enrutar el tráfico saliente a través de la VPC.

Tipo: VpcConfig

Obligatorio: sí

CloudFormation compatibilidad: esta propiedad se transforma en la Configuration.VpcEgressConfiguration propiedad de un recurso. AWS::Lambda::NetworkConnector AWS SAM conjuntos AssociatedComputeResourceTypes de la ComputeTypespropiedad.

valores devueltos

Ref.

Cuando se proporciona el identificador lógico de este recurso a la función Ref intrínseca, devuelve el ARN del conector de red.

Para obtener más información sobre el uso de la función Ref, consulta Ref en la Guía del usuario de AWS CloudFormation .

Ventilador:: GetAtt

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 en la Guía del usuario de AWS CloudFormation .

Arn

El nombre de recurso de Amazon (ARN) del conector de red.

LatestVersionArn

El ARN compatible con la versión de la última versión del conector de red, por ejemplo. arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1 Utilice este valor para la EgressNetworkConnectorArn propiedad de unAWS::Serverless::. WebFunction

State

El estado actual del conector de red. Los valores válidos son PENDING, ACTIVE, INACTIVE, FAILED, DELETING y DELETE_FAILED.

Ejemplos

Conector de red básico con función generada automáticamente

En el siguiente ejemplo, se crea un conector de red de salida de VPC. AWS SAM genera automáticamente el rol de operador.

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

Resources:
  MyVpcConnector:
    Type: AWS::Serverless::NetworkConnector
    Properties:
      Name: my-vpc-connector
      VpcConfig:
        SubnetIds:
          - subnet-0abc123def4567890
          - subnet-0def456abc7890123
        SecurityGroupIds:
          - sg-0abc1234abcde0001
        NetworkProtocol: IPv4
      Tags:
        Environment: Production

Conector de red para una función web

El siguiente ejemplo crea un conector de red para Web Functions y lo utiliza para el tráfico saliente de una función web.

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

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

  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri: s3://amzn-s3-demo-bucket/webfn.zip
      EgressNetworkConnectorArn: !GetAtt MyWebFunctionConnector.LatestVersionArn