Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Penandaan pada sumber daya
Tag adalah label metadata kustom yang dapat Anda tambahkan ke sumber daya agar lebih mudah mengidentifikasi, mengatur, dan menemukan dalam pencarian. Tag terdiri dari dua bagian individual: Kunci tag dan nilai tag. Ini disebut sebagai pasangan key:value.
Kunci tag biasanya mewakili kategori yang lebih besar, sedangkan nilai tag mewakili subset dari kategori tersebut. Misalnya Anda dapat memiliki *tag key=color dan *tag value=blue**, yang akan menghasilkan pasangan key:value. `Color:Blue` Perhatikan bahwa Anda dapat mengatur nilai tag ke string kosong, tetapi Anda tidak dapat mengatur nilai tag ke null. Mengabaikan nilai tag sama dengan menggunakan sebuah string kosong.
**Tip**
AWS Manajemen Penagihan dan Biaya dapat menggunakan tag untuk memisahkan tagihan Anda ke dalam kategori dinamis. Misalnya, jika Anda menambahkan tag untuk mewakili departemen yang berbeda dalam perusahaan Anda, seperti `Department:Sales` atau`Department:Legal`, AWS dapat memberi Anda distribusi biaya per departemen.
Di Amazon Transcribe, Anda dapat menandai sumber daya berikut:
+ Lowongan kerja transkripsi
+ Pekerjaan transkripsi medis
+ Pekerjaan transkripsi panggilan analitik panggilan panggilan
+ Kosakata khusus
+ Kosakata medis khusus
+ Filter kosakata khusus
+ Kategori analitik panggilan
+ Model bahasa khusus
Tombol tag dapat memiliki panjang hingga 128 karakter dan nilai tag dapat mencapai 256 karakter; keduanya peka huruf besar/kecil. Amazon Transcribe mendukung hingga 50 tag per sumber daya. Untuk sumber daya tertentu, setiap kunci tag harus unik dengan hanya satu nilai. Perhatikan bahwa tag Anda tidak dapat dimulai `aws:` karena AWS menyimpan awalan ini untuk tag yang dihasilkan sistem. Anda tidak dapat menambahkan, memodifikasi, atau menghapus `aws:*` tag, dan mereka tidak dihitung terhadap tags-per-resource batas Anda.
**Operasi API khusus untuk penandaan sumber daya**
[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListTagsForResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TagResource.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UntagResource.html)
Untuk menggunakan penandaan APIs, Anda harus menyertakan Nama Sumber Daya Amazon (ARN) dengan permintaan Anda. ARNs memiliki formatnya`arn:partition:service:region:account-id:resource-type/resource-id`. Misalnya, ARN yang terkait dengan pekerjaan transkripsi mungkin terlihat seperti:. `arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name`
Untuk mempelajari lebih lanjut tentang penandaan, termasuk praktik terbaik, lihat [Menandai sumber daya AWS](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html).
## Kontrol akses berbasis tag
Anda dapat menggunakan tag untuk mengontrol akses di dalam Anda Akun AWS. Untuk kontrol akses berbasis tag, Anda memberikan informasi tag dalam elemen kondisi IAM kebijakan. Anda kemudian dapat menggunakan tag dan kunci kondisi tag terkait untuk mengontrol akses ke:
+ **Sumber Daya:** Kontrol akses ke Amazon Transcribe sumber daya Anda berdasarkan tag yang telah Anda tetapkan ke sumber daya tersebut.
+ Gunakan tombol `aws:ResourceTag/key-name` kondisi untuk menentukan pasangan kunci tag: nilai mana yang harus dilampirkan ke sumber daya.
+ **Permintaan:** Kontrol tag mana yang dapat diteruskan dalam permintaan.
+ Gunakan tombol `aws:RequestTag/key-name` kondisi untuk menentukan tag mana yang dapat ditambahkan, dimodifikasi, atau dihapus dari IAM pengguna atau peran.
+ **Proses otorisasi:** Kontrol akses berbasis tag untuk bagian mana pun dari proses otorisasi Anda.
+ Gunakan tombol `aws:TagKeys/` kondisi untuk mengontrol apakah kunci tag tertentu dapat digunakan pada sumber daya, permintaan, atau oleh prinsipal. Dalam hal ini, nilai kunci tidak masalah.
Untuk contoh kebijakan kontrol akses berbasis tag, lihat[Melihat pekerjaan transkripsi berdasarkan tag](security_iam_id-based-policy-examples.md#tagging-transcription-policy).
Untuk informasi lebih rinci tentang kontrol akses berbasis tag, lihat [Mengontrol akses ke AWS sumber daya menggunakan tag](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html).
## Menambahkan tag ke Amazon Transcribe sumber daya Anda
Anda dapat menambahkan tag sebelum atau setelah Anda menjalankan Amazon Transcribe pekerjaan Anda. Menggunakan **Create\$1 dan **Start\$1**** yang ada APIs, Anda dapat menambahkan tag tambahan dengan permintaan transkripsi Anda.
Anda dapat menambahkan, memodifikasi, atau menghapus tag menggunakan **Konsol Manajemen AWS**AWS CLI****,, atau **AWS SDKs**; lihat contoh berikut:
### Konsol Manajemen AWS
1. Masuk ke [Konsol Manajemen AWS](https://console.aws.amazon.com/transcribe/).
1. Di panel navigasi, pilih **Pekerjaan transkripsi**, lalu pilih **Buat pekerjaan** (kanan atas). Ini membuka halaman **Tentukan detail pekerjaan**.
1. Gulir ke bagian bawah halaman **Tentukan detail pekerjaan** untuk menemukan **Tag - kotak *opsional*** dan pilih **Tambahkan tag baru**.
![\[Amazon Transcribe tangkapan layar konsol: halaman 'tentukan detail pekerjaan'.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/add-new-tag.png)
1. Masukkan informasi untuk bidang **Kunci** dan, secara opsional, bidang **Nilai**.
![\[Amazon Transcribe tangkapan layar konsol: panel 'tag', menampilkan contoh tag.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/add-new-tag-color.png)
1. Isi kolom lain yang ingin Anda sertakan di halaman **Tentukan detail pekerjaan**, lalu pilih **Berikutnya**. Ini membawa Anda ke **halaman Konfigurasi pekerjaan - *opsional*.**
Pilih **Buat pekerjaan** untuk menjalankan pekerjaan transkripsi Anda.
1. Anda dapat melihat tag yang terkait dengan pekerjaan transkripsi dengan menavigasi ke halaman **pekerjaan Transkripsi, memilih pekerjaan** transkripsi, dan menggulir ke bagian bawah halaman informasi pekerjaan itu. Jika Anda ingin mengedit tag Anda, Anda dapat melakukannya dengan memilih **Kelola tag**.
![\[Amazon Transcribe tangkapan layar konsol: panel 'tag' di halaman informasi pekerjaan transkripsi.\]](http://docs.aws.amazon.com/id_id/transcribe/latest/dg/images/view-tags.png)
### AWS CLI
Contoh ini menggunakan [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)perintah dan `Tags` parameter. Untuk informasi selengkapnya, silakan lihat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) dan [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-bucket-name amzn-s3-demo-bucket \
--output-key my-output-files/ \
--language-code en-US \
--tags Key=color,Value=blue Key=shape,Value=square
```
Berikut contoh lain menggunakan [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)perintah, dan badan permintaan yang menambahkan tag ke pekerjaan itu.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json
```
File *my-first-tagging-job.json* berisi badan permintaan berikut.
```
{
"TranscriptionJobName": "my-first-transcription-job",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"OutputBucketName": "amzn-s3-demo-bucket",
"OutputKey": "my-output-files/",
"LanguageCode": "en-US",
"Tags": [
{
"Key": "color",
"Value": "blue"
},
{
"Key": "shape",
"Value": "square"
}
]
}
```
### AWS SDK untuk Python (Boto3)
Contoh berikut menggunakan AWS SDK untuk Python (Boto3) untuk menambahkan tag dengan menggunakan `Tags` argumen untuk metode [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Untuk informasi selengkapnya, silakan lihat [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) dan [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html).
Untuk contoh tambahan menggunakan AWS SDKs, termasuk contoh khusus fitur, skenario, dan lintas layanan, lihat bagian ini. [Contoh kode untuk Amazon Transcribe menggunakan AWS SDKs](service_code_examples.md)
```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
TranscriptionJobName = job_name,
Media = {
'MediaFileUri': job_uri
},
OutputBucketName = 'amzn-s3-demo-bucket',
OutputKey = 'my-output-files/',
LanguageCode = 'en-US',
Tags = [
{
'Key':'color',
'Value':'blue'
}
]
)
while True:
status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
break
print("Not ready yet...")
time.sleep(5)
print(status)
```