为 资源添加标签 - Amazon Transcribe
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

为 资源添加标签

一个标签是自定义的元数据标签,您可以将其添加到资源以便更轻松地确定、组织和在搜索中查找。标签由两个单独的部分组成:标签键和标签值。这被称为 key: 值对。

一个标签键通常代表较大的类别,而标签值代表该类别的一个子集。例如你可以有标签键 = 颜色标签 value = 蓝色,这会生成键:值对Color:Blue. 请注意,您可以将标签的值设为空的字符串,但是不能将其设为空值。省略标签值与使用空字符串相同。

提示

Amazon账单可以使用标签将账单分成动态类别。例如,如果您添加标签来表示公司内的不同部门,例如Department:Sales要么Department:Legal、Amazon可以为您提供每个部门的成本分配。

在 Amazon Transcribe 中,您可以为以下资源添加标签:

  • 转录作业

  • 医疗转录作业

  • 词汇表

  • 医疗词汇表

  • 词汇表筛选条件

  • 自定义语言模型

标签键的长度最大可以为 128 个字符,标签值的长度最大可以为 256 个字符;两者都区分大小写。Amazon Transcribe 支持每个资源最多 50 个标签。对于给定资源,每个标签键都必须是唯一的,只有一个值。请注意,你的标签不能以aws:因为Amazon为系统生成的标签保留此前缀。您无法添加、修改或删除aws:*标签,它们不计入每个资源的标签数限制。

特定于资源标记的 API 操作

ListTagsForResourceTagResourceUntagResource

要使用标记 API,您需要在请求中包含 Amazon 资源名称 (ARN)。ARN 的格式为arn:partition:service:region:account-id:resource-type/resource-id. 例如,与转录作业关联的 ARN 可能如下所示:arn:aws:transcribe:us-east-1:account-id:transcription-job/job-name.

要了解有关标记(包括最佳做法)的更多信息,请参阅标记Amazon资源.

基于标签的访问控制

您可以在自己的内部使用标签控制访问Amazon账户。对于基于标签的访问控制,您可以在 IAM 策略的条件元素中提供标签信息。您可以使用标签及其关联的标签条件键来控制对以下内容的访问:

  • 资源: 根据您为 Amazon Transcribe 资源分配的标签控制对这些资源的访问。

    • 使用aws:ResourceTag/key-name条件键来指定必须将哪个标签键:值对附加到资源。

  • 请求: 控制可以在请求中传递哪些标签。

    • 使用aws:RequestTag/key-name条件键,指定可在 IAM 用户或角色中添加、修改或删除哪些标签。

  • 授权流程:控制授权过程中任何部分的基于标签的访问权限。

    • 使用aws:TagKeys/条件键来控制是否可以对资源、请求或委托人使用特定的标签键。在这种情况下,键值无关紧要。

有关基于标记的访问控制的更多详细信息,请参阅控制对 的访问Amazon使用标签的资源.

为您的 Amazon Transcribe 资源添加标签

您可以在运行 Amazon Transcribe 作业之前或之后添加标签。现有的Create*启动 *API 允许您在转录作业中添加标签。

您可以使用添加、修改或删除标签。Amazon Transcribe 控制台AmazonCLI,或者Amazon开发工具包;有关示例,请参阅以下内容:

  1. 登录到Amazon Transcribe 控制台.

  2. 在导航窗格中,选择转录作业,然后选择创建作业按钮(右上角)。这会打开指定作业细节页.

  3. 滚动到底部。指定作业细节页面以查找标签-可选的框然后单击添加新标签按钮。

  4. 输入以下信息:密钥字段以及(可选)字段中返回的子位置类型。

  5. 填写您希望包含在指定作业细节页面,然后单击下一步按钮。这会将您带到配置作业-可选的页.

    单击创建作业按钮以运行转录作业。

  6. 您可以通过导航到与转录作业关联的标签。转录作业页面,选择转录作业,然后滚动到该作业信息页面的底部。如果你想编辑标签,可以通过单击管理标签按钮。

此示例使用开始转录-工作命令和Tags参数。有关更多信息,请参阅StartTranscriptionJobTag

aws transcribe start-transcription-job \ --transcription-job-name job-name --media MediaFileUri=s3://your-S3-bucket/S3-prefix/your-filename.file-extension \ --language-code en-US \ --tags Key=color,Value=blue

这是另一个使用开始转录-工作命令,以及向该作业添加标签的请求正文。

aws transcribe start-transcription-job \ --cli-input-json file://filepath/example-start-command.json

该文件示例启动命令 .json包含以下请求正文。

{ "TranscriptionJobName": "job-name", "LanguageCode": "en-US", "Media": { "MediaFileUri": "s3://your-S3-bucket/S3-prefix/your-filename.file-extension" }, "Tags": [ {"Key": "string","Value": "string"} ] }

以下示例使用Amazon SDK for Python (Boto3)使用添加标签Tags参数start_Trancription_job方法。有关更多信息,请参阅 StartTranscriptionJobTag

from __future__ import print_function import time import boto3 transcribe = boto3.client('transcribe') job_name = "job-name" job_uri = "s3://your-S3-bucket/S3-prefix/your-filename.file-extension" transcribe.start_transcription_job( TranscriptionJobName=job_name, Media={'MediaFileUri': job_uri}, MediaFormat='wav', LanguageCode='en-US', Tags=[{'Key':'string', 'Value':'string'}] ) 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)