你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Transcriptions - List Files

参考

Service:: Azure AI Services

API Version:: v3.2-preview.2

获取由给定 ID 标识的听录文件。

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/{id}/files

With optional parameters:

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/{id}/files?sasValidityInSeconds={sasValidityInSeconds}&skip={skip}&top={top}&filter={filter}

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string	支持的认知服务终结点 (协议和主机名，例如： https://westus.api.cognitive.microsoft.com) 。
id	path	True	string uuid	听录的标识符。
filter	query		string	用于选择可用文件的子集的筛选表达式。 `- Supported properties: name, createdDateTime, kind. - Operators: - eq, ne are supported for all properties. - gt, ge, lt, le are supported for createdDateTime. - and, or, not are supported. - Example: filter=name eq 'myaudio.wav.json' and kind eq 'Transcription'`
sasValidityInSeconds	query		integer int32	SAS URL 应有效的持续时间（以秒为单位）。默认持续时间为 12 小时。使用 BYOS 时 (https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/speech-encryption-of-data-at-rest#bring-your-own-storage-byos-for-customization-and-logging) ：值 0 表示将生成不带 SAS 令牌的纯 Blob URI。
skip	query		integer int32	将跳过的数据集数。
top	query		integer int32	跳过后将包含的数据集数。

响应

名称	类型	说明
200 OK	PaginatedFiles	确定 Headers Retry-After: integer
Other Status Codes	Error	出现了错误。

名称

类型

说明

200 OK

PaginatedFiles

确定

Headers

Retry-After: integer

Other Status Codes

Error

出现了错误。

安全性

Ocp-Apim-Subscription-Key

在此处提供认知服务帐户密钥。

Type: apiKey
In: header

Authorization

提供此区域的 STS 返回的 JWT 的访问令牌。通过将以下查询字符串添加到 STS URL，确保将管理范围添加到令牌：？scope=speechservicesmanagement

Type: apiKey
In: header

示例

Get all files

Get all transcription files the name of which starts with the specified string

Get all files

Sample Request

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasValidityInSeconds=120&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z

Sample Response

Status code:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/28bc946b-c251-4a86-84f6-ea0f0a2373ef",
      "name": "mywavefile2.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile2.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?skip=2&top=2"
}

Get all transcription files the name of which starts with the specified string

Sample Request

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files?sasValidityInSeconds=120&skip=0&top=10&filter=name%20eq%20'mywavefile1.wav.json'

Sample Response

Status code:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/transcriptions/ba7ea6f5-3065-40b7-b49a-a90f48584683/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "mywavefile1.wav.json",
      "kind": "Transcription",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.json?st=2018-02-09T18%3A07%3A00Z&se=2018-02-10T18%3A07%3A00Z&sp=rl&sv=2017-04-17&sr=b&sig=e05d8d56-9675-448b-820c-4318ae64c8d5"
      }
    }
  ]
}

定义

名称	说明
DetailedErrorCode	DetailedErrorCode
Error	错误
ErrorCode	ErrorCode
File	文件
FileKind	FileKind
FileLinks	FileLinks
FileProperties	FileProperties
InnerError	InnerError
PaginatedFiles	PaginatedFiles

DetailedErrorCode

名称	类型	说明
DataImportFailed	string	数据导入失败。
DeleteNotAllowed	string	不允许删除。
DeployNotAllowed	string	不允许部署。
DeployingFailedModel	string	部署失败的模型。
EmptyRequest	string	空请求。
EndpointCannotBeDefault	string	终结点不能为默认值。
EndpointNotUpdatable	string	终结点不可更新。
EndpointWithoutLogging	string	不记录的终结点。
ExceededNumberOfRecordingsUris	string	超出了录制 URI 数。
FailedDataset	string	失败的数据集。
Forbidden	string	已禁止。
InUseViolation	string	在使用中冲突。
InaccessibleCustomerStorage	string	无法访问的客户存储。
InvalidAdaptationMapping	string	无效的适应映射。
InvalidBaseModel	string	基本模型无效。
InvalidCallbackUri	string	回调 URI 无效。
InvalidCollection	string	集合无效。
InvalidDataset	string	无效的数据集。
InvalidDocument	string	无效的文档。
InvalidDocumentBatch	string	无效的文档批处理。
InvalidLocale	string	区域设置无效。
InvalidLogDate	string	日志日期无效。
InvalidLogEndTime	string	日志结束时间无效。
InvalidLogId	string	日志 ID 无效。
InvalidLogStartTime	string	日志开始时间无效。
InvalidModel	string	无效的模型。
InvalidModelUri	string	无效的模型 URI。
InvalidParameter	string	参数无效。
InvalidParameterValue	string	参数值无效。
InvalidPayload	string	有效负载无效。
InvalidPermissions	string	权限无效。
InvalidPrerequisite	string	先决条件无效。
InvalidProductId	string	产品 ID 无效。
InvalidProject	string	无效的项目。
InvalidProjectKind	string	无效的项目类型。
InvalidRecordingsUri	string	录制 URI 无效。
InvalidRequestBodyFormat	string	请求正文格式无效。
InvalidSasValidityDuration	string	sas 有效性持续时间无效。
InvalidSkipTokenForLogs	string	日志的跳过令牌无效。
InvalidSourceAzureResourceId	string	源 Azure 资源 ID 无效。
InvalidSubscription	string	无效的订阅。
InvalidTest	string	测试无效。
InvalidTimeToLive	string	生存时间无效。
InvalidTopForLogs	string	日志顶部无效。
InvalidTranscription	string	听录无效。
InvalidWebHookEventKind	string	Web 挂钩事件类型无效。
MissingInputRecords	string	缺少输入记录。
ModelCopyOperationExists	string	模型复制操作存在。
ModelDeploymentNotCompleteState	string	模型部署未完成状态。
ModelDeprecated	string	模型已弃用。
ModelExists	string	模型存在。
ModelMismatch	string	模型不匹配。
ModelNotDeployable	string	模型不可部署。
ModelVersionIncorrect	string	模型版本不正确。
NoUtf8WithBom	string	没有带有 bom 的 utf8。
OnlyOneOfUrlsOrContainerOrDataset	string	只有一个 URL 或容器或数据集。
ProjectGenderMismatch	string	项目性别不匹配。
QuotaViolation	string	配额冲突。
SingleDefaultEndpoint	string	单个默认终结点。
SkuLimitsExist	string	存在 SKU 限制。
SubscriptionNotFound	string	找不到订阅。
UnexpectedError	string	意外错误。
UnsupportedClassBasedAdaptation	string	不支持的基于类的适应。
UnsupportedDelta	string	不支持的增量。
UnsupportedDynamicConfiguration	string	不支持的动态配置。
UnsupportedFilter	string	不支持的筛选器。
UnsupportedLanguageCode	string	不支持的语言代码。
UnsupportedOrderBy	string	不支持的订单依据。
UnsupportedPagination	string	不支持的分页。
UnsupportedTimeRange	string	不支持的时间范围。

