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
<a name="sam-resource-networkconnector"></a>

 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](sam-specification-generated-resources.md). 

## Sintaxe
<a name="sam-resource-networkconnector-syntax"></a>

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

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

```
Type: AWS::Serverless::NetworkConnector
Properties:
  [Name](#sam-networkconnector-name): {{String}}
  [OperatorRole](#sam-networkconnector-operatorrole): {{String}}
  [PropagateTags](#sam-networkconnector-propagatetags): {{Boolean}}
  [Tags](#sam-networkconnector-tags): {{Map}}
  [VpcConfig](#sam-networkconnector-vpcconfig): {{VpcConfig}}
```

## Propriedades
<a name="sam-resource-networkconnector-properties"></a>

 `Name`   <a name="sam-networkconnector-name"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` propriedade de um `AWS::Lambda::NetworkConnector` recurso. 

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-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`   <a name="sam-networkconnector-propagatetags"></a>
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`   <a name="sam-networkconnector-tags"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-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 name="sam-networkconnector-vpcconfig"></a>
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](sam-property-networkconnector-vpcconfig.md)  
*Obrigatório*: Sim  
*CloudFormation compatibilidade*: essa propriedade é transformada na `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` propriedade de um `AWS::Lambda::NetworkConnector` recurso. AWS SAM também injeta `AssociatedComputeResourceTypes: [MicroVm]` automaticamente. 

## Valores de retorno
<a name="sam-resource-networkconnector-return-values"></a>

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

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) no *Guia do usuário do AWS CloudFormation *.

### Fã:: GetAtt
<a name="sam-resource-networkconnector-return-values-fn--getatt"></a>

`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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) o *AWS CloudFormation Guia do usuário*.

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
O Amazon Resource Name (ARN) do conector de rede.

`State`  <a name="sam-networkconnector-getatt-state"></a>
O estado atual do conector de rede. Os valores válidos são `PENDING`, `ACTIVE`, `INACTIVE`, `FAILED`, `DELETING` e `DELETE_FAILED`.

## Exemplos
<a name="sam-resource-networkconnector-examples"></a>

### Conector de rede básico com função gerada automaticamente
<a name="sam-resource-networkconnector-example-basic"></a>

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
```