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, enrutando el 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.

nota

Cuando lo implementa AWS CloudFormation, AWS SAM transforma sus AWS SAM recursos en recursos. CloudFormation 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:
  Name: String
  OperatorRole: String
  PropagateTags: Boolean
  Tags: Map
  VpcConfig: VpcConfig

Propiedades

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 también se inyecta AssociatedComputeResourceTypes: [MicroVm] automáticamente.

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.

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