Error

错误

名称	类型	说明
code	ErrorCode	ErrorCode 高级错误代码。
details	Error[]	有关错误和/或预期策略的其他支持性详细信息。
innerError	InnerError	InnerError 新的内部错误格式，符合认知服务 API 指南，可从 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可以嵌套）。
message	string	高级别错误消息。
target	string	错误的源。例如，如果文档无效，应为“文档”或“文档 ID”。

ErrorCode

名称	类型	说明
Conflict	string	表示冲突错误代码。
Forbidden	string	表示禁止的错误代码。
InternalCommunicationFailed	string	表示内部通信失败的错误代码。
InternalServerError	string	表示内部服务器错误代码。
InvalidArgument	string	表示无效参数错误代码。
InvalidRequest	string	表示无效请求错误代码。
NotAllowed	string	表示不允许的错误代码。
NotFound	string	表示“找不到”错误代码。
PipelineError	string	表示管道错误代码。
ServiceUnavailable	string	表示服务不可用错误代码。
TooManyRequests	string	表示请求过多错误代码。
Unauthorized	string	表示未经授权的错误代码。
UnprocessableEntity	string	表示不可处理的实体错误代码。
UnsupportedMediaType	string	表示不受支持的媒体类型错误代码。

File

文件

名称	类型	说明
createdDateTime	string	此文件的创建时间。时间戳编码为 ISO 8601 日期和时间格式 (请参阅 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) 。
kind	FileKind	FileKind 数据类型。
links	FileLinks	FileLinks
name	string	此文件的名称。
properties	FileProperties	FileProperties
self	string	此实体的位置。

FileKind

名称	类型	说明
AcousticDataArchive	string	数据类型为声学数据存档。
AcousticDataTranscriptionV2	string	数据类型为声学数据听录 v2。
Audio	string	数据类型为音频。
DatasetReport	string	数据类型为数据集报表。
EvaluationDetails	string	数据类型是评估详细信息。
LanguageData	string	数据类型为语言数据。
ModelReport	string	数据类型为模型报表。
OutputFormattingData	string	数据类型是输出格式设置输入文件。
PronunciationData	string	数据类型是发音数据。
Transcription	string	数据类型为听录。
TranscriptionReport	string	数据类型为听录报告。

FileLinks

名称	类型	说明
contentUrl	string	用于检索此文件内容的 URL。

FileProperties

名称	类型	说明
duration	string	此文件为音频文件的持续时间。持续时间编码为 ISO 8601 持续时间 (“PnYnMnDTnHnMnS”，请参阅 https://en.wikipedia.org/wiki/ISO_8601#Durations) 。
size	integer	数据的大小（以字节为单位）。

InnerError

名称	类型	说明
code	DetailedErrorCode	DetailedErrorCode 详细的错误代码枚举。
details	object	有关错误和/或预期策略的其他支持性详细信息。
innerError	InnerError	InnerError 新的内部错误格式，符合认知服务 API 指南，可从 https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow获取。这包含必需的属性 ErrorCode、消息和可选属性目标、详细信息（键值对）、内部错误（可以嵌套）。
message	string	高级别错误消息。
target	string	错误的源。例如，如果文档无效，应为“文档”或“文档 ID”。

PaginatedFiles

名称	类型	说明
@nextLink	string	如果有更多可用的实体，则提供指向下一组分页结果的链接;否则为 null。
values	File[]	受传递的查询参数“skip”和“top”或其默认值限制的实体列表。使用分页和并行删除实体循环访问列表时，结果中将跳过某些实体。建议在客户端上生成一个列表，并在提取完整列表后将其删除。

名称

类型

说明

@nextLink

string

如果有更多可用的实体，则提供指向下一组分页结果的链接;否则为 null。

values

File[]

受传递的查询参数“skip”和“top”或其默认值限制的实体列表。

使用分页和并行删除实体循环访问列表时，结果中将跳过某些实体。建议在客户端上生成一个列表，并在提取完整列表后将其删除。

Transcriptions - List Files

URI 参数

响应

安全性

Ocp-Apim-Subscription-Key

Authorization

示例

Get all files

Sample Request

Sample Response

Get all transcription files the name of which starts with the specified string

Sample Request

Sample Response

定义

DetailedErrorCode

Error

ErrorCode

File

FileKind

FileLinks

FileProperties

InnerError

PaginatedFiles

其他资源