Latihan - Jelajahi jenis pengikatan input serta output

10 menit

Dalam latihan ini, kami membuat fungsi yang berjalan saat menerima permintaan HTTP, dan merespons setiap permintaan dengan mengembalikan pesan.

Lihat ilustrasi tingkat tinggi berikut mengenai apa yang akan kita bangun.

Parameter req adalah pengikatan pemicu, dan parameter res adalah pengikatan output. Ini mungkin membantu menganggap parameter ini sebagai singkatan untuk "permintaan" dan "respons."

Parameter Request adalah pengikatan pemicu, dan parameter Response adalah pengikatan output.

Buat aplikasi fungsi

Mari kita buat aplikasi fungsi yang dapat kita gunakan di seluruh modul ini. Aplikasi fungsi memungkinkan Anda untuk mengelompokkan fungsi sebagai unit logis untuk manajemen, penyebaran, dan berbagi sumber daya yang lebih mudah.

Masuk ke portal Microsoft Azure menggunakan akun yang Anda gunakan untuk mengaktifkan kotak pasir.
Pada menu sumber daya atau dari halaman Beranda, pilih Buat sumber daya. Panel Buat sumber daya akan muncul.
Di menu Buat sumber daya, pilih Azure Compute, dan di daftar hasil pilih Aplikasi Fungsi. Anda mungkin perlu mencari Aplikasi Fungsi di jendela layanan Pencarian dan marketplace.
Pilih Konsumsi, lalu pilih tombol Pilih . Panel Membuat Aplikasi Fungsi akan muncul.

Pada tab Dasar, masukkan nilai berikut untuk setiap pengaturan.

Pengaturan	Nilai	Deskripsi
Detail Proyek
Langganan	Langganan Concierge	Langganan Azure yang ingin Anda gunakan untuk latihan ini.
Grup Sumber Daya	Dari menu drop-down, pilih [nama grup sumber daya kotak pasir]	Grup sumber daya untuk kotak pasir.
Detail Instans
Nama Aplikasi Fungsi	Masukkan nama unik secara global	Nama ini mengidentifikasi aplikasi fungsi baru Anda. Karakter yang valid adalah `a-z`, `0-9`, dan `-`.
Tumpukan runtime	Dari menu drop-down, silakan pilih Apa pun	Kode sampel dalam modul ini ditulis dalam bahasa pemrograman JavaScript.
Versi	Terima default	Nilai default cukup bagi latihan ini.
Wilayah	Dari menu drop-down, silakan pilih lokasi	Pilih wilayah yang terdekat dengan Anda.

Terima default untuk semua opsi lainnya. Pilih Tinjau + buat untuk memvalidasi pengaturan Anda, lalu pilih Buat untuk memprovisikan dan menyebarkan aplikasi fungsi.
Penyebaran dapat menghabiskan waktu lama. Di kontrol global di sebelah nama akun Anda, pilih ikon Pemberitahuan, dan perhatikan pesan Penyebaran berhasil.
Saat penyebaran fungsi Anda selesai, pilih Buka sumber daya. Panel Ringkasan untuk aplikasi fungsi Anda akan muncul.

Masuk ke portal Microsoft Azure menggunakan akun yang sama yang digunakan untuk mengaktifkan sandbox.
Pada menu sumber daya atau dari halaman Beranda, pilih Buat sumber daya. Panel Buat sumber daya akan muncul.
Di menu Buat sumber daya, pilih Azure Compute, dan di daftar hasil pilih Aplikasi Fungsi. Anda mungkin perlu mencari Aplikasi Fungsi di jendela layanan Pencarian dan marketplace.
Pilih Konsumsi, lalu pilih tombol Pilih . Panel Membuat Aplikasi Fungsi akan muncul.

Pada tab Dasar, masukkan nilai berikut untuk setiap pengaturan.

