View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
구문속성반환 값예제

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS::Serverless::NetworkConnector

Lambda 컴퓨팅 리소스에 대한 AWS Lambda 네트워크 연결을 정의하는 네트워크 커넥터를 생성합니다. 네트워크 커넥터는 컴퓨팅 리소스가 네트워크에 연결하는 방법을 지정합니다. 예를 들어 서비스가 지정된 서브넷 및 보안 그룹에 프로비저닝하는 탄력적 네트워크 인터페이스(ENIs)를 사용하여 고객 VPC를 통해 송신 트래픽을 라우팅합니다.

참고

에 배포하면가 AWS SAM 리소스를 리소스로 AWS CloudFormation 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

속성

Name

네트워크 커넥터의 이름입니다. 이름은 계정 및 리전 내에서 고유해야 합니다.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::NetworkConnector 리소스의 Name 속성으로 직접 전달됩니다.

OperatorRole

네트워크 커넥터 서비스가 탄력적 네트워크 인터페이스(ENIs.

유형: 문자열

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::NetworkConnector 리소스의 OperatorRole 속성과 유사합니다. 이는 CloudFormation 내부에서 필요하지만 AWS SAM내부에서는 필요하지 않습니다. 역할을 지정하지 않으면는 논리적 ID가 인 역할을 AWS SAM 생성합니다<resource-logical-id>OperatorRole.

PropagateTags

Tags 속성에서 자동 생성된 연산자 역할과 같이 생성된 리소스로 태그를 전달할지 여부를 지정합니다.

유형: 부울

필수 항목 여부: 아니요

기본값: False

CloudFormation 호환성:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

Tags

이 네트워크 커넥터에 추가된 태그를 지정하는 키-값 페어의 맵입니다.

유형: 맵

필수 항목 여부: 아니요

CloudFormation 호환성:이 속성은 AWS::Lambda::NetworkConnector 리소스의 Tags 속성과 유사합니다. 의 Tags 속성은 키-값 페어로 AWS SAM 구성됩니다(이 CloudFormation 속성은 Tag 객체 목록으로 구성됨). 또한는이 네트워크 커넥터와 해당 커넥터에 대해 생성된 기본 역할에 lambda:createdBy:SAM 태그를 AWS SAM 자동으로 추가합니다.

VpcConfig

네트워크 커넥터에 대한 VPC 송신 구성입니다. VPC를 통해 아웃바운드 트래픽을 라우팅하기 위한 서브넷, 보안 그룹 및 네트워크 프로토콜을 지정합니다.

유형: VpcConfig

필수 항목 여부: 예

CloudFormation 호환성:이 속성은 AWS::Lambda::NetworkConnector 리소스의 Configuration.VpcEgressConfiguration 속성으로 변환됩니다. AWS SAM 또한 AssociatedComputeResourceTypes: [MicroVm] 자동으로 주입됩니다.

반환 값

Ref

이 리소스의 논리적 ID가 Ref 내장 함수에 제공되면 네트워크 커넥터의 ARN을 반환합니다.

Ref 함수의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Ref 섹션을 참조하세요.

Fn::GetAtt

Fn::GetAtt은 이 유형의 지정된 속성에 대한 값을 반환합니다. 다음은 사용 가능한 속성과 반환되는 샘플 값.

Fn::GetAtt의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Fn::GetAtt 섹션을 참조하세요.

Arn

네트워크 커넥터의 Amazon 리소스 이름(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