StartMedicalTranscriptionJob

标记所有在笔录中识别的个人健康信息 (PHI)。有关更多信息，请参阅识别转录中的个人健康信息 (PHI)。

类型：字符串

有效值: PHI

必需：否

由纯文本、非机密键:值对（称为加密上下文对）组成的映射，可为您的数据提供额外的安全保护。有关更多信息，请参阅中的Amazon KMS加密上下文和非对称密钥Amazon KMS。

类型：字符串到字符串映射

映射条目：最多 10 项项项项项项项项项项项

密钥长度限制：最小长度为 1。最大长度200项。

密钥模式：.*\S.*

值长度限制：最小长度为 1。最大长度200项。

价值模式：.*\S.*

必需：否

表示输入媒体文件中所说语言的语言代码。美国英语 (en-US) 是医学转录工作的唯一有效值。为语言代码输入的任何其他值都会导致BadRequestException错误。

类型：字符串

有效值: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

必需：是

描述您要在请求中使用的媒体文件的 Amazon S3 位置。

有关支持的媒体格式的信息，请参阅 Amazon S3 开发者指南中的MediaFormat参数或媒体格式部分。

类型：Media 对象

必需：是

指定输入媒体文件的格式。

类型：字符串

有效值: mp3 | mp4 | wav | flac | ogg | amr | webm

必需：否

输入媒体文件中音轨的采样率，以赫兹为单位。

如果您未指定媒体采样率，则由Amazon Transcribe Medical 为您确定。如果您指定采样率，则它必须与 Amazon Transcribe Medical 检测到的速率相匹配；如果您指定的值与检测到的值不匹配，则您的任务将失败。因此，在大多数情况下，建议省略MediaSampleRateHertz采样率，让Amazon Transcribe ical 确定采样率。

类型：整数

有效范围：最小值为 16000 项。最大值为 48000 项。

必需：否

由您为医学转录工作选择的唯一名称。您指定的名称也用作转录输出文件的默认名称。如果要为转录输出指定不同的名称，请使用OutputKey参数。

此名称区分大小写，不能包含空格，并且在内必须是唯一的Amazon Web Services 账户。如果您尝试创建与现有任务具有相同的名称，则遇到了ConflictException错误。

类型：字符串

长度限制：最小长度为 1。最大长度为 200。

模式：^[0-9a-zA-Z._-]+

必需：是

您想要用于存储医疗转录输出的 Amazon S3 存储桶的名称。请勿包含指定存储段S3://的前缀。

如果您希望输出到此存储段的子文件夹，请使用OutputKey参数进行指定；OutputBucketName仅接受存储段的名称。

例如，如果您希望将输出存储在S3://DOC-EXAMPLE-BUCKET，请将设置OutputBucketName为DOC-EXAMPLE-BUCKET。但是，如果您希望将输出存储在S3://DOC-EXAMPLE-BUCKET/test-files/，请将设置OutputBucketNameOutputKey为DOC-EXAMPLE-BUCKET和为test-files/。

请注意，Amazon Transcribe 必须拥有使用指定位置的权限。您可以使用更改 Amazon S3 权限Amazon Web Services Management Console。另请参阅 IAM 用户角色所需的权限。

类型：字符串

长度限制：最大长度64 项。

模式：[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]

必需：是

您想要用于加密医疗转录输出的 KMS 密钥。

如果使用当前Amazon Web Services 账户密钥，则可以通过以下四种方式之一指定 KMS 密钥：

如果使用的密钥与当前密钥Amazon Web Services 账户不同Amazon Web Services 账户，则可以通过以下两种方式之一指定 KMS 密钥：

如果您未指定加密密钥，则使用默认 Amazon S3 key (SSE-S3) 加密输出。

如果您指定 KMS 密钥来加密输出，则还必须使用OutputLocation参数指定输出位置。

请注意，StartCallAnalyticsJob发出请求的角色必须拥有使用指定密钥的权限。

类型：字符串

长度限制：最小长度为 1。最大长度为 2048。

模式：^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

必需：否

与组合使用OutputBucketName可指定脚本的输出位置，也可以为输出文件指定唯一名称。转录输出的默认名称与您为医学转录工作指定的名称相同 (MedicalTranscriptionJobName)。

下面是一些如何使用的示例OutputKey：

如果您指定了不存在的 Amazon S3 存储桶子文件夹的名称，则会为您创建一个。

类型：字符串

长度限制：最小长度为 1。长度上限为 1024。

模式：[a-zA-Z0-9-_.!*'()/]{1,1024}$

必需：否

在您的StartMedicalTranscriptionJob请求中指定其他可选设置，包括频道识别、备用转录和扬声器分区。你可以用它来将自定义词汇应用到你的转录工作中。

类型：MedicalTranscriptionSetting 对象

必需：否

具体说明您的媒体中代表的主要医学专业。对于批量转录，PRIMARYCARE是唯一的有效值。如果您需要其他专业知识，请参阅StartMedicalStreamTranscription。

类型：字符串

有效值: PRIMARYCARE

必需：是

在你开始这项新工作时，向新的医学转录作业添加一个或多个自定义标签，每个标签都采用 key: value 对的形式。

要了解有关在 Amazon Transcribe 中使用标签的更多信息，请参阅标记资源。

类型：Tag 对象数组

数组成员：最少 1 项。最多 20项项项项项项项项项项

必需：否

指定您的输入媒体是仅包含一个人 (DICTATION) 还是包含两个人之间的对话 (CONVERSATION)。

例如，DICTATION可用于想要转录语音备忘录的医疗专业人员；CONVERSATION可用于在患者就诊期间转录医患对话。

类型：字符串

有效值: CONVERSATION | DICTATION

必需：是

提供有关当前医学转录工作的详细信息，包括工作状态和失败原因（如果适用）。

类型：MedicalTranscriptionJob 对象

您的请求未通过一项或多项验证测试。当您要删除的实体不存在或处于非终端状态（例如IN PROGRESS）时，可能会发生这种情况。有关更多信息，请参阅异常消息字段。

HTTP 状态代码：400

使用此名称的资源已经存在。资源名称在内必须是唯一的Amazon Web Services 账户。

HTTP 状态代码：400

遇到了内部错误。检查错误消息、更正问题，然后重试请求。

HTTP 状态代码：500

你要么发送了太多的请求，要么你的输入文件太长。请稍候，然后重试您的请求，或者使用较小的文件重试您的请求。

HTTP 状态代码：400