Pengaturan	Nilai	Deskripsi
Detail Proyek
Langganan	Langganan Concierge	Langganan Azure yang ingin Anda gunakan untuk latihan ini.
Grup Sumber Daya	Dari menu drop-down, pilih [nama grup sumber daya kotak pasir]	Grup sumber daya untuk kotak pasir.
Detail Instans
Nama Aplikasi Fungsi	Masukkan nama unik secara global	Nama ini mengidentifikasi aplikasi fungsi baru Anda. Karakter yang valid adalah `a-z`, `0-9`, dan `-`.
Tumpukan runtime	Dari daftar turun bawah, silakan pilih PowerShell Core	Kode sampel untuk modul ini ditulis di PowerShell.
Versi	Terima default	Nilai default cukup bagi latihan ini.
Wilayah	Dari menu drop-down, silakan pilih lokasi	Pilih wilayah yang terdekat dengan Anda.

Terima default untuk semua opsi lainnya. Pilih Tinjau + buat untuk memvalidasi input Anda, lalu pilih Buat untuk memprovisikan dan menyebarkan aplikasi fungsi.
Penyebaran dapat menghabiskan waktu lama. Di kontrol global di sebelah nama akun Anda, pilih ikon Pemberitahuan, dan perhatikan pesan Penyebaran berhasil.
Saat penyebaran fungsi Anda selesai, pilih Buka sumber daya. Panel Ringkasan untuk aplikasi fungsi Anda akan muncul.

Tip

Jika Anda kesulitan menemukan aplikasi fungsi Anda di portal Azure, pelajari cara menambahkan aplikasi fungsi ke favorit Anda di portal Azure.

Membuat fungsi

Sekarang kita memiliki aplikasi fungsi, saatnya untuk membuat fungsi. Setiap fungsi diaktifkan oleh pemicu. Dalam modul ini, kami menentukan pemicu HTTP dengan menggunakan templat yang telah ditentukan sebelumnya.

Pilih tombol Buat fungsi di bawah Buat di portal Azure di tab Fungsi pada halaman Gambaran Umum.
Panel Buat fungsi muncul.
Di bagian Pilih templat , pilih templat pemicu HTTP, lalu pilih Berikutnya.
Di bagian Detail templat, konfirmasi pengaturan berikut.
- Dalam kotak teks Nama fungsi, terima nama default HttpTrigger1. Azure secara otomatis membuat nama unik untuk fungsi yang Anda buat. Anda dapat memilih nama yang berbeda, tetapi ingatlah untuk menggunakan nama yang bermakna.
- Di kotak teks Tingkat otorisasi, terima nilai default Fungsi. Tingkat otorisasi menentukan kunci apa yang perlu ada pada permintaan agar dapat dijalankan. Tingkat otorisasi fungsi memerlukan kunci khusus fungsi, yang dapat kita temukan setelah dibuat.
Pilih Buat. Saat fungsi pemicu telah disebarkan ke aplikasi fungsi Anda, panel Functions untuk Aplikasi Fungsi Anda muncul, mencantumkan HttpTrigger1.
Di bilah perintah, pilih Dapatkan Url Fungsi. Kotak dialog Dapatkan Url Fungsi akan muncul.
Dalam daftar dropdown, pilih default (kunci fungsi), pilih ikon Salin ke clipboard di akhir URL, lalu pilih OK untuk menutup dialog.
Di bilah alamat tab browser baru, tempel URL fungsi yang Anda salin. Tekan Enter dengan tujuan menjalankan permintaan di browser Anda. Respons mungkin memakan waktu beberapa menit saat aplikasi fungsi diinisialisasi. Jika Anda menerima kesalahan batas waktu, refresh untuk mengirim ulang permintaan.

Saat fungsi merespons, Anda akan melihat output yang mirip dengan contoh berikut yang ditampilkan di browser Anda.
```
This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.
```
Tambahkan string kueri berikut &name=Joe ke akhir URL. URL Anda harus menyerupai contoh berikut:

