View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
SintaxePropriedadesValores de retornoExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS::Serverless::NetworkConnector

Cria um conector AWS Lambda de rede que define a conectividade de rede para recursos de computação Lambda. Um conector de rede especifica como os recursos computacionais se conectam às redes, por exemplo, roteando o tráfego de saída por meio de uma VPC do cliente usando interfaces de rede elásticas (ENIs) que o serviço provisiona em sub-redes e grupos de segurança especificados. Cada conector serve para um tipo de computação, microVMS ou funções da Web. Para usar um conector com AWS::Serverless:: WebFunction, ComputeTypes defina WebFunction e transmita o conector LatestVersionArn para a EgressNetworkConnectorArn propriedade da função.

nota

Quando você implanta AWS CloudFormation, AWS SAM transforma seus AWS SAM recursos em CloudFormation recursos. Para obter mais informações, consulte Gerado CloudFormation recursos para AWS SAM.

Sintaxe

Para declarar essa entidade em seu modelo AWS Serverless Application Model (AWS SAM), use a sintaxe a seguir.

YAML

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

Propriedades

ComputeTypes

O tipo de recurso de computação Lambda que pode usar esse conector de rede. Especifique exatamente um dos seguintes valores:

  • MicroVm: o conector é usado pelos recursos computacionais do MicroVM.

  • WebFunction: O conector é usado por AWS::Serverless:: WebFunction recursos por meio de suas EgressNetworkConnectorArn propriedades.

Tipo: lista

Obrigatório: não

Padrão: [MicroVm]

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Configuration.VpcEgressConfiguration.AssociatedComputeResourceTypes propriedade de um AWS::Lambda::NetworkConnector recurso.

Name

O nome do conector de rede. O nome deve ser exclusivo em sua conta e região.

Tipo: string

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é passada diretamente para a Name propriedade de um AWS::Lambda::NetworkConnector recurso.

OperatorRole

O ARN da função do IAM que o serviço de conector de rede assume para criar e gerenciar interfaces de rede elásticas (ENIs).

Tipo: string

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é semelhante à OperatorRole propriedade de um AWS::Lambda::NetworkConnector recurso. Isso é necessário no CloudFormation , mas não no AWS SAM. Se você não especificar uma função, AWS SAM cria uma com uma ID lógica de<resource-logical-id>OperatorRole.

PropagateTags

Especifica se as tags da Tags propriedade devem ser passadas para os recursos gerados, como a função de operador gerada automaticamente.

Tipo: booliano

Obrigatório: não

Padrão: False

CloudFormation compatibilidade: essa propriedade é exclusiva AWS SAM e não tem CloudFormation equivalente.

Tags

Um mapa de pares de valores-chave que especifica as tags adicionadas a esse conector de rede.

Tipo: mapa

Obrigatório: não

CloudFormation compatibilidade: essa propriedade é semelhante à Tags propriedade de um AWS::Lambda::NetworkConnector recurso. A Tags propriedade in AWS SAM consiste em pares de valores-chave (enquanto CloudFormation nessa propriedade consiste em uma lista de Tag objetos). Além disso, adiciona AWS SAM automaticamente uma lambda:createdBy:SAM tag a esse conector de rede e às funções padrão que são geradas para ele.

VpcConfig

A configuração de saída da VPC para o conector de rede. Especifica as sub-redes, os grupos de segurança e o protocolo de rede para rotear o tráfego de saída por meio de sua VPC.

Digite: VpcConfig

Obrigatório: Sim

CloudFormation compatibilidade: essa propriedade é transformada na Configuration.VpcEgressConfiguration propriedade de um AWS::Lambda::NetworkConnector recurso. AWS SAM conjuntos AssociatedComputeResourceTypes da ComputeTypespropriedade.

Valores de retorno

Ref.

Quando a ID lógica desse recurso é fornecida à função Ref intrínseca, ela retorna o ARN do conector de rede.

Para obter mais informações sobre como usar a função Ref, consulte Ref no Guia do usuário do AWS CloudFormation .

Fã:: GetAtt

Fn::GetAtt retorna um valor para um atributo especificado deste tipo. Estes são os atributos disponíveis e os valores de retorno de amostra.

Para obter mais informações sobre o uso do Fn::GetAtt, consulte Fn::GetAtt o AWS CloudFormation Guia do usuário.

Arn

O Amazon Resource Name (ARN) do conector de rede.

LatestVersionArn

O ARN qualificado para versão da versão mais recente do conector de rede, por exemplo. arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1 Use esse valor para a EgressNetworkConnectorArn propriedade de um AWS::Serverless:: WebFunction.

State

O estado atual do conector de rede. Os valores válidos são PENDING, ACTIVE, INACTIVE, FAILED, DELETING e DELETE_FAILED.

Exemplos

Conector de rede básico com função gerada automaticamente

O exemplo a seguir cria um conector de rede de saída VPC. AWS SAM gera automaticamente a função 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 rede para uma função Web

O exemplo a seguir cria um conector de rede para Funções Web e o usa para o tráfego de saída de uma Função 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