Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 Erstellt einen AWS Lambda Network Connector, der die Netzwerkkonnektivität für Lambda-Rechenressourcen definiert. Ein Netzwerkconnector gibt an, wie Rechenressourcen mit Netzwerken verbunden werden. Beispielsweise wird ausgehender Datenverkehr über eine Kunden-VPC mithilfe von Elastic Network Interfaces (ENIs) weitergeleitet, die der Dienst in bestimmten Subnetzen und Sicherheitsgruppen bereitstellt. 

**Anmerkung**  
Bei der Bereitstellung werden Ihre Ressourcen AWS CloudFormation in AWS SAM Ressourcen umgewandelt. AWS SAM CloudFormation Weitere Informationen finden Sie unter [Generiert CloudFormation Ressourcen für AWS SAM](sam-specification-generated-resources.md). 

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

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

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

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

 `Name`   <a name="sam-networkconnector-name"></a>
Der Name des Netzwerk-Connectors. Der Name muss innerhalb Ihres Kontos und Ihrer Region eindeutig sein.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird direkt an die `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` Eigenschaft einer `AWS::Lambda::NetworkConnector` Ressource übergeben. 

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
Der ARN der IAM-Rolle, die der Network Connector-Service für die Erstellung und Verwaltung von Elastic Network Interfaces (ENIs) annimmt.  
*Typ:* Zeichenfolge  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[OperatorRole](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-operatorrole)` Eigenschaft einer `AWS::Lambda::NetworkConnector` Ressource. Dies ist in erforderlich CloudFormation , aber nicht in AWS SAM. Wenn Sie keine Rolle angeben, AWS SAM erstellt eine Rolle mit der logischen ID`{{<resource-logical-id>}}OperatorRole`. 

 `PropagateTags`   <a name="sam-networkconnector-propagatetags"></a>
Gibt an, ob Tags von der `Tags` Eigenschaft an generierte Ressourcen übergeben werden sollen, z. B. an die automatisch generierte Operatorrolle.  
*Typ*: Boolesch  
*Required*: No  
*Standardwert*: `False`  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Tags`   <a name="sam-networkconnector-tags"></a>
Eine Zuordnung von Schlüssel-Wert-Paaren, die die Tags angibt, die diesem Netzwerkconnector hinzugefügt wurden.  
*Typ: Karte*  
*Required*: No  
*CloudFormation Kompatibilität*: Diese Eigenschaft ähnelt der `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-tags)` Eigenschaft einer `AWS::Lambda::NetworkConnector` Ressource. Die `Tags` Eigenschaft in AWS SAM besteht aus Schlüssel-Wert-Paaren (wohingegen CloudFormation diese Eigenschaft aus einer Liste von `Tag` Objekten besteht). Fügt diesem Netzwerkconnector und den Standardrollen, die für ihn generiert wurden, außerdem AWS SAM automatisch ein `lambda:createdBy:SAM` Tag hinzu. 

 `VpcConfig`   <a name="sam-networkconnector-vpcconfig"></a>
Die VPC-Ausgangskonfiguration für den Netzwerkconnector. Gibt die Subnetze, Sicherheitsgruppen und das Netzwerkprotokoll für das Routing von ausgehendem Datenverkehr über Ihre VPC an.  
*Typ:* [VpcConfig](sam-property-networkconnector-vpcconfig.md)  
*Erforderlich*: Ja  
*CloudFormation Kompatibilität*: Diese Eigenschaft wird in die `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` Eigenschaft einer Ressource umgewandelt. `AWS::Lambda::NetworkConnector` AWS SAM injiziert auch `AssociatedComputeResourceTypes: [MicroVm]` automatisch. 

## Rückgabewerte
<a name="sam-resource-networkconnector-return-values"></a>

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

Wenn die logische ID dieser Ressource für die `Ref` intrinsische Funktion bereitgestellt wird, gibt sie den ARN des Netzwerkkonnektors zurück.

Weitere Informationen zur Verwendung der `Ref` Funktion finden Sie [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)im *AWS CloudFormation Benutzerhandbuch*.

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

`Fn::GetAtt` gibt einen Wert für ein angegebenes Attribut dieses Typs zurück. Im Folgenden sehen Sie die verfügbaren Attribute und Beispielrückgabewerte.

Weitere Informationen zur Verwendung `Fn::GetAtt` finden Sie [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)im *AWS CloudFormation Benutzerhandbuch*.

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
Der Amazon-Ressourcenname (ARN) des Netzwerkkonnektors.

`State`  <a name="sam-networkconnector-getatt-state"></a>
Der aktuelle Status des Netzwerkkonnektors. Gültige Werte sind `PENDING``ACTIVE`,`INACTIVE`,`FAILED`,`DELETING`, und`DELETE_FAILED`.

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

### Einfacher Netzwerkkonnektor mit automatisch generierter Rolle
<a name="sam-resource-networkconnector-example-basic"></a>

Im folgenden Beispiel wird ein VPC-Ausgangsnetzwerkconnector erstellt. AWS SAM generiert automatisch die Operatorrolle.

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