https://example.azurewebsites.net/api/HttpTrigger1?code=AbCdEfGhIjKlMnOpQrStUvWxYz==&name=Joe
Tekan Enter dengan tujuan menjalankan permintaan di browser Anda. Saat fungsi merespons, Anda akan melihat output yang mirip dengan contoh berikut yang ditampilkan di browser Anda.
```
Hello, Joe. This HTTP triggered function executed successfully.
```
Seperti yang dapat Anda lihat dari latihan ini sejauh ini, Anda harus menentukan pemicu saat membuat fungsi. Setiap fungsi memiliki sebuah pemicu tunggal. Dalam contoh ini, kami menggunakan pemicu HTTP, yang berarti fungsi kita dimulai saat menerima permintaan HTTP. Penerapan default dari templat, yang ditampilkan dalam JavaScript pada cuplikan layar berikut, mengembalikan nilai parameter nama yang ada di string kueri atau isi permintaan. Jika tidak ada string kueri yang disediakan, fungsi merespons dengan pesan yang meminta siapa pun yang menelepon untuk memberikan nilai nama.

Di portal Azure, di menu Fungsi, pilih Kode + Uji.

Panel Kode + Uji untuk fungsi Anda muncul, dan menampilkan konten file index.js Anda. Kode JavaScript default untuk fungsi Anda harus serupa dengan contoh berikut.

module.exports = async function (context, req) {
    context.log('JavaScript HTTP trigger function processed a request.');

    const name = (req.query.name || (req.body && req.body.name));
    const responseMessage = name
        ? "Hello, " + name + ". This HTTP triggered function executed successfully."
        : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";

    context.res = {
        // status: 200, /* Defaults to 200 */
        body: responseMessage
    };
}

Mari kita lihat secara singkat file fungsi lainnya, file konfigurasi function.json. Akses file ini dengan memilih function.json dari daftar dropdown di jalur file di atas blok kode. Data konfigurasi akan ditampilkan dalam daftar JSON berikut.
```
{
    "bindings": [
    {
        "authLevel": "function",
        "type": "httpTrigger",
        "direction": "in",
        "name": "req",
        "methods": [
        "get",
        "post"
        ]
    },
    {
        "type": "http",
        "direction": "out",
        "name": "res"
    }
  ]
}
```
Fungsi ini memiliki pengikatan pemicu bernama req jenis httpTrigger, dan pengikatan output bernama res jenis http.

Dalam kode sebelumnya untuk fungsi, kita melihat bahwa kita mengakses payload permintaan HTTP yang masuk melalui parameter req. Demikian pula, kita mengirim respons HTTP dengan mengatur parameter res. Pengikatan benar-benar mengurus beberapa pekerjaan yang memberatkan bagi kita!

Sekarang kita memiliki aplikasi fungsi, mari kita buat fungsi. Setiap fungsi diaktifkan oleh pemicu. Dalam modul ini, kita membuat pemicu HTTP dengan menggunakan templat.

Pilih tombol Buat fungsi di bawah Buat di portal Azure di tab Fungsi pada halaman Gambaran Umum.
Panel Buat fungsi muncul.
Di bagian Pilih templat , pilih templat pemicu HTTP, lalu pilih Berikutnya.
Di bagian Detail templat, konfirmasi pengaturan berikut.
- Dalam kotak teks Nama fungsi, terima nama default HttpTrigger1. Azure secara otomatis memberikan nama unik saat Anda membuat fungsi. Anda dapat memilih nama yang berbeda, tetapi ingatlah untuk menggunakan nama yang bermakna.
- Di kotak teks Tingkat otorisasi, terima nilai default Fungsi. Tingkat otorisasi menentukan kunci apa yang perlu ada pada permintaan agar dapat dijalankan. Fungsi membutuhkan kunci khusus fungsi.
Pilih Buat. Panel HttpTrigger1 untuk Fungsi Anda akan muncul.
Di bilah perintah, pilih Dapatkan Url Fungsi. Kotak dialog Dapatkan Url Fungsi akan muncul.
Pilih default (kunci fungsi) dari daftar dropdown, lalu pilih ikon Salin ke clipboard di akhir URL, lalu pilih OK untuk menutup kotak dialog.
Di bilah alamat tab browser baru, tempel URL fungsi yang Anda salin. Tekan Enter dengan tujuan menjalankan permintaan di browser Anda. Respons mungkin memakan waktu beberapa menit saat aplikasi fungsi diinisialisasi. Jika Anda menerima kesalahan batas waktu, refresh untuk mengirim ulang permintaan.

