View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
语法Properties返回值示例

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

AWS::Serverless::NetworkConnector

创建 AWS Lambda 网络连接器，用于定义 Lambda 计算资源的网络连接。网络连接器指定计算资源如何连接到网络，例如，使用服务在指定子网和安全组中配置的弹性网络接口 (ENI) 通过客户 VPC 路由出口流量。

注意

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

语法

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

YAML

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

Properties

Name

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

类型：字符串

必需：否

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

OperatorRole

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

类型：字符串

必需：否

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

PropagateTags

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

类型：布尔值

必需：否

默认值：False

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

Tags

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

类型：映射

必需：否

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

VpcConfig

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

类型：VpcConfig

是否必需：是

CloudFormation 兼容性：此Configuration.VpcEgressConfiguration属性被转换为AWS::Lambda::NetworkConnector资源的属性。 AWS SAM 也会AssociatedComputeResourceTypes: [MicroVm]自动注入。

返回值

Ref

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

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

Fn:: GetAtt

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

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

Arn

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

State

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

示例

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

以下示例创建一个 VPC 出口网络连接器。 AWS 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