翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# リソースのタグ付け
タグ は、リソースに追加して識別、整理、検索を容易にするための、カスタムなメタデータラベルです。各タグは、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:*` タグを追加、変更、削除することはできません。このタグは、リソースあたりの上限タグ数のためのカウントに含まれません。
**リソースのタグ付けに固有の API オペレーション**
[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)
タグ付け 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 リソースのタグ付け」](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) を参照してください。
## タグベースのアクセス制御
タグを使用して、AWS アカウント 内でのアクセスを制御できます。タグベースのアクセス制御に対して、IAM ポリシーの条件要素でタグ情報を提供します。次に、タグおよび関連付けられたタグ条件キーを使用して、以下へのアクセスを制御できます。
+ **リソース**: Amazon Transcribe リソースへのアクセスは、リソースに割り当てたタグに基づいて制御します。
+ `aws:ResourceTag/key-name` 条件キーを使用して、リソースにアタッチする必要があるタグキーの値のペアを指定します。
+ **リクエスト:** リクエストで渡すことができるタグを制御します。
+ `aws:RequestTag/key-name` 条件キーを使用して、IAM ユーザーまたはロールに対して追加、変更、または削除できるタグを指定します。
+ **認可プロセス:** 認可プロセスのどの部分でも、タグベースのアクセスを制御できます。
+ `aws:TagKeys/` 条件キーを使用して、リソースまたはリクエストで、またはプリンシパルによって特定のタグキーを使用できるかどうかを制御します。この場合、キーバリューは重要ではありません。
タグベースのアクセスコントロールポリシーの例については、「[タグに基づく文字起こしジョブの表示](security_iam_id-based-policy-examples.md#tagging-transcription-policy)」を参照してください。
タグベースのアクセス制御の詳細については、[「タグを使用した AWS リソースへのアクセスの制御」](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) を参照してください。
## Amazon Transcribe リソースにタグを追加する
Amazon Transcribe ジョブの実行前または実行後にタグを追加できます。既存の**作成 \$1** と **開始 \$1** の API を使用すると、文字起こしリクエストにタグを追加できます。
**AWS マネジメントコンソール**、**AWS CLI**、または **AWS SDK** を使用してタグの追加、変更、または削除を行うことができます。例については、次を参照してください。
### AWS マネジメントコンソール
1. [AWS マネジメントコンソール](https://console.aws.amazon.com/transcribe/) にサインインします。
1. ナビゲーションペインで、[**文字起こしジョブ**] を選択後、[**ジョブの作成**] (右上) を選択します。これにより、「**ジョブの詳細を指定**」ページが開きます。
1. **ジョブの詳細を指定**ページの下部までスクロールして、**タグ - *オプション***ボックスを見つけたら、[**新しいタグを追加**] を選択します。
![\[Amazon Transcribe コンソールのスクリーンショット:「ジョブの詳細を指定」ページ。\]](http://docs.aws.amazon.com/ja_jp/transcribe/latest/dg/images/add-new-tag.png)
1. **キー** フィールドと、オプションで **値** フィールドに情報を入力します。
![\[Amazon Transcribe コンソールのスクリーンショット: タグの例が表示されている「タグ」パネル。\]](http://docs.aws.amazon.com/ja_jp/transcribe/latest/dg/images/add-new-tag-color.png)
1. **ジョブの詳細を指定**ページに追加したいその他のフィールドに入力し、[**次へ**] を選択します。これにより、**ジョブの設定 - *オプション*ページ**へ移動します。
[**ジョブの作成**] を選択して、文字起こしジョブを実行します。
1. **文字起こしジョブ**ページに移動して変換ジョブに関連付けられたタグを表示できますので、変換ジョブを選択し、そのジョブの情報ページの一番下までスクロールします。タグを編集したい場合は、[**タグの管理**] を選択します。
![\[Amazon Transcribe コンソールのスクリーンショット: 文字起こしジョブの情報ページの「タグ」パネル。\]](http://docs.aws.amazon.com/ja_jp/transcribe/latest/dg/images/view-tags.png)
### AWS CLI
この例では、[start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) コマンドと `Tags` パラメータを使用します。詳細については、「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)」および「[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
```
別の例として、[変換ジョブの開始](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) コマンド、およびそのジョブにタグを追加するリクエスト本文を使用します。
```
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://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 for Python (Boto3)
次の例では、[transstart\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) メソッドの AWS SDK for Python (Boto3) 引数で、`Tags` を使用してタグを追加します。詳細については、「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)」および「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Tag.html)」を参照してください。
特徴固有の例、シナリオ例、クロスサービスの例など、AWS SDK を使用するその他の例については、[SDK を使用した Amazon Transcribe のコード例 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)
```