Penandaan pada sumber daya

Tag adalah label metadata khusus yang dapat Anda tambahkan ke sumber daya untuk membuatnya lebih mudah dalam melakukan identifikasi, pengelolaan, dan mencari di mencari. Tag terdiri dari dua bagian individu: Kunci tag dan nilai tag. Hal ini disebut sebagai key:value pair.

Kunci tag biasanya mewakili kategori yang lebih besar, sedangkan nilai tag mewakili subset dari kategori itu. Misalnya Anda bisa memiliki tag key=color dan tag value=Blue, yang akan menghasilkan key:value pairColor:Blue. Perhatikan bahwa Anda dapat mengatur nilai tag menjadi sebuah string kosong, tetapi Anda tidak dapat mengatur nilai tag menjadi nol. Mengabaikan nilai tag sama dengan menggunakan rangkaian kosong.

Tip

AWS Billing and Cost Managementdapat menggunakan tag untuk memisahkan tagihan Anda ke dalam kategori dinamis. Misalnya, jika Anda menambahkan tag untuk mewakili departemen yang berbeda dalam perusahaan Anda, sepertiDepartment:Sales atauDepartment:Legal,AWS dapat memberi Anda distribusi biaya per departemen.

Di Amazon Transcribe, Anda dapat menandai sumber daya berikut:

• Lowongan kerja Transcription

• Lowongan kerja Medical Transcription

• Panggilan pekerjaan transkripsi pasca panggilan Analytics

• Kosakata khusus

• Kosakata medis khusus

• Filter kosakata khusus

• Model bahasa khusus

Kunci tag dapat memiliki panjang hingga 128 karakter dan nilai tag dapat mencapai 256 karakter; keduanya peka huruf. Amazon Transcribemendukung 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 dimulaiaws: karenaAWS cadangan awalan ini untuk tag yang dihasilkan sistem. Anda tidak dapat menambah, memodifikasi, atau menghapusaws:* tag, dan tag tersebut tidak dihitung terhadap tags-per-resource batas Anda.

Operasi API khusus untuk penandaan sumber daya

ListTagsForResource, TagResource, UntagResource

Untuk menggunakan API penandaan, Anda harus menyertakan Amazon Resource Name (ARN) dengan permintaan Anda. ARN memiliki formatarn: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 pemberian tag, termasuk praktik terbaik, lihat MenandaiAWS sumber daya.

Kontrol akses berbasis tag

Anda dapat menggunakan tag untuk mengontrol akses di dalam melakukan identifikasi di dalam melakukan identifikasiAkun AWS. Untuk kontrol akses berbasis tanda, Anda memberikan informasi tag di elemen ketentuanIAM kebijakan. Anda kemudian dapat menggunakan tag dan kunci kondisi tag terkait untuk mengontrol akses ke:

• Sumber daya: Mengontrol akses keAmazon Transcribe sumber daya Anda berdasarkan tag yang telah Anda tetapkan ke sumber daya tersebut.

  • Gunakan kunciaws:ResourceTag/key-name ketentuan untuk menentukan pasangan kunci tanda mana yang harus dilampirkan ke sumber daya.

• Permintaan: Kontrol tag mana yang dapat diteruskan dalam permintaan.

  • Gunakan kunciaws:RequestTag/key-name ketentuan untuk menentukan tag mana yang dapat ditambahkan, diubah, atau dihapus dariIAM pengguna atau peran.

• Proses otorisasi: Kontrol akses berbasis tag untuk setiap bagian dari proses otorisasi Anda.

  • Gunakan kunciaws:TagKeys/ ketentuan untuk mengontrol apakah kunci tag tertentu dapat digunakan di sumber daya, dalam permintaan, atau oleh prinsipal. Dalam hal ini, nilai kunci tidak menjadi masalah.

Untuk contoh kebijakan kontrol akses berbasis tanda, lihatMelihat pekerjaan transkripsi berdasarkan tanda.

Untuk informasi selengkapnya tentang kontrol akses berbasis tag, lihat Mengontrol akses keAWS sumber daya menggunakan tag.

Menambahkan tag keAmazon Transcribe sumber daya Anda

Anda dapat menambahkan tag sebelum atau setelah Anda menjalankanAmazon Transcribe pekerjaan Anda. Dengan menggunakan API Create* dan Start* yang ada, Anda dapat menambahkan tag tambahan dengan permintaan transkripsi Anda.

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

AWS Management Console

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 rincian pekerjaan untuk menemukan Tag - kotak opsional dan pilih Tambahkan tag baru.

   

4. Masukkan informasi untuk bidang Kunci dan, secara opsional, bidang Nilai.

   

5. Isi kolom lain yang ingin Anda sertakan di halaman Tentukan detail pekerjaan, lalu pilih Berikutnya. Ini akan 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 ingin mengedit tag, Anda dapat melakukannya dengan memilih Kelolaan tag.

   

AWS CLI

Contoh ini menggunakan start-transcription-jobperintah danTags parameter. Untuk informasi selengkapnya, 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"
        }
  ]
}

AWS SDK for Python (Boto3)

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

Untuk contoh tambahan yang menggunakanAWS SDK, termasuk contoh spesifik-fitur, skenario, dan lintas-layanan, lihat bagianContoh kode untuk Amazon Transcribe menggunakan SDK AWS ini.

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)