Penandaan pada sumber daya - Amazon Transcribe

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 Billing and Cost Management 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 atauDepartment:Legal, AWS dapat memberi Anda distribusi biaya per departemen.

Masuk Amazon Transcribe, Anda dapat menandai sumber daya berikut:

  • Lowongan kerja transkripsi

  • Pekerjaan transkripsi medis

  • Kosakata khusus

  • Kosakata medis khusus

  • Filter kosakata khusus

  • 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.

APIoperasi khusus untuk penandaan sumber daya

ListTagsForResource, TagResource, UntagResource

Untuk menggunakan penandaanAPIs, Anda harus menyertakan Amazon Resource Name (ARN) dengan permintaan Anda. ARNsmemiliki formatnyaarn:partition:service:region:account-id:resource-type/resource-id. Misalnya, pekerjaan transkripsi yang ARN terkait 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 AWS sumber daya.

Kontrol akses berbasis tag

Anda dapat menggunakan tag untuk mengontrol akses dalam 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 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, lihatMelihat pekerjaan transkripsi berdasarkan tag.

Untuk informasi lebih lanjut tentang kontrol akses berbasis tag, lihat Mengontrol akses ke AWS sumber daya menggunakan tag.

Menambahkan tag ke Amazon Transcribe sumber daya

Anda dapat menambahkan tag sebelum atau setelah Anda menjalankan Amazon Transcribe pekerjaan. Menggunakan Create* dan Start* yang adaAPIs, Anda dapat menambahkan tag tambahan dengan permintaan transkripsi Anda.

Anda dapat menambahkan, memodifikasi, atau menghapus tag menggunakan AWS Management Console, AWS CLI, atau AWS SDKs; lihat contoh berikut:

  1. Masuk ke AWS Management Console.

  2. Di panel navigasi, pilih Pekerjaan transkripsi, lalu pilih Buat pekerjaan (kanan atas). Ini membuka halaman Tentukan detail pekerjaan.

  3. 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'.
  4. Masukkan informasi untuk bidang Kunci dan, secara opsional, bidang Nilai.

    Amazon Transcribe tangkapan layar konsol: panel 'tag', menampilkan contoh tag.
  5. 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.

  6. 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.

Contoh ini menggunakan start-transcription-jobperintah dan Tags parameter. Untuk informasi selengkapnya, silakan lihat StartTranscriptionJob dan Tag.

aws transcribe start-transcription-job \ --region us-west-2 \ --transcription-job-name my-first-transcription-job \ --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \ --output-bucket-name DOC-EXAMPLE-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-jobperintah, 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://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac" }, "OutputBucketName": "DOC-EXAMPLE-BUCKET", "OutputKey": "my-output-files/", "LanguageCode": "en-US", "Tags": [ { "Key": "color", "Value": "blue" }, { "Key": "shape", "Value": "square" } ] }

Contoh berikut menggunakan AWS SDK for Python (Boto3) untuk menambahkan tag dengan menggunakan Tags argumen untuk metode start_transcription_job. Untuk informasi selengkapnya, silakan lihat StartTranscriptionJob dan Tag.

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

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://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac" transcribe.start_transcription_job( TranscriptionJobName = job_name, Media = { 'MediaFileUri': job_uri }, OutputBucketName = 'DOC-EXAMPLE-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)