Saat fungsi merespons, Anda akan melihat output yang mirip dengan contoh berikut yang ditampilkan di browser Anda.
```
This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.
```
Tambahkan string kueri &name=Joe ke akhir URL. URL Anda harus menyerupai contoh berikut:

https://example.azurewebsites.net/api/HttpTrigger1?code=AbCdEfGhIjKlMnOpQrStUvWxYz==&name=Joe
Tekan Enter dengan tujuan menjalankan permintaan di browser Anda. Saat fungsi merespons, Anda akan melihat output yang mirip dengan contoh berikut yang ditampilkan di browser Anda.
```
Hello, Joe. This HTTP triggered function executed successfully.
```
Seperti yang dapat Anda lihat dari latihan ini sejauh ini, Anda harus menentukan pemicu saat membuat fungsi. Setiap fungsi memiliki sebuah pemicu tunggal. Dalam contoh ini, kami menggunakan pemicu HTTP, yang berarti fungsi kita dimulai saat menerima permintaan HTTP. Penerapan default dari templat, yang ditampilkan di PowerShell di cuplikan layar berikut, menggunakan cmdlet Push-OutputBinding untuk merespons dengan nilai nama parameter yang merupakan bagian dari string kueri atau isi permintaan. Jika tidak ada string yang disediakan, maka fungsi akan merespons dengan pesan yang meminta siapa pun yang menelepon untuk menyediakan nilai nama.

Di menu Fungsi, pilih Kode + Uji. Panel Kode + Pengujian untuk fungsi Anda muncul, dan menampilkan konten file run.ps1.

Kode PowerShell default untuk fungsi Anda harus serupa dengan contoh berikut.

using namespace System.Net

# Input bindings are passed in via param block.
param($Request, $TriggerMetadata)

# Write to the Azure Functions log stream.
Write-Host "PowerShell HTTP trigger function processed a request."

# Interact with query parameters or the body of the request.
$name = $Request.Query.Name
if (-not $name) {
    $name = $Request.Body.Name
}

$body = "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."

if ($name) {
    $body = "Hello, $name. This HTTP triggered function executed successfully."
}

# Associate values to output bindings by calling 'Push-OutputBinding'.
Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
    StatusCode = [HttpStatusCode]::OK
    Body = $body
})

Mari kita lihat secara singkat file fungsi lainnya, file konfigurasi function.json. Buka file ini dengan memilih function.json dari daftar dropdown jalur file. Data konfigurasi akan ditampilkan dalam daftar JSON berikut.
```
{
  "bindings": [
    {
      "authLevel": "function",
      "type": "httpTrigger",
      "direction": "in",
      "name": "Request",
      "methods": [
        "get",
        "post"
      ]
    },
    {
      "type": "http",
      "direction": "out",
      "name": "Response"
    }
  ]
}
```
Seperti yang Anda lihat, fungsi ini memiliki pengikatan pemicu bernama Permintaan dari jenis httpTrigger, dan pengikatan output bernama Respons dari jenis http. Dalam kode sebelumnya untuk fungsi kita, kita lihat bagaimana kita mengakses muatan permintaan yang masuk melalui parameter Permintaan. Demikian pula, kita mengirim respons HTTP hanya dengan mengatur parameter Respons. Pengikatan benar-benar mengerjakan beberapa pekerjaan yang memberatkan bagi kita.

Jelajahi jenis pengikatan

Di menu Fungsi, pilih Integrasi. Panel Integrasi untuk fungsi Anda akan muncul.

Perhatikan bahwa kita telah menentukan pemicu dan pengikatan output, seperti yang ditunjukkan pada gambar berikut. Tampilan integrasi menyesuaikan yang paling cocok untuk lebar dan tinggi layar Anda. Informasi yang sama dapat ditampilkan secara horizontal, jika layar Anda cukup lebar.

