リソースのタグ付け - Amazon Transcribe
タグベースのアクセスコントロールAmazon Transcribeリソースにタグを追加する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

リソースのタグ付け

タグは、リソースに追加して識別、整理、検索を容易にするための、カスタムなメタデータラベルです。各タグは、2 つの部分 (タグキーとタグ値) で構成されます。これは、キーと値のペアと呼ばれます。

通常、タグキー はカテゴリの大枠を表し、タグ値 はそのカテゴリのサブセットを表します。例えば、タグキー = Color そしてタグ値 = Blueとすると、キーと値のペアとしては Color:Blue が構成されます。タグの値を空の文字列に設定することはできますが、タグの値を null には設定できないことに注意してください。タグ値を省略すると、空の文字列を使用した場合と同じになります。

ヒント

AWS Billing and Cost Management では、、請求書を動的なカテゴリで分割するためにタグを利用できます。例えば、会社内のさまざまな部門を表すタグ (Department:Sales または Department:Legal など) を追加することで、AWS が部門ごとのコスト配分を提供できるようになります。

Amazon Transcribe では、以下のリソースにタグを付けることができます。

  • 変換ジョブ

  • 医学会話変換ジョブ

  • 通話分析通話後の文字起こし求人

  • カスタム語彙

  • カスタムな医療ボキャブラリー

  • カスタム語彙フィルター

  • カスタム言語モデル

タグキーには最大 128 文字、タグ値には最大 256 文字を使用でき、どちらも大文字と小文字が区別されます。 Amazon Transcribeリソースごとに最大 50 個のタグがサポートされます。リソースごとに、各タグキーは一意である必要があり、1 つの値のみを与えることができます。注意 : ユーザーは、タグを aws: で始めることはできません。このプレフィックスは、AWS によりシステム生成タグ用に予約されています。タグを追加、変更、削除することはできません。aws:*このタグは、 tags-per-resource 上限タグの数のためのカウントに含まれません。

リソースのタグ付けに固有の API オペレーション

ListTagsForResource, TagResource, UntagResource

タグ付け API を使用するには、Amazon リソースネーム (ARN) をリクエストに含める必要があります。ARN は arn:partition:service:region:account-id:resource-type/resource-id という形式です。たとえば、変換ジョブに関連付けられた ARN は arn:aws:transcribe:us-west-2:111122223333:transcription-job/my-transcription-job-name のようになります。

タグ付けのベストプラクティスに関するその他情報については、「AWS リソースのタグ付け」 を参照してください。

タグベースのアクセスコントロール

タグを使用して、内部のアクセスを制御することができますAWS アカウント。タグベースのアクセス制御に対して、IAMポリシーの条件要素でタグ情報を提供します。次に、タグおよび関連付けられたタグ条件キーを使用して、以下へのアクセスを制御できます。

  • リソース:リソースへのアクセスは、Amazon Transcribeリソースに割り当てたタグに基づいて制御します。

    • aws:ResourceTag/key-name 条件キーを使用して、リソースにアタッチする必要があるタグキーの値のペアを指定します。

  • リクエスト: リクエストで渡すことができるタグを制御します。

    • aws:RequestTag/key-name条件キーを使用して、IAMユーザーまたはロールで追加、変更、または削除できるタグを指定します。

  • 認証プロセス: 認証プロセスのどの部分でも、タグベースのアクセスを制御できます。

    • aws:TagKeys/ 条件キーを使用して、リソースまたはリクエストで、またはプリンシパルによって特定のタグキーを使用できるかどうかを制御します。この場合、キーバリューは重要ではありません。

タグベースのアクセスコントロールポリシーの例については、「」を参照してくださいタグに基づく字起こしジョブの表示。

タグベースのアクセス制御の詳細については、「タグを使用した AWS リソースへのアクセスの制御」 を参照してください。

Amazon Transcribeリソースにタグを追加する

Amazon Transcribeジョブの実行前または実行後にタグを追加できます。既存の Create* および Start* API を使用して、文字起こしリクエストにタグを追加できます。

、、または AWSSDK を使用してタグを追加AWS Management Console、変更AWS CLI、または削除できます。例については、以下を参照してください。

  1. AWS Management Consoleにサインインします。

  2. ナビゲーションペインで、変換ジョブを選択後、ジョブの作成 (右上) を選択します。これにより、ジョブの詳細を指定 ページが開きます。

  3. [ジョブ詳細の指定] ページの一番下までスクロールして [タグ-オプション] ボックスを見つけ、[新しいタグを追加] を選択します。

    Amazon Transcribeコンソールのスクリーンショット:「ジョブの詳細を指定」ページ

  4. キー フィールドと、オプションで 値 フィールドに情報を入力します。

    Amazon Transcribeコンソールのスクリーンショット:タグの例を示す「タグ」パネル。

  5. ジョブの詳細を指定ページで追加したい他のフィールドに入力後、次を選択します。これにより、ジョブの設定 : オプション ページ へ移動します。

    ジョブの作成を選択して、変換ジョブを実行します。

  6. 変換ジョブ ページに移動して変換ジョブに関連付けられたタグを表示できますので、変換ジョブを選択し、そのジョブの情報ページの一番下までスクロールします。タグを編集したい場合は、タグの管理を選択すると編集できます。

    Amazon Transcribeコンソールのスクリーンショット:文字起こしジョブの情報ページの「タグ」パネル

この例では、start-transcription-jobTagsコマンドとパラメータを使用しています。詳細については、StartTranscriptionJobおよび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

別の例として、start-transcription-jobコマンド、およびそのジョブにタグを追加するリクエスト本文を使用します。

aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://filepath/my-first-tagging-job.json

ファイル my-first-tagging-job.json に次のリクエストボディが入ります。

{
  "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"
        }
  ]
}

次の例では、transstart_transcription_job メソッドの AWS SDK for Python (Boto3) 引数で、Tags を使用してタグを追加します。詳細については、StartTranscriptionJobおよびTagを参照してください。

機能固有、シナリオ、サービス間の例など、AWS SDK を使用するその他の例については、SDK を使用した Amazon Transcribe のコード例 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)