View a markdown version of this page

AWS::Serverless::NetworkConnector - AWS Serverless Application Model
SintaksisSifat-sifatNilai PengembalianContoh

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

AWS::Serverless::NetworkConnector

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.

Sintaksis

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

YAML

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

Sifat-sifat

Name

Nama konektor jaringan. Nama harus unik dalam akun dan Wilayah Anda.

Tipe: String

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini diteruskan langsung ke Name properti AWS::Lambda::NetworkConnector sumber daya.

OperatorRole

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

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

Peta pasangan kunci-nilai yang menentukan tag yang ditambahkan ke konektor jaringan ini.

Tipe: Peta

Wajib: Tidak

CloudFormation kompatibilitas: Properti ini mirip dengan Tags properti AWS::Lambda::NetworkConnector sumber daya. TagsProperti 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

Konfigurasi jalan keluar VPC untuk konektor jaringan. Menentukan subnet, grup keamanan, dan protokol jaringan untuk merutekan lalu lintas keluar melalui VPC Anda.

Jenis: VpcConfig

Wajib: Ya

CloudFormation kompatibilitas: Properti ini diubah menjadi Configuration.VpcEgressConfiguration properti AWS::Lambda::NetworkConnector sumber daya. AWS SAM juga menyuntikkan AssociatedComputeResourceTypes: [MicroVm] secara otomatis.

Nilai Pengembalian

Ref

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 Ref di Panduan Pengguna AWS CloudFormation .

Fn:: GetAtt

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 Fn::GetAtt di Panduan Pengguna AWS CloudFormation

Arn

Nama Sumber Daya Amazon (ARN) dari konektor jaringan.

State

Keadaan konektor jaringan saat ini. Nilai yang valid adalahPENDING,ACTIVE,INACTIVE,FAILED,DELETING, danDELETE_FAILED.

Contoh

Konektor jaringan dasar dengan peran yang dihasilkan secara otomatis

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