View a markdown version of this page

AWS::Serverless::NetworkConnector - Amazon Serverless Application Model
语法Properties返回值示例
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS::Serverless::NetworkConnector

创建 Amazon Lambda 网络连接器，用于定义 Lambda 计算资源的网络连接。网络连接器指定计算资源如何连接到网络，例如，使用服务在指定子网和安全组中配置的弹性网络接口 (ENI) 通过客户 VPC 路由出口流量。每个连接器都提供一种计算类型，可以是 microVMS 或 Web Functions。要使用带有AWS::Serverless:: 的连接器WebFunction，请将连接器设置ComputeTypes为WebFunction并将连接器的属性传递LatestVersionArn给函数的EgressNetworkConnectorArn属性。

注意

部署到时 Amazon CloudFormation， Amazon SAM 会将您的 Amazon SAM 资源转换为 Amazon CloudFormation 资源。有关更多信息，请参阅 生成 Amazon CloudFormation 的资源 Amazon SAM。

语法

要在 Amazon Serverless Application Model (Amazon SAM) 模板中声明此实体，请使用以下语法。

YAML

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

Properties

ComputeTypes

可以使用此网络连接器的 Lambda 计算资源类型。请精确指定以下值之一：

  • MicroVm：连接器由 microVM 计算资源使用。

  • WebFunction:: 连接器由AWS::Serverless:: WebFunction 资源通过其EgressNetworkConnectorArn属性使用。

类型：列表

必需：否

默认值：[MicroVm]

Amazon CloudFormation 兼容性：此属性直接传递给AWS::Lambda::NetworkConnector资源的Configuration.VpcEgressConfiguration.AssociatedComputeResourceTypes属性。

Name

网络连接器的名称。该名称在您的账户和地区内必须是唯一的。

类型：字符串

必需：否

Amazon CloudFormation 兼容性：此属性直接传递给AWS::Lambda::NetworkConnector资源的Name属性。

OperatorRole

网络连接器服务承担的用于创建和管理弹性网络接口 (ENI) 的 IAM 角色的 ARN。

类型：字符串

必需：否

Amazon CloudFormation 兼容性：此属性类似于AWS::Lambda::NetworkConnector资源的OperatorRole属性。这在 Amazon CloudFormation 中为必需，但在 Amazon SAM中并非必需。如果您未指定角色，则 Amazon SAM 创建一个逻辑 ID 为的角色<resource-logical-id>OperatorRole。

PropagateTags

指定是否将Tags属性中的标签传递给生成的资源，例如自动生成的操作员角色。

类型：布尔值

必需：否

默认值：False

Amazon CloudFormation 兼容性：此属性是独有的 Amazon SAM ，没有 Amazon CloudFormation 等效属性。

Tags

键值对映射，用于指定添加到此网络连接器的标签。

类型：映射

必需：否

Amazon CloudFormation 兼容性：此属性类似于AWS::Lambda::NetworkConnector资源的Tags属性。中的Tags属性由键值对 Amazon SAM 组成（而 Amazon CloudFormation 在此属性中则由Tag对象列表组成）。此外，还 Amazon SAM 会自动向该网络连接器以及为其生成的默认角色添加lambda:createdBy:SAM标签。

VpcConfig

网络连接器的 VPC 出口配置。指定用于通过您的 VPC 路由出站流量的子网、安全组和网络协议。

类型：VpcConfig

是否必需：是

Amazon CloudFormation 兼容性：此Configuration.VpcEgressConfiguration属性被转换为AWS::Lambda::NetworkConnector资源的属性。 Amazon SAM AssociatedComputeResourceTypes从ComputeTypes属性中设置。

返回值

Ref

当向Ref内部函数提供此资源的逻辑 ID 时，它将返回网络连接器的 ARN。

有关使用 Ref 函数的更多信息，请参阅《Amazon CloudFormation 用户指南》中的 Ref。

Fn:: GetAtt

Fn::GetAtt 返回一个此类型指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 的更多信息，请参阅《Amazon CloudFormation 用户指南》中的 Fn::GetAtt。

Arn

网络连接器的亚马逊资源名称 (ARN)。

LatestVersionArn

例如，最新版本的网络连接器的版本限定 ARN。arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1使用此值作为AWS::Serverless:: 的EgressNetworkConnectorArn属性WebFunction。

State

网络连接器的当前状态。有效值为 PENDING、ACTIVE、INACTIVE、FAILED、DELETING 和 DELETE_FAILED。

示例

具有自动生成角色的基本网络连接器

以下示例创建一个 VPC 出口网络连接器。 Amazon SAM 自动生成操作员角色。

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

Web 功能的网络连接器

以下示例为 Web Functions 创建了一个网络连接器，并将其用于 Web 函数的出站流量。

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