View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
SyntaxEigenschaftenRückgabewerteBeispiele

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

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.

Syntax

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

YAML

Type: AWS::Serverless::NetworkConnector
Properties:
  Name: String
  OperatorRole: String
  PropagateTags: Boolean
  Tags: Map
  VpcConfig: VpcConfig

Eigenschaften

Name

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 Eigenschaft einer AWS::Lambda::NetworkConnector Ressource übergeben.

OperatorRole

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

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

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

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

Erforderlich: Ja

CloudFormation Kompatibilität: Diese Eigenschaft wird in die Configuration.VpcEgressConfiguration Eigenschaft einer Ressource umgewandelt. AWS::Lambda::NetworkConnector AWS SAM injiziert auch AssociatedComputeResourceTypes: [MicroVm] automatisch.

Rückgabewerte

Punkt

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 Refim AWS CloudFormation Benutzerhandbuch.

Fn:: GetAtt

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 Fn::GetAttim AWS CloudFormation Benutzerhandbuch.

Arn

Der Amazon-Ressourcenname (ARN) des Netzwerkkonnektors.

State

Der aktuelle Status des Netzwerkkonnektors. Gültige Werte sind PENDINGACTIVE,INACTIVE,FAILED,DELETING, undDELETE_FAILED.

Beispiele

Einfacher Netzwerkkonnektor mit automatisch generierter Rolle

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