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

# Terapkan WebSocket APIs di API Gateway
<a name="apigateway-set-up-websocket-deployment"></a>

 Setelah membuat WebSocket API Anda, Anda harus menerapkannya agar tersedia bagi pengguna Anda untuk dipanggil. 

[Untuk menerapkan API, Anda membuat [penerapan API](api-gateway-basic-concept.md#apigateway-definition-api-deployment) dan mengaitkannya dengan sebuah panggung.](api-gateway-basic-concept.md#apigateway-definition-api-stage) Setiap tahap adalah snapshot dari API dan tersedia untuk aplikasi klien untuk dipanggil. 

**penting**  
Setiap kali Anda memperbarui API, Anda harus menerapkannya kembali. Perubahan pada apa pun selain pengaturan tahap memerlukan pemindahan, termasuk modifikasi pada sumber daya berikut:  
Rute
Integrasi
Pengotorisasi
Secara default, Anda dibatasi hingga 10 tahap untuk setiap API. Kami menyarankan Anda menggunakan kembali tahapan untuk penerapan Anda. 

Untuk memanggil WebSocket API yang diterapkan, klien mengirim pesan ke URL API. URL ditentukan oleh nama host dan nama panggung API.

**catatan**  
API Gateway akan mendukung payload hingga 128 KB dengan ukuran frame maksimal 32 KB. Jika pesan melebihi 32 KB, itu harus dibagi menjadi beberapa frame, masing-masing 32 KB atau lebih kecil.

Menggunakan nama domain default API, URL (misalnya) WebSocket API dalam tahap tertentu (`{{{stageName}}}`) adalah dalam format berikut:

```
wss://{{{api-id}}}.execute-api.{{{region}}}.amazonaws.com/{{{stageName}}}
```

Untuk membuat URL WebSocket API lebih user-friendly, Anda dapat membuat nama domain kustom (misalnya,`api.example.com`) untuk mengganti nama host default API. Proses konfigurasi sama dengan REST APIs. Untuk informasi selengkapnya, lihat [Nama domain khusus untuk REST publik APIs di API Gateway](how-to-custom-domains.md).

Tahapan memungkinkan kontrol versi yang kuat dari API Anda. Misalnya, Anda dapat menerapkan API ke `test` stage dan `prod` stage, dan menggunakan `test` stage sebagai test build dan menggunakan `prod` stage sebagai build stabil. Setelah pembaruan lulus tes, Anda dapat mempromosikan `test` panggung ke `prod` panggung. Promosi dapat dilakukan dengan memindahkan API ke panggung. `prod` Untuk detail lebih lanjut tentang tahapan, lihat[Siapkan panggung untuk REST API di API Gateway](set-up-stages.md).

**Topics**
+ [Membuat penerapan WebSocket API menggunakan AWS CLI](#apigateway-create-websocket-deployment-using-awscli)
+ [Membuat penerapan WebSocket API menggunakan konsol API Gateway](#apigateway-create-websocket-deployment-using-console)

## Membuat penerapan WebSocket API menggunakan AWS CLI
<a name="apigateway-create-websocket-deployment-using-awscli"></a>

Perintah [create-deployment berikut membuat deployment](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-deployment.html):

```
aws apigatewayv2 --region us-east-1 create-deployment --api-id aabbccddee
```

Outputnya akan terlihat seperti berikut:

```
{
    "DeploymentId": "fedcba",
    "DeploymentStatus": "DEPLOYED",
    "CreatedDate": "2018-11-15T06:49:09Z"
}
```

API yang diterapkan tidak dapat dipanggil sampai Anda mengaitkan penerapan dengan tahapan. Anda dapat membuat tahap baru atau menggunakan kembali tahap yang telah Anda buat sebelumnya.

Perintah [create-stage](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-stage.html) berikut membuat tahap baru dan mengaitkannya dengan penerapan:

```
aws apigatewayv2 --region us-east-1 create-stage --api-id aabbccddee --deployment-id fedcba --stage-name test
```

Outputnya terlihat seperti berikut:

```
{
    "StageName": "test",
    "CreatedDate": "2018-11-15T06:50:28Z",
    "DeploymentId": "fedcba",
    "DefaultRouteSettings": {
        "MetricsEnabled": false,
        "ThrottlingBurstLimit": 5000,
        "DataTraceEnabled": false,
        "ThrottlingRateLimit": 10000.0
    },
    "LastUpdatedDate": "2018-11-15T06:50:28Z",
    "StageVariables": {},
    "RouteSettings": {}
}
```

Anda juga dapat menggunakan kembali tahap yang ada dengan memperbarui `deploymentId` properti stage dengan ID penerapan () {{deployment-id}} yang baru dibuat. Perintah [update-stage](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/update-stage.html) berikut memperbarui ID penyebaran tahap:

```
aws apigatewayv2 update-stage --region {{region}} \
    --api-id {{api-id}} \ 
    --stage-name {{stage-name}} \ 
    --deployment-id {{deployment-id}}
```

## Membuat penerapan WebSocket API menggunakan konsol API Gateway
<a name="apigateway-create-websocket-deployment-using-console"></a>

Untuk menggunakan konsol API Gateway untuk membuat penerapan WebSocket API:

1. Masuk ke konsol API Gateway dan pilih API.

1. Pilih **Deploy API**.

1. Pilih tahap yang diinginkan dari daftar dropdown atau masukkan nama tahap baru.