翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

 Lambda コンピューティングリソースのネットワーク接続を定義する AWS Lambda Network Connector を作成します。ネットワークコネクタは、コンピューティングリソースがネットワークに接続する方法を指定します。たとえば、サービスが指定されたサブネットとセキュリティグループでプロビジョニングする Elastic Network Interface (ENIs) を使用して、お客様の VPC 経由で送信トラフィックをルーティングします。

**注記**  
にデプロイすると AWS CloudFormation、 は AWS SAM リソースを CloudFormation リソース AWS SAM に変換します。詳細については、「[の生成済み 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>
Elastic Network Interface (ENIs) を作成および管理するためにネットワークコネクタサービスが引き受ける IAM ロールの ARN。  
*タイプ*: 文字列  
*必須:* いいえ  
*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>

### 参照番号
<a name="sam-resource-networkconnector-return-values-ref"></a>

このリソースの論理 ID が`Ref`組み込み関数に提供されると、ネットワークコネクタの ARN が返されます。

`Ref` 関数の使用方法の詳細については、「AWS CloudFormation ユーザーガイド」の「[`Ref`](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 ユーザーガイド」の「[`Fn::GetAtt`](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
```