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

# AWS::Serverless::NetworkConnector
<a name="sam-resource-networkconnector"></a>

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

**참고**  
에 배포하면가 AWS SAM 리소스를 리소스로 AWS CloudFormation AWS SAM CloudFormation 변환합니다. 자세한 내용은 [에 대해 생성된 CloudFormation 리소스 AWS SAM](sam-specification-generated-resources.md) 단원을 참조하십시오.

## 구문
<a name="sam-resource-networkconnector-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-resource-networkconnector-syntax.yaml"></a>

```
Type: AWS::Serverless::NetworkConnector
Properties:
  [Name](#sam-networkconnector-name): {{String}}
  [OperatorRole](#sam-networkconnector-operatorrole): {{String}}
  [PropagateTags](#sam-networkconnector-propagatetags): {{Boolean}}
  [Tags](#sam-networkconnector-tags): {{Map}}
  [VpcConfig](#sam-networkconnector-vpcconfig): {{VpcConfig}}
```

## 속성
<a name="sam-resource-networkconnector-properties"></a>

 `Name`   <a name="sam-networkconnector-name"></a>
네트워크 커넥터의 이름입니다. 이름은 계정 및 리전 내에서 고유해야 합니다.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::Lambda::NetworkConnector` 리소스의 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` 속성으로 직접 전달됩니다.

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
네트워크 커넥터 서비스가 탄력적 네트워크 인터페이스(ENIs.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::Lambda::NetworkConnector` 리소스의 `[OperatorRole](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-operatorrole)` 속성과 유사합니다. 이는 CloudFormation 내부에서 필요하지만 AWS SAM내부에서는 필요하지 않습니다. 역할을 지정하지 않으면는 논리적 ID가 인 역할을 AWS SAM 생성합니다`{{<resource-logical-id>}}OperatorRole`.

 `PropagateTags`   <a name="sam-networkconnector-propagatetags"></a>
`Tags` 속성에서 자동 생성된 연산자 역할과 같이 생성된 리소스로 태그를 전달할지 여부를 지정합니다.  
*유형*: 부울  
*필수 항목 여부*: 아니요  
*기본값*: `False`  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

 `Tags`   <a name="sam-networkconnector-tags"></a>
이 네트워크 커넥터에 추가된 태그를 지정하는 키-값 페어의 맵입니다.  
*유형*: 맵  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::Lambda::NetworkConnector` 리소스의 `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-tags)` 속성과 유사합니다. 의 `Tags` 속성은 키-값 페어로 AWS SAM 구성됩니다(이 CloudFormation 속성은 `Tag` 객체 목록으로 구성됨). 또한는이 네트워크 커넥터와 해당 커넥터에 대해 생성된 기본 역할에 `lambda:createdBy:SAM` 태그를 AWS SAM 자동으로 추가합니다.

 `VpcConfig`   <a name="sam-networkconnector-vpcconfig"></a>
네트워크 커넥터에 대한 VPC 송신 구성입니다. VPC를 통해 아웃바운드 트래픽을 라우팅하기 위한 서브넷, 보안 그룹 및 네트워크 프로토콜을 지정합니다.  
*유형*: [VpcConfig](sam-property-networkconnector-vpcconfig.md)  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::Lambda::NetworkConnector` 리소스의 `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` 속성으로 변환됩니다. AWS SAM 또한 `AssociatedComputeResourceTypes: [MicroVm]` 자동으로 주입됩니다.

## 반환 값
<a name="sam-resource-networkconnector-return-values"></a>

### Ref
<a name="sam-resource-networkconnector-return-values-ref"></a>

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

`Ref` 함수의 사용에 대한 자세한 내용은 *AWS CloudFormation 사용자 가이드*의 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) 섹션을 참조하세요.

### Fn::GetAtt
<a name="sam-resource-networkconnector-return-values-fn--getatt"></a>

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

`Fn::GetAtt`의 사용에 대한 자세한 내용은 *AWS CloudFormation 사용자 가이드*의 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) 섹션을 참조하세요.

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
네트워크 커넥터의 Amazon 리소스 이름(ARN)입니다.

`State`  <a name="sam-networkconnector-getatt-state"></a>
네트워크 커넥터의 현재 상태입니다. 유효한 값은 `PENDING`, `ACTIVE`, `INACTIVE`, `FAILED`, `DELETING` 및 `DELETE_FAILED`입니다.

## 예제
<a name="sam-resource-networkconnector-examples"></a>

### 자동 생성된 역할이 있는 기본 네트워크 커넥터
<a name="sam-resource-networkconnector-example-basic"></a>

다음 예제에서는 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
```