Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

 Membuat Konektor AWS Lambda Jaringan yang mendefinisikan konektivitas jaringan untuk sumber daya komputasi Lambda. Konektor jaringan menentukan bagaimana sumber daya komputasi terhubung ke jaringan — misalnya, merutekan lalu lintas keluar melalui VPC pelanggan menggunakan antarmuka jaringan elastis (ENI) yang disediakan layanan dalam subnet dan grup keamanan tertentu. 

**catatan**  
Ketika Anda menyebarkan ke AWS CloudFormation, AWS SAM mengubah AWS SAM sumber daya Anda menjadi CloudFormation sumber daya. Untuk informasi selengkapnya, lihat [Dihasilkan CloudFormation sumber daya untuk AWS SAM](sam-specification-generated-resources.md). 

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

Untuk mendeklarasikan entitas ini dalam template AWS Serverless Application Model (AWS SAM) Anda, gunakan sintaks berikut.

### 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}}
```

## Sifat-sifat
<a name="sam-resource-networkconnector-properties"></a>

 `Name`   <a name="sam-networkconnector-name"></a>
Nama konektor jaringan. Nama harus unik dalam akun dan Wilayah Anda.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` properti `AWS::Lambda::NetworkConnector` sumber daya. 

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
ARN dari peran IAM yang diasumsikan oleh layanan konektor jaringan untuk membuat dan mengelola antarmuka jaringan elastis (ENI).  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[OperatorRole](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-operatorrole)` properti `AWS::Lambda::NetworkConnector` sumber daya. Ini wajib diisi di CloudFormation tapi bukan di AWS SAM. Jika Anda tidak menentukan peran, AWS SAM buat peran dengan ID logis`{{<resource-logical-id>}}OperatorRole`. 

 `PropagateTags`   <a name="sam-networkconnector-propagatetags"></a>
Menentukan apakah akan meneruskan tag dari `Tags` properti ke sumber daya yang dihasilkan, seperti peran operator yang dibuat secara otomatis.  
*Tipe*: Boolean  
*Wajib*: Tidak  
*Default*: `False`  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `Tags`   <a name="sam-networkconnector-tags"></a>
Peta pasangan kunci-nilai yang menentukan tag yang ditambahkan ke konektor jaringan ini.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-tags)` properti `AWS::Lambda::NetworkConnector` sumber daya. `Tags`Properti di AWS SAM terdiri dari pasangan kunci-nilai (sedangkan dalam properti CloudFormation ini terdiri dari daftar `Tag` objek). Juga, AWS SAM secara otomatis menambahkan `lambda:createdBy:SAM` tag ke konektor jaringan ini, dan ke peran default yang dihasilkan untuk itu. 

 `VpcConfig`   <a name="sam-networkconnector-vpcconfig"></a>
Konfigurasi jalan keluar VPC untuk konektor jaringan. Menentukan subnet, grup keamanan, dan protokol jaringan untuk merutekan lalu lintas keluar melalui VPC Anda.  
*Jenis*: [VpcConfig](sam-property-networkconnector-vpcconfig.md)  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diubah menjadi `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` properti `AWS::Lambda::NetworkConnector` sumber daya. AWS SAM juga menyuntikkan `AssociatedComputeResourceTypes: [MicroVm]` secara otomatis. 

## Nilai Pengembalian
<a name="sam-resource-networkconnector-return-values"></a>

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

Ketika ID logis dari sumber daya ini disediakan untuk fungsi `Ref` intrinsik, ia mengembalikan ARN dari konektor jaringan.

Untuk informasi lebih lanjut tentang menggunakan fungsi `Ref`, lihat [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) di *Panduan Pengguna AWS CloudFormation *.

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

`Fn::GetAtt` mengembalikan nilai untuk atribut yang ditentukan dari jenis ini. Berikut ini adalah atribut yang tersedia dan nilai-nilai kembali sampel.

Untuk informasi lebih lanjut tentang `Fn::GetAtt`, lihat [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) di *Panduan Pengguna AWS CloudFormation *

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
Nama Sumber Daya Amazon (ARN) dari konektor jaringan.

`State`  <a name="sam-networkconnector-getatt-state"></a>
Keadaan konektor jaringan saat ini. Nilai yang valid adalah`PENDING`,`ACTIVE`,`INACTIVE`,`FAILED`,`DELETING`, dan`DELETE_FAILED`.

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

### Konektor jaringan dasar dengan peran yang dihasilkan secara otomatis
<a name="sam-resource-networkconnector-example-basic"></a>

Contoh berikut membuat konektor jaringan keluar VPC. AWS SAM secara otomatis menghasilkan peran operator.

```
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
```