Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menyiapkan tag untuk tahap API di API Gateway
Di API Gateway, Anda dapat menambahkan tag ke tahap API, menghapus tag dari tahap, atau melihat tag. Untuk melakukannya, Anda dapat menggunakan konsol API Gateway, AWS CLI/SDK, atau API Gateway REST API.
Sebuah panggung juga dapat mewarisi tag dari REST API induknya. Untuk informasi selengkapnya, lihat [Warisan tag di Amazon API Gateway V1](apigateway-tagging-supported-resources.md#apigateway-tagging-inheritance).
Untuk informasi selengkapnya tentang menandai resource API Gateway, lihat[Menandai sumber daya API Gateway Anda](apigateway-tagging.md).
**Topics**
+ [Menyiapkan tag untuk tahap API menggunakan konsol API Gateway](#set-up-tags-using-console)
+ [Menyiapkan tag untuk tahap API menggunakan AWS CLI](#set-up-tags-using-cli)
+ [Menyiapkan tag untuk tahap API menggunakan API Gateway REST API](#set-up-tags-using-api)
## Menyiapkan tag untuk tahap API menggunakan konsol API Gateway
Prosedur berikut menjelaskan cara menyiapkan tag untuk tahap API.
**Untuk menyiapkan tag untuk tahap API dengan menggunakan konsol API Gateway**
1. Masuk ke konsol API Gateway.
1. Pilih API yang sudah ada, atau buat API baru yang menyertakan sumber daya, metode, dan integrasi terkait.
1. Pilih tahapan atau terapkan API ke tahap baru.
1. Di panel navigasi utama, pilih **Tahapan**.
1. Pilih tab **Tanda**. Anda mungkin perlu memilih tombol panah kanan untuk menampilkan tab.
1. Pilih **Kelola tanda**.
1. Di **Editor Tag**, pilih **Tambahkan tag**. Masukkan kunci tag (misalnya,`Department`) di bidang **Kunci**, dan masukkan nilai tag (misalnya,`Sales`) di bidang **Nilai**. Pilih **Simpan** untuk menyimpan tag.
1. Jika perlu, ulangi langkah 5 untuk menambahkan lebih banyak tag ke tahap API. Jumlah maksimum tag per tahap adalah 50.
1. Untuk menghapus tag yang ada dari panggung, pilih **Hapus**.
1. Jika API telah digunakan sebelumnya di konsol API Gateway, Anda perlu menerapkannya kembali agar perubahan diterapkan.
## Menyiapkan tag untuk tahap API menggunakan AWS CLI
[Anda dapat mengatur tag untuk tahap API menggunakan perintah menggunakan perintah [create-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-stage.html) atau perintah tag-resource. AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/apigateway/tag-resource.html) Anda dapat menghapus satu atau beberapa tag dari tahap API menggunakan perintah [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/untag-resource.html).
Perintah [create-stage](https://docs.aws.amazon.com/cli/latest/reference/apigateway/create-stage.html) berikut menambahkan tag saat membuat panggung: `test`
```
aws apigateway create-stage --rest-api-id abc1234 --stage-name test --description 'Testing stage' --deployment-id efg456 --tag Department=Sales
```
Perintah [tag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/tag-resource.html) berikut menambahkan tag ke panggung: `prod`
```
aws apigateway tag-resource --resource-arn arn:aws:apigateway:us-east-2::/restapis/abc123/stages/prod --tags Department=Sales
```
Perintah [untag-resource](https://docs.aws.amazon.com/cli/latest/reference/apigateway/untag-resource.html) berikut menghapus `Department=Sales` tag dari panggung: `test`
```
aws apigateway untag-resource --resource-arn arn:aws:apigateway:us-east-2::/restapis/abc123/stages/test --tag-keys Department
```
## Menyiapkan tag untuk tahap API menggunakan API Gateway REST API
Anda dapat menyiapkan tag untuk tahap API menggunakan API Gateway REST API dengan melakukan salah satu hal berikut:
+ Panggilan [https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html)untuk menandai tahap API.
+ Panggilan [https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html)untuk menghapus satu atau beberapa tag dari tahap API.
+ Panggil [https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html)untuk menambahkan satu atau beberapa tag ke tahap API yang Anda buat.
Anda juga dapat menelepon [https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html](https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html)untuk mendeskripsikan tag dalam tahap API.
### Menandai tahap API
Setelah Anda menerapkan API (`m5zr3vnks7`) ke stage (`test`), beri tag stage dengan memanggil [https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_TagResource.html). Tahap yang diperlukan Nama Sumber Daya Amazon (ARN) (`arn:aws:apigateway:us-east-1::/restapis/m5zr3vnks7/stages/test`) harus dikodekan URL (). `arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest`
```
PUT /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest
{
"tags" : {
"Department" : "Sales"
}
}
```
Anda juga dapat menggunakan permintaan sebelumnya untuk memperbarui tag yang ada ke nilai baru.
Anda dapat menambahkan tag ke panggung saat memanggil [https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html](https://docs.aws.amazon.com/apigateway/latest/api/API_CreateStage.html)untuk membuat panggung:
```
POST /restapis//stages
{
"stageName" : "test",
"deploymentId" : "adr134",
"description" : "test deployment",
"cacheClusterEnabled" : "true",
"cacheClusterSize" : "500",
"variables" : {
"sv1" : "val1"
},
"documentationVersion" : "test",
"tags" : {
"Department" : "Sales",
"Division" : "Retail"
}
}
```
### Membatalkan tag tahap API
Untuk menghapus `Department` tag dari panggung, hubungi [https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html](https://docs.aws.amazon.com/apigateway/latest/api/API_UntagResource.html):
```
DELETE /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftest?tagKeys=Department
Host: apigateway.us-east-1.amazonaws.com
Authorization: ...
```
Untuk menghapus lebih dari satu tag, gunakan daftar kunci tag yang dipisahkan koma dalam ekspresi kueri—misalnya,. `?tagKeys=Department,Division,…`
### Jelaskan tag untuk tahap API
Untuk mendeskripsikan tag yang ada pada tahap tertentu, panggil [https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html](https://docs.aws.amazon.com/apigateway/latest/api/API_GetTags.html):
```
GET /tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags
Host: apigateway.us-east-1.amazonaws.com
Authorization: ...
```
Respons yang berhasil mirip dengan yang berikut:
```
200 OK
{
"_links": {
"curies": {
"href": "http://docs.aws.amazon.com/apigateway/latest/developerguide/restapi-tags-{rel}.html",
"name": "tags",
"templated": true
},
"tags:tag": {
"href": "/tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags"
},
"tags:untag": {
"href": "/tags/arn%3Aaws%3Aapigateway%3Aus-east-1%3A%3A%2Frestapis%2Fm5zr3vnks7%2Fstages%2Ftags{?tagKeys}",
"templated": true
}
},
"tags": {
"Department": "Sales"
}
}
```