

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

# Menyiapkan permintaan integrasi API menggunakan konsol API Gateway
<a name="how-to-method-settings-console"></a>

 Penyiapan metode API mendefinisikan metode dan menjelaskan perilakunya. Untuk mengatur metode, Anda harus menentukan sumber daya, termasuk root (“/”), di mana metode diekspos, metode HTTP (,, dll.) `GET``POST`, Dan bagaimana itu akan diintegrasikan dengan backend yang ditargetkan. Permintaan dan respons metode menentukan kontrak dengan aplikasi panggilan, menetapkan parameter mana yang dapat diterima API dan seperti apa responsnya. 

 Prosedur berikut menjelaskan cara menggunakan konsol API Gateway untuk membuat permintaan integrasi.

**Topics**
+ [Siapkan integrasi Lambda](#how-to-method-settings-console-lambda)
+ [Siapkan integrasi HTTP](#how-to-method-settings-console-http)
+ [Siapkan integrasi AWS layanan](#how-to-method-settings-console-aws)
+ [Siapkan integrasi tiruan](#how-to-method-settings-console-mock)

## Siapkan integrasi Lambda
<a name="how-to-method-settings-console-lambda"></a>

Gunakan integrasi fungsi Lambda untuk mengintegrasikan API Anda dengan fungsi Lambda. Pada API level, ini adalah tipe `AWS` integrasi jika Anda membuat integrasi non-proxy, atau tipe `AWS_PROXY` integrasi jika Anda membuat integrasi proxy.

**Untuk mengatur integrasi Lambda**

1. Di panel **Resources**, pilih **Create method**.

1. Untuk **jenis Metode**, pilih metode HTTP.

1. Untuk **jenis Integrasi**, pilih fungsi **Lambda**.

1. Untuk menggunakan integrasi proxy Lambda, aktifkan integrasi proxy **Lambda**. Untuk mempelajari lebih lanjut tentang integrasi proxy Lambda, lihat. [Memahami integrasi proxy API Gateway Lambda](set-up-lambda-proxy-integrations.md#api-gateway-create-api-as-simple-proxy)

1. Untuk **fungsi Lambda**, masukkan nama fungsi Lambda.

    Jika Anda menggunakan fungsi Lambda di Wilayah yang berbeda dari API Anda, pilih Wilayah dari menu tarik-turun dan masukkan nama fungsi Lambda. Jika Anda menggunakan fungsi Lambda lintas akun, masukkan fungsi ARN. 

1. Untuk menggunakan nilai batas waktu default 29 detik, tetap aktifkan **batas waktu default**. Untuk menetapkan batas waktu kustom, pilih Batas **waktu default** dan masukkan nilai batas waktu antara `50` dan milidetik. `29000`

1. (Opsional) Anda dapat mengonfigurasi pengaturan permintaan metode menggunakan menu tarik-turun berikut. Pilih **Pengaturan permintaan metode** dan konfigurasikan permintaan metode Anda. Untuk informasi lebih lanjut, lihat langkah 3 dari[Mengedit permintaan metode API Gateway di konsol API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console).

   Anda juga dapat mengonfigurasi pengaturan permintaan metode Anda setelah Anda membuat metode Anda.

1. Pilih **metode Buat**.

## Siapkan integrasi HTTP
<a name="how-to-method-settings-console-http"></a>

Gunakan integrasi HTTP untuk mengintegrasikan API Anda dengan titik akhir HTTP. Pada level API, ini adalah tipe `HTTP` integrasi.

**Untuk mengatur integrasi HTTP**

1. Di panel **Resources**, pilih **Create method**.

1. Untuk **jenis Metode**, pilih metode HTTP.

1. Untuk **jenis Integrasi**, pilih **HTTP**.

1. Untuk menggunakan integrasi proxy HTTP, aktifkan **integrasi proxy HTTP**. Untuk mempelajari lebih lanjut tentang integrasi proxy HTTP, lihat[Siapkan integrasi proxy HTTP di API Gateway](setup-http-integrations.md#api-gateway-set-up-http-proxy-integration-on-proxy-resource).

1. Untuk **metode HTTP**, pilih jenis metode HTTP yang paling cocok dengan metode di backend HTTP.

1. Untuk **URL Endpoint**, masukkan URL backend HTTP yang ingin digunakan metode ini.

1. Untuk **penanganan Konten**, pilih perilaku penanganan konten.

1. Untuk menggunakan nilai batas waktu default 29 detik, tetap aktifkan **batas waktu default**. Untuk menetapkan batas waktu kustom, pilih Batas **waktu default** dan masukkan nilai batas waktu antara `50` dan milidetik. `29000`

1. (Opsional) Anda dapat mengonfigurasi pengaturan permintaan metode menggunakan menu tarik-turun berikut. Pilih **Pengaturan permintaan metode** dan konfigurasikan permintaan metode Anda. Untuk informasi lebih lanjut, lihat langkah 3 dari[Mengedit permintaan metode API Gateway di konsol API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console).

   Anda juga dapat mengonfigurasi pengaturan permintaan metode Anda setelah Anda membuat metode Anda.

1. Pilih **metode Buat**.

## Siapkan integrasi AWS layanan
<a name="how-to-method-settings-console-aws"></a>

Gunakan integrasi AWS layanan untuk mengintegrasikan API Anda secara langsung dengan AWS layanan. Pada level API, ini adalah tipe `AWS` integrasi.

Untuk menyiapkan API Gateway API untuk melakukan salah satu hal berikut:
+ Buat fungsi Lambda baru.
+ Tetapkan izin sumber daya pada fungsi Lambda.
+ Lakukan tindakan layanan Lambda lainnya.

Anda harus memilih **AWS layanan**.

**Untuk mengatur integrasi AWS layanan**

1. Di panel **Resources**, pilih **Create method**.

1. Untuk **jenis Metode**, pilih metode HTTP.

1. Untuk **jenis Integrasi**, pilih **AWS layanan**.

1. Untuk **AWS Wilayah**, pilih AWS Wilayah yang ingin digunakan metode ini untuk memanggil tindakan.

1. Untuk **AWS layanan**, pilih AWS layanan yang Anda inginkan untuk memanggil metode ini.

1.  Untuk **AWS subdomain**, masukkan subdomain yang digunakan oleh layanan. AWS Biasanya, Anda akan membiarkan ini kosong. Beberapa AWS layanan dapat mendukung subdomain sebagai bagian dari host. Konsultasikan dokumentasi layanan untuk ketersediaan dan, jika tersedia, detailnya. 

1. Untuk **metode HTTP**, pilih jenis metode HTTP yang sesuai dengan tindakan. Untuk jenis metode HTTP, lihat dokumentasi referensi API untuk AWS layanan yang Anda pilih untuk **AWS layanan**.

1. Untuk **tipe Tindakan**, pilih **Gunakan nama tindakan** untuk menggunakan tindakan API atau **Use path override** untuk menggunakan jalur sumber daya kustom. Untuk tindakan yang tersedia dan jalur sumber daya khusus, lihat dokumentasi referensi API untuk AWS layanan yang Anda pilih untuk **AWS layanan**.

1. Masukkan **nama Action** atau **Path override**.

1. Untuk **peran Eksekusi**, masukkan ARN dari peran IAM yang akan digunakan metode untuk memanggil tindakan.

   Untuk membuat peran IAM, Anda dapat menyesuaikan instruksi di[Langkah 1: Buat peran eksekusi proxy AWS layanan](getting-started-aws-proxy.md#getting-started-aws-proxy-add-roles). Tentukan kebijakan akses dengan jumlah tindakan dan pernyataan sumber daya yang diinginkan. Untuk informasi selengkapnya, lihat [Cara kerja Amazon API Gateway dengan IAM](security_iam_service-with-iam.md).

   Untuk sintaks pernyataan tindakan dan sumber daya, lihat dokumentasi untuk AWS layanan yang Anda pilih untuk **AWS layanan**.

   Untuk hubungan kepercayaan peran IAM, tentukan hal berikut, yang memungkinkan API Gateway mengambil tindakan atas nama AWS akun Anda:

------
#### [ JSON ]

****  

   ```
   {
     "Version":"2012-10-17",		 	 	 
     "Statement": [
       {
         "Sid": "",
         "Effect": "Allow",
         "Principal": {
           "Service": "apigateway.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

------

1. Untuk menggunakan nilai batas waktu default 29 detik, tetap aktifkan **batas waktu default**. Untuk menetapkan batas waktu kustom, pilih Batas **waktu default** dan masukkan nilai batas waktu antara `50` dan milidetik. `29000`

1. (Opsional) Anda dapat mengonfigurasi pengaturan permintaan metode menggunakan menu tarik-turun berikut. Pilih **Pengaturan permintaan metode** dan konfigurasikan permintaan metode Anda. Untuk informasi lebih lanjut, lihat langkah 3 dari[Mengedit permintaan metode API Gateway di konsol API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console).

   Anda juga dapat mengonfigurasi pengaturan permintaan metode Anda setelah Anda membuat metode Anda.

1. Pilih **metode Buat**.

## Siapkan integrasi tiruan
<a name="how-to-method-settings-console-mock"></a>

 Gunakan integrasi tiruan jika Anda ingin API Gateway bertindak sebagai backend Anda untuk mengembalikan respons statis. Pada level API, ini adalah tipe `MOCK` integrasi. Biasanya, Anda dapat menggunakan `MOCK` integrasi saat API Anda belum final, tetapi Anda ingin menghasilkan respons API untuk membuka blokir tim dependen untuk pengujian. Untuk `OPTION` metode ini, API Gateway menetapkan `MOCK` integrasi sebagai default untuk mengembalikan header yang mengaktifkan CORS untuk sumber daya API yang diterapkan.

**Untuk mengatur integrasi tiruan**

1. Di panel **Resources**, pilih **Create method**.

1. Untuk **jenis Metode**, pilih metode HTTP.

1. Untuk **tipe Integrasi**, pilih **Mock**.

1. (Opsional) Anda dapat mengonfigurasi pengaturan permintaan metode menggunakan menu tarik-turun berikut. Pilih **Pengaturan permintaan metode** dan konfigurasikan permintaan metode Anda. Untuk informasi lebih lanjut, lihat langkah 3 dari[Mengedit permintaan metode API Gateway di konsol API Gateway](how-to-set-up-method-using-console.md#how-to-method-settings-callers-console).

   Anda juga dapat mengonfigurasi pengaturan permintaan metode Anda setelah Anda membuat metode Anda.

1. Pilih **metode Buat**.