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

# AWS::Serverless::WebFunction
<a name="sam-resource-webfunction"></a>

 Membuat Fungsi AWS Lambda Web, yang melayani permintaan HTTP melalui endpoint terkelola. Tidak seperti Fungsi Peristiwa Lambda, yang berjalan sebagai respons terhadap pemanggilan dan peristiwa, Fungsi Web menjalankan server web Anda dan menerima permintaan HTTP secara langsung. Dari satu`AWS::Serverless::WebFunction`, AWS SAM menghasilkan Fungsi Web, revisi yang tidak dapat diubah yang berisi kode dan konfigurasi Anda, dan titik akhir yang mengarahkan lalu lintas ke satu atau beberapa revisi. 

**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). 

**penting**  
Kode fungsi Anda harus menjalankan server HTTP yang mendengarkan pada host dan port dalam variabel `AWS_LAMBDA_HTTP_ENDPOINT` lingkungan. Runtime tidak diatur`PORT`. Secara default, runtime berjalan `index.js` di root paket deployment. Gunakan [EntryPoint](#sam-webfunction-entrypoint)untuk menjalankan file yang berbeda.

**penting**  
Bucket Amazon S3 yang menyimpan paket penerapan Anda harus memenuhi persyaratan berikut:  
Pembuatan versi diaktifkan.
Kebijakan bucket memberikan izin `lambda.amazonaws.com` `s3:GetObject` dan `s3:GetObjectVersion` izin. Kami menyarankan Anda untuk membuat cakupan kebijakan dengan `ArnLike` kondisi `aws:SourceArn` yang cocok dengan revisi fungsi, misalnya`arn:aws:lambda:{{us-east-1}}:{{111122223333}}:web-function/{{my-function}}/revision/*`.
Jika objek dienkripsi SSE-KMS, ia menggunakan kunci terkelola pelanggan yang kebijakan kuncinya memungkinkan `lambda.amazonaws.com` untuk menelepon. `kms:Decrypt` Kunci AWS terkelola untuk Amazon S3 (`aws/s3`) tidak didukung, karena Anda tidak dapat mengubah kebijakan utamanya.
Untuk contoh kebijakan bucket, lihat [Kebijakan Bucket untuk Lambda di Panduan AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/web-functions-code-s3.html#web-functions-code-s3-bucket-policy) *Pengembang*.  
`CodeUri`harus mereferensikan objek di Amazon S3. `sam package`Perintah `sam build` and tidak mendukung jalur lokal untuk sumber daya ini.

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

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

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

```
Type: AWS::Serverless::WebFunction
Properties:
  [AuthType](#sam-webfunction-authtype): {{String}}
  [AutoDeploymentMode](#sam-webfunction-autodeploymentmode): {{String}}
  [CodeUri](#sam-webfunction-codeuri): {{String | CodeUri}}
  [EgressNetworkConnectorArn](#sam-webfunction-egressnetworkconnectorarn): {{String}}
  [EndpointDescription](#sam-webfunction-endpointdescription): {{String}}
  [EndpointName](#sam-webfunction-endpointname): {{String}}
  [EndpointType](#sam-webfunction-endpointtype): {{String}}
  [EntryPoint](#sam-webfunction-entrypoint): {{String}}
  [EnvironmentVariables](#sam-webfunction-environmentvariables): {{Map}}
  [ExecutionRoleArn](#sam-webfunction-executionrolearn): {{String}}
  [FunctionName](#sam-webfunction-functionname): {{String}}
  [InlineCode](#sam-webfunction-inlinecode): {{String}}
  [KmsKeyArn](#sam-webfunction-kmskeyarn): {{String}}
  [LoggingConfig](#sam-webfunction-loggingconfig): {{Map}}
  [MaxConcurrencyPerEnvironment](#sam-webfunction-maxconcurrencyperenvironment): {{Integer}}
  [ReplicaRegions](#sam-webfunction-replicaregions): {{List | ReplicaRegions}}
  [RevisionDescription](#sam-webfunction-revisiondescription): {{String}}
  [RevisionWeights](#sam-webfunction-revisionweights): {{RevisionWeights}}
  [Runtime](#sam-webfunction-runtime): {{String}}
  [ScalingConfig](#sam-webfunction-scalingconfig): {{Map}}
  [Tags](#sam-webfunction-tags): {{Map}}
  [ThrottleConfig](#sam-webfunction-throttleconfig): {{Map}}
  [Timeout](#sam-webfunction-timeout): {{Integer}}
```

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

 `AuthType`   <a name="sam-webfunction-authtype"></a>
Bagaimana titik akhir mengotorisasi permintaan.  
+ `IamAuth`: Lambda mengotorisasi permintaan dengan Signature Version 4 dan IAM. Penelepon memerlukan `lambda:InvokeWebFunctionEndpoint` izin, yang diberikan melalui kebijakan berbasis sumber daya pada fungsi tersebut.
+ `ApplicationManaged`: titik akhir bersifat publik. Fungsi Anda harus mengotorisasi setiap permintaan itu sendiri.
*Nilai valid:* `IamAuth`, `ApplicationManaged`  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[AuthType](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-authtype)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `AutoDeploymentMode`   <a name="sam-webfunction-autodeploymentmode"></a>
Bagaimana titik akhir merutekan lalu lintas lintas di seluruh revisi.  
+ `LatestRevision`: mengirimkan 100% lalu lintas ke revisi yang dibuat oleh penerapan ini.
+ `Disabled`: rute lalu lintas menurut [RevisionWeights](#sam-webfunction-revisionweights).
Nilai mana yang dapat Anda gunakan, dan `RevisionWeights` apakah diperlukan, tergantung pada [EndpointType](#sam-webfunction-endpointtype):  
+ `HomeRegion`: gunakan salah satu nilai. Dengan`Disabled`, `RevisionWeights` diperlukan.
+ `MultiRegion`atau`PerRegion`: gunakan`Disabled`. Jika Anda menghilangkan`RevisionWeights`, titik akhir merutekan 100% lalu lintas ke revisi yang dibuat di tumpukan yang sama, sehingga Anda dapat membuat titik akhir dalam satu penerapan. Lalu lintas tidak berpindah ke revisi yang dibuat oleh penerapan selanjutnya.
Nilai harus diselesaikan ketika AWS SAM mengubah template. A `Ref` ke parameter didukung. Fungsi intrinsik lainnya tidak didukung.  
*Nilai valid:* `LatestRevision`, `Disabled`  
*Tipe*: String  
*Wajib*: Tidak  
*Default*: `LatestRevision`  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `CodeUri`   <a name="sam-webfunction-codeuri"></a>
Lokasi Amazon S3 dari paket penyebaran. Tentukan `s3://{{bucket}}/{{key}}` URI atau objek dengan`Bucket`,`Key`, dan `Version` kunci opsional. Untuk persyaratan bucket, lihat catatan di bagian atas halaman ini.  
*Jenis*: String \| [CodeUri](sam-property-webfunction-codeuri.md)  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[BuildConfig.CodeConfig.S3Object](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-s3object.html)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. AWS SAM mengubah `s3://` URI menjadi`Bucket`,`Key`, dan`VersionId`. 

 `EgressNetworkConnectorArn`   <a name="sam-webfunction-egressnetworkconnectorarn"></a>
ARN yang memenuhi syarat versi dari konektor jaringan yang merutekan lalu lintas keluar fungsi melalui VPC Anda. ARN harus diakhiri dengan nomor versi, misalnya. `arn:aws:lambda:us-east-1:123456789012:network-connector:my-connector:1` Untuk menggunakan versi terbaru dari konektor dalam template yang sama, tentukan`!GetAtt {{MyConnector}}.LatestVersionArn`. Konektornya [ComputeTypes](sam-resource-networkconnector.md#sam-networkconnector-computetypes)harus`WebFunction`.  
Jika Anda menentukan string literal, AWS SAM periksa apakah itu adalah ARN konektor jaringan yang memenuhi syarat versi. Fungsi intrinsik dilewatkan dan divalidasi oleh layanan. Mengubah nilai ini menciptakan revisi baru.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.EgressNetworkConnectorArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `EndpointDescription`   <a name="sam-webfunction-endpointdescription"></a>
Deskripsi titik akhir.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-description)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `EndpointName`   <a name="sam-webfunction-endpointname"></a>
Nama titik akhir. Mengubah nama menggantikan titik akhir. Mengubah `EndpointType` juga menggantikan titik akhir, jadi ubah `EndpointName` pada saat yang bersamaan. CloudFormation tidak dapat mengganti sumber daya bernama khusus tanpa nama baru.  
*Tipe*: String  
*Wajib*: Tidak  
*Default*: `prod`  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[EndpointName](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-endpointname)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `EndpointType`   <a name="sam-webfunction-endpointtype"></a>
Di mana titik akhir melayani lalu lintas.  
+ `HomeRegion`: melayani dari Wilayah tumpukan.
+ `MultiRegion`: mereplikasi fungsi ke Wilayah di [ReplicaRegions](#sam-webfunction-replicaregions)dan merutekan setiap permintaan ke Wilayah terdekat.
+ `PerRegion`: mengekspos titik akhir terpisah di setiap Region replika.
`MultiRegion`dan `PerRegion` membutuhkan`AutoDeploymentMode: Disabled`.  
*Nilai yang valid*:`HomeRegion`,`MultiRegion`, `PerRegion`  
*Tipe*: String  
*Wajib*: Tidak  
*Default*: `HomeRegion`  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[EndpointType](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-endpointtype)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `EntryPoint`   <a name="sam-webfunction-entrypoint"></a>
File yang dijalankan runtime, relatif terhadap root paket deployment. AWS SAM meneruskannya ke runtime dalam variabel `AWS_LAMBDA_NODEJS_ENTRYPOINT` lingkungan yang dicadangkan.  
Anda tidak dapat menggunakan properti ini ketika `EnvironmentVariables` merupakan fungsi intrinsik.  
*Tipe*: String  
*Wajib*: Tidak  
*Default*: `index.js`  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `EnvironmentVariables`   <a name="sam-webfunction-environmentvariables"></a>
Key-value pasangan untuk ditetapkan sebagai variabel lingkungan untuk revisi.  
+ Kunci harus dimulai dengan huruf dan hanya berisi huruf, angka, dan garis bawah.
+ Nilai harus tidak kosong dan paling banyak 4.096 karakter.
+ AWS SAM mengkonversi angka dan nilai Boolean ke string.
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.EnvironmentVariables](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-environmentvariables)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `ExecutionRoleArn`   <a name="sam-webfunction-executionrolearn"></a>
ARN dari peran IAM yang diasumsikan fungsi saat dijalankan. Jika Anda tidak menentukan peran, AWS SAM buat peran dengan kebijakan `AWSLambdaBasicExecutionRole` terkelola dan ID logis dari`{{<resource-logical-id>}}Role`.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.ExecutionRoleArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-executionrolearn)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `FunctionName`   <a name="sam-webfunction-functionname"></a>
Nama fungsi. Nama fungsi harus unik dalam akun di semua Wilayah. Jika Anda tidak menentukan nama, buat AWS SAM satu dari ID logis dan ID tumpukan, paling banyak 64 karakter. Mengubah nama menggantikan fungsi, revisinya, dan titik akhirnya.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[FunctionName](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunction.html#cfn-lambda-webfunction-functionname)` properti`AWS::Lambda::WebFunction`,`AWS::Lambda::WebFunctionRevision`, dan `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `InlineCode`   <a name="sam-webfunction-inlinecode"></a>
Tidak didukung untuk`AWS::Serverless::WebFunction`. Gunakan [CodeUri](#sam-webfunction-codeuri).  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini unik AWS SAM dan tidak memiliki CloudFormation padanan.

 `KmsKeyArn`   <a name="sam-webfunction-kmskeyarn"></a>
ARN dari AWS KMS kunci yang digunakan untuk mengenkripsi variabel lingkungan revisi.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[KmsKeyArn](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionrevision.html#cfn-lambda-webfunctionrevision-kmskeyarn)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `LoggingConfig`   <a name="sam-webfunction-loggingconfig"></a>
Konfigurasi logging untuk revisi, seperti grup log dan tingkat log.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.TelemetryConfig.LoggingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-telemetryconfig.html#cfn-lambda-webfunctionrevision-telemetryconfig-loggingconfig)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `MaxConcurrencyPerEnvironment`   <a name="sam-webfunction-maxconcurrencyperenvironment"></a>
Jumlah maksimum permintaan bersamaan yang ditangani oleh setiap lingkungan eksekusi.  
*Tipe*: Integer  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.MaxConcurrencyPerEnvironment](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-maxconcurrencyperenvironment)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `ReplicaRegions`   <a name="sam-webfunction-replicaregions"></a>
Daerah untuk mereplikasi fungsi ke. Gunakan properti ini dengan `MultiRegion` dan `PerRegion` titik akhir. Tentukan daftar kode Wilayah dan grup Wilayah, atau objek dengan `IncludeRegions` dan opsional`ExcludeRegions`.  
*Jenis*: Daftar \| [ReplicaRegions](sam-property-webfunction-replicaregions.md)  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Regions](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-regions)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. AWS SAM memperluas kelompok Wilayah dan berlaku `ExcludeRegions` untuk menghasilkan daftar Wilayah. 

 `RevisionDescription`   <a name="sam-webfunction-revisiondescription"></a>
Deskripsi revisi yang dibuat oleh penerapan ini.  
*Tipe*: String  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[Description](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionrevision.html#cfn-lambda-webfunctionrevision-description)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `RevisionWeights`   <a name="sam-webfunction-revisionweights"></a>
Peta ID revisi untuk bobot lalu lintas. Gunakan properti ini kapan `AutoDeploymentMode` saja`Disabled`. Tentukan hingga dua revisi. Setiap bobot adalah bilangan bulat dari 1 hingga 100, dan bobot harus bertambah hingga 100.  
*Jenis*: [RevisionWeights](sam-property-webfunction-revisionweights.md)  
*Diperlukan*: Bersyarat. Diperlukan kapan `AutoDeploymentMode` `Disabled` dan `EndpointType` sedang`HomeRegion`.  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[RevisionWeights](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-revisionweights)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. AWS SAM mengubah peta menjadi daftar `RevisionId` dan `Weight` objek. 

 `Runtime`   <a name="sam-webfunction-runtime"></a>
Runtime untuk fungsi, misalnya`nodejs24.x`.  
*Tipe*: String  
*Wajib*: Ya  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[BuildConfig.RuntimeConfig.Runtime](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-runtimeconfig.html#cfn-lambda-webfunctionrevision-runtimeconfig-runtime)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

 `ScalingConfig`   <a name="sam-webfunction-scalingconfig"></a>
Konfigurasi penskalaan untuk titik akhir, seperti jumlah maksimum lingkungan eksekusi.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ScalingConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-scalingconfig)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `Tags`   <a name="sam-webfunction-tags"></a>
Peta pasangan kunci-nilai yang menentukan tag yang ditambahkan ke fungsi dan peran eksekusi yang dihasilkan. AWS SAM   
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini mirip dengan `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunction.html#cfn-lambda-webfunction-tags)` properti `AWS::Lambda::WebFunction` 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 fungsi dan ke peran default yang dihasilkan untuk itu. 

 `ThrottleConfig`   <a name="sam-webfunction-throttleconfig"></a>
Konfigurasi throttling untuk titik akhir, seperti tingkat permintaan maksimum.  
*Tipe*: Peta  
*Wajib*: Tidak  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ThrottleConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-webfunctionendpoint.html#cfn-lambda-webfunctionendpoint-throttleconfig)` properti `AWS::Lambda::WebFunctionEndpoint` sumber daya. 

 `Timeout`   <a name="sam-webfunction-timeout"></a>
Waktu maksimum, dalam hitungan detik, fungsi dapat dijalankan per permintaan. Nilai yang valid adalah dari 3 hingga 900.  
*Tipe*: Integer  
*Wajib*: Tidak  
*Default*: `30`  
*CloudFormation kompatibilitas*: Properti ini diteruskan langsung ke `[ServiceConfig.TimeoutSeconds](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-webfunctionrevision-serviceconfig.html#cfn-lambda-webfunctionrevision-serviceconfig-timeoutseconds)` properti `AWS::Lambda::WebFunctionRevision` sumber daya. 

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

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

Ketika ID logis dari sumber daya ini disediakan untuk fungsi `Ref` intrinsik, ia mengembalikan ARN dari Fungsi Web. Di mana Anda membutuhkan nama fungsi, gunakan nilai `FunctionName` sebagai gantinya.

Untuk informasi lebih lanjut tentang menggunakan fungsi `Ref`, lihat [`Ref`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) di *Panduan Pengguna AWS CloudFormation *.

### Fn:: GetAtt
<a name="sam-resource-webfunction-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 [`Fn::GetAtt`](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) di *Panduan Pengguna AWS CloudFormation *

`FunctionArn`  <a name="sam-webfunction-getatt-functionarn"></a>
Nama Sumber Daya Amazon (ARN) dari Fungsi Web.

`State`  <a name="sam-webfunction-getatt-state"></a>
Keadaan Fungsi Web saat ini.

`StateReason`  <a name="sam-webfunction-getatt-statereason"></a>
Alasan untuk keadaan saat ini dari Fungsi Web.

`CreatedAt`  <a name="sam-webfunction-getatt-createdat"></a>
Waktu dimana Web Function dibuat.

`UpdatedAt`  <a name="sam-webfunction-getatt-updatedat"></a>
Waktu Fungsi Web terakhir diperbarui.

Untuk mereferensikan revisi atau titik akhir yang AWS SAM menghasilkan, gunakan ID logisnya, `{{<resource-logical-id>}}Revision` dan. `{{<resource-logical-id>}}Endpoint` Misalnya, `!GetAtt MyWebFunctionEndpoint.DomainName` mengembalikan nama domain dari endpoint untuk Fungsi Web dengan ID `MyWebFunction` logis. Untuk informasi selengkapnya, lihat [CloudFormation sumber daya yang dihasilkan ketika AWS::Serverless::WebFunction ditentukan](sam-specification-generated-resources-webfunction.md).

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

### Fungsi Web Dasar
<a name="sam-resource-webfunction-example-basic"></a>

Contoh berikut membuat Web Function dengan IAM-authorized endpoint di Region stack. AWS SAM menghasilkan peran eksekusi, dan titik akhir merutekan semua lalu lintas ke revisi yang dibuat penerapan ini.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      Timeout: 30

Outputs:
  EndpointUrl:
    Value: !Sub https://${MyWebFunctionEndpoint.DomainName}
```

### Pisahkan lalu lintas antara dua revisi
<a name="sam-resource-webfunction-example-canary"></a>

Contoh berikut menonaktifkan penyebaran otomatis dan mengirimkan 90% lalu lintas ke satu revisi yang ada dan 10% ke yang lain. Kedua revisi harus sudah ada.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri: s3://amzn-s3-demo-bucket/webfn-v2.zip
      AutoDeploymentMode: Disabled
      RevisionWeights:
        rev-abc123: 90
        rev-def456: 10
```

### Multi-Region Fungsi Web
<a name="sam-resource-webfunction-example-multiregion"></a>

Contoh berikut mereplikasi fungsi ke Wilayah AS kecuali `us-west-1` dan merutekan setiap permintaan ke Wilayah terdekat. Karena `RevisionWeights` dihilangkan, titik akhir merutekan semua lalu lintas ke revisi yang dibuat di tumpukan ini.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      EndpointName: prodmr
      EndpointType: MultiRegion
      AutoDeploymentMode: Disabled
      ReplicaRegions:
        IncludeRegions:
          - US
        ExcludeRegions:
          - us-west-1
```

### Fungsi Web dengan jalan keluar VPC
<a name="sam-resource-webfunction-example-vpc-egress"></a>

Contoh berikut membuat konektor jaringan untuk Fungsi Web dan merutekan lalu lintas keluar fungsi melalui subnet konektor dan grup keamanan.

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyConnector:
    Type: AWS::Serverless::NetworkConnector
    Properties:
      ComputeTypes:
        - WebFunction
      VpcConfig:
        SubnetIds:
          - subnet-0abc123def4567890
          - subnet-0def456abc7890123
        SecurityGroupIds:
          - sg-0abc1234abcde0001
        NetworkProtocol: IPv4

  MyWebFunction:
    Type: AWS::Serverless::WebFunction
    Properties:
      Runtime: nodejs24.x
      AuthType: IamAuth
      CodeUri:
        Bucket: amzn-s3-demo-bucket
        Key: webfn.zip
        Version: {{object-version-id}}
      EgressNetworkConnectorArn: !GetAtt MyConnector.LatestVersionArn
```