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 específicos.

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:
  Name: String
  OperatorRole: String
  PropagateTags: Boolean
  Tags: Map
  VpcConfig: VpcConfig

Propriedades

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 também injeta AssociatedComputeResourceTypes: [MicroVm] automaticamente.

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.

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