Anda dapat melihat bahwa kita tidak bisa menambahkan lebih dari satu pemicu. Untuk mengubah pemicu suatu fungsi, Anda perlu menghapus pemicu dan membuat yang baru. Namun, bagian Input dan Output memungkinkan Anda menambahkan lebih dari satu pengikatan, sehingga permintaan dapat menerima lebih dari satu nilai input dan menampilkan lebih dari satu nilai output.
Dalam kotak Input, pilih Tambahkan input. Panel Buat Input akan muncul. Pilih daftar dropdown untuk Jenis Pengikatan guna melihat daftar semua kemungkinan jenis pengikatan input.

Luangkan waktu sejenak untuk mempertimbangkan bagaimana Anda dapat menggunakan setiap pengikatan input ini dalam solusi.

Nanti dalam modul ini, kami menambahkan pengikatan input, tetapi untuk saat ini, pilih Batal untuk menutup panel ini.
Di kotak Output, pilih Tambahkan output. Panel Buat Output akan muncul. Pilih daftar dropdown untuk Jenis Pengikatan untuk melihat daftar semua kemungkinan jenis pengikatan output.

Seperti yang dapat Anda lihat, ada beberapa jenis pengikatan output. Nanti dalam modul ini, kami menambahkan pengikatan output tetapi, untuk saat ini, pilih Batal untuk menutup panel ini.

Di menu Fungsi, pilih Integrasi. Panel Integrasi untuk fungsi Anda akan muncul.

Perhatikan bahwa kita telah menentukan pemicu dan pengikatan output, seperti yang ditunjukkan pada gambar berikut. Tampilan integrasi menyesuaikan yang paling cocok untuk lebar dan tinggi layar Anda. Informasi yang sama dapat ditampilkan secara vertikal, jika layar Anda tidak cukup lebar.

Anda dapat melihat bahwa kita tidak bisa menambahkan lebih dari satu pemicu. Untuk mengubah pemicu suatu fungsi, Anda perlu menghapus pemicu dan membuat yang baru. Namun, bagian Input dan Output memungkinkan Anda menambahkan beberapa pengikatan, sehingga fungsi dapat menerima lebih dari satu nilai input dan menampilkan lebih dari satu nilai output.
Dalam kotak Input, pilih Tambahkan input. Panel Buat Input akan muncul. Pilih daftar dropdown untuk Jenis Pengikatan guna melihat daftar semua kemungkinan jenis pengikatan input.

Luangkan waktu sejenak untuk mempertimbangkan bagaimana Anda dapat menggunakan setiap pengikatan input ini dalam solusi. Ada banyak kemungkinan untuk dipilih.

Nanti dalam modul ini, kami menambahkan pengikatan input, tetapi untuk saat ini, pilih Batal untuk menutup panel ini.
Di kotak Output, pilih Tambahkan output. Panel Buat Output akan muncul. Pilih daftar dropdown untuk Jenis Pengikatan untuk melihat daftar semua kemungkinan jenis pengikatan output.

Seperti yang dapat Anda lihat, ada beberapa jenis pengikatan output. Nanti dalam modul ini, kami menambahkan pengikatan output tetapi, untuk saat ini, pilih Batal untuk menutup panel ini.

Sejauh ini, kita telah mempelajari cara untuk membuat aplikasi fungsi dan menambahkan fungsi ke dalamnya. Kita telah melihat fungsi sederhana dalam tindakan--fungsi yang berjalan saat permintaan dibuat. Kita juga telah menjelajahi portal Azure dan jenis pengikatan input dan output yang tersedia untuk fungsi. Di unit berikutnya, kita akan menggunakan pengikatan input untuk membaca teks dari database.

Lanjutkan

Latihan - Jelajahi jenis pengikatan input serta output

Buat aplikasi fungsi

Membuat fungsi

Jelajahi jenis pengikatan

Saran dan Komentar