Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS::Serverless::NetworkConnector
<a name="sam-resource-networkconnector"></a>

 Crea un connettore AWS Lambda di rete che definisce la connettività di rete per le risorse di elaborazione Lambda. Un connettore di rete specifica in che modo le risorse di elaborazione si connettono alle reti, ad esempio instradando il traffico in uscita attraverso un VPC del cliente utilizzando interfacce di rete elastiche (ENI) fornite dal servizio in sottoreti e gruppi di sicurezza specifici. 

**Nota**  
Quando esegui la distribuzione su, trasforma le tue risorse in risorse. AWS CloudFormation AWS SAM AWS SAM CloudFormation Per ulteriori informazioni, consulta [Generato CloudFormation risorse per AWS SAM](sam-specification-generated-resources.md). 

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

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

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

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

 `Name`   <a name="sam-networkconnector-name"></a>
Il nome del connettore di rete. Il nome deve essere univoco all'interno del tuo account e della tua regione.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` proprietà di una `AWS::Lambda::NetworkConnector` risorsa. 

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
L'ARN del ruolo IAM che il servizio di connessione di rete assume per creare e gestire interfacce di rete elastiche (ENI).  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[OperatorRole](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-operatorrole)` proprietà di una risorsa. `AWS::Lambda::NetworkConnector` È obbligatorio in CloudFormation ma non in AWS SAM. Se non specifichi un ruolo, ne AWS SAM crea uno con un ID logico di`{{<resource-logical-id>}}OperatorRole`. 

 `PropagateTags`   <a name="sam-networkconnector-propagatetags"></a>
Speciifica se passare i tag dalla `Tags` proprietà alle risorse generate, ad esempio il ruolo dell'operatore generato automaticamente.  
*Tipo*: Booleano  
*Obbligatorio:* no  
*Default*: `False`  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Tags`   <a name="sam-networkconnector-tags"></a>
Una mappa di coppie chiave-valore che specifica i tag aggiunti a questo connettore di rete.  
*Tipo: Mappa*  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è simile alla `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-tags)` proprietà di una `AWS::Lambda::NetworkConnector` risorsa. La `Tags` proprietà in AWS SAM è costituita da coppie chiave-valore (mentre in CloudFormation questa proprietà è costituita da un elenco di `Tag` oggetti). Inoltre, aggiunge AWS SAM automaticamente un `lambda:createdBy:SAM` tag a questo connettore di rete e ai ruoli predefiniti generati per esso. 

 `VpcConfig`   <a name="sam-networkconnector-vpcconfig"></a>
La configurazione di uscita VPC per il connettore di rete. Speciifica le sottoreti, i gruppi di sicurezza e il protocollo di rete per l'instradamento del traffico in uscita attraverso il VPC.  
*Tipo:* [VpcConfig](sam-property-networkconnector-vpcconfig.md)  
*Obbligatorio:* sì  
*CloudFormation compatibilità*: questa proprietà viene trasformata nella proprietà di una risorsa. `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` `AWS::Lambda::NetworkConnector` AWS SAM inoltre si inietta `AssociatedComputeResourceTypes: [MicroVm]` automaticamente. 

## Valori restituiti
<a name="sam-resource-networkconnector-return-values"></a>

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

Quando l'ID logico di questa risorsa viene fornito alla funzione `Ref` intrinseca, restituisce l'ARN del connettore di rete.

*Per ulteriori informazioni sull'uso della `Ref` funzione, [`Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)consultate la Guida per l'AWS CloudFormation utente.*

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

`Fn::GetAtt` restituisce un valore per un attributo specificato di questo tipo. Di seguito sono riportati gli attributi disponibili e i valori restituiti di esempio.

Per ulteriori informazioni sull'utilizzo`Fn::GetAtt`, consulta [`Fn::GetAtt`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)la *Guida per l'AWS CloudFormation utente*.

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
L'Amazon Resource Name (ARN) del connettore di rete.

`State`  <a name="sam-networkconnector-getatt-state"></a>
Lo stato attuale del connettore di rete. I valori validi sono `PENDING``ACTIVE`,`INACTIVE`,`FAILED`,`DELETING`, e`DELETE_FAILED`.

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

### Connettore di rete di base con ruolo generato automaticamente
<a name="sam-resource-networkconnector-example-basic"></a>

L'esempio seguente crea un connettore di rete in uscita VPC. AWS SAM genera automaticamente il ruolo dell'operatore.

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