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, indem beispielsweise ausgehender Datenverkehr mithilfe von Elastic Network Interfaces (ENIs), die der Dienst in bestimmten Subnetzen und Sicherheitsgruppen bereitstellt, über eine Kunden-VPC geleitet wird. Jeder Connector dient einem Compute-Typ, entweder MicroVMS oder Webfunktionen. Um einen Konnektor mit einem AWS::Serverless:: zu verwendenWebFunction, setzen Sie ihn ComputeTypes auf WebFunction und übergeben Sie den Konnektor LatestVersionArn an die Eigenschaft der EgressNetworkConnectorArn Funktion.
Bei der Bereitstellung auf AWS CloudFormation werden Ihre AWS SAM Ressourcen in AWS SAM CloudFormation Ressourcen umgewandelt. 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: ComputeTypes:ListName:StringOperatorRole:StringPropagateTags:BooleanTags:MapVpcConfig:VpcConfig
Eigenschaften
-
ComputeTypes -
Der Typ der Lambda-Rechenressource, die diesen Netzwerkconnector verwenden kann. Geben Sie genau einen der folgenden Werte an:
-
MicroVm: Der Connector wird von MicroVM-Rechenressourcen verwendet. -
WebFunction: Der Konnektor wird von AWS::Serverless:: WebFunction Ressourcen über ihreEgressNetworkConnectorArnEigenschaften verwendet.
Typ: Liste
Required: No
Standardwert:
[MicroVm]CloudFormation Kompatibilität: Diese Eigenschaft wird direkt an die
Configuration.VpcEgressConfiguration.AssociatedComputeResourceTypesEigenschaft einerAWS::Lambda::NetworkConnectorRessource übergeben. -
-
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
NameEigenschaft einerAWS::Lambda::NetworkConnectorRessource ü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
OperatorRoleEigenschaft einerAWS::Lambda::NetworkConnectorRessource. 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 -
Gibt an, ob Tags von der
TagsEigenschaft an generierte Ressourcen übergeben werden sollen, z. B. an die automatisch generierte Operatorrolle.Typ: Boolesch
Required: No
Standardwert:
FalseCloudFormation Kompatibilität: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.
-
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
TagsEigenschaft einerAWS::Lambda::NetworkConnectorRessource. DieTagsEigenschaft in AWS SAM besteht aus Schlüssel-Wert-Paaren (wohingegen CloudFormation diese Eigenschaft aus einer Liste vonTagObjekten besteht). Fügt diesem Netzwerkconnector und den Standardrollen, die für ihn generiert wurden, außerdem AWS SAM automatisch einlambda:createdBy:SAMTag 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.VpcEgressConfigurationEigenschaft einer Ressource umgewandelt.AWS::Lambda::NetworkConnectorAWS SAM SätzeAssociatedComputeResourceTypesaus der ComputeTypesEigenschaft.
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.
LatestVersionArn-
Zum Beispiel der versionsqualifizierte ARN der neuesten Version des Netzwerkkonnektors.
arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1Verwenden Sie diesen Wert für dieEgressNetworkConnectorArnEigenschaft eines AWS::Serverless::. WebFunction State-
Der aktuelle Status des Netzwerkanschlusses. 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
Netzwerkanschluss für eine Webfunktion
Im folgenden Beispiel wird ein Netzwerkconnector für Web Functions erstellt und für den ausgehenden Datenverkehr einer Web-Funktion verwendet.
AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Resources: MyWebFunctionConnector: Type: AWS::Serverless::NetworkConnector Properties: ComputeTypes: - WebFunction VpcConfig: SubnetIds: - subnet-0abc123def4567890 SecurityGroupIds: - sg-0abc1234abcde0001 NetworkProtocol: IPv4 MyWebFunction: Type: AWS::Serverless::WebFunction Properties: Runtime: nodejs24.x AuthType: IamAuth CodeUri: s3://amzn-s3-demo-bucket/webfn.zip EgressNetworkConnectorArn: !GetAtt MyWebFunctionConnector.LatestVersionArn