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

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

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

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

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

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

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

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-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`   <a name="sam-networkconnector-propagatetags"></a>
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`   <a name="sam-networkconnector-tags"></a>
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](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-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`   <a name="sam-networkconnector-vpcconfig"></a>
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](sam-property-networkconnector-vpcconfig.md)  
*Obligatorio*: sí  
*CloudFormation compatibilidad*: esta propiedad se transforma en la `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` propiedad de un recurso. `AWS::Lambda::NetworkConnector` AWS SAM también se inyecta `AssociatedComputeResourceTypes: [MicroVm]` automáticamente. 

## valores devueltos
<a name="sam-resource-networkconnector-return-values"></a>

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

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`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) en la *Guía del usuario de AWS CloudFormation *.

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

`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`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) en la *Guía del usuario de AWS CloudFormation *.

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
El nombre de recurso de Amazon (ARN) del conector de red.

`State`  <a name="sam-networkconnector-getatt-state"></a>
El estado actual del conector de red. Los valores válidos son `PENDING`, `ACTIVE`, `INACTIVE`, `FAILED`, `DELETING` y `DELETE_FAILED`.

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

### Conector de red básico con función generada automáticamente
<a name="sam-resource-networkconnector-example-basic"></a>

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