Models - List Files
指定した ID で識別されるモデルのファイルを取得します。
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files?sasValidityInSeconds={sasValidityInSeconds}&skip={skip}&top={top}&filter={filter}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
endpoint
|
path | True |
string |
サポートされている Cognitive Services エンドポイント (プロトコルとホスト名など)。 https://westus.api.cognitive.microsoft.com |
id
|
path | True |
string uuid |
モデルの識別子。 |
filter
|
query |
string |
使用可能なファイルのサブセットを選択するためのフィルター式。
|
|
sas
|
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 |
OK ヘッダー Retry-After: integer |
|
Other Status Codes |
エラーが発生しました。 |
セキュリティ
Ocp-Apim-Subscription-Key
コグニティブ サービス アカウント キーをここで指定します。
型:
apiKey
/:
header
Authorization
このリージョンの STS によって返される JWT からアクセス トークンを指定します。 STS URL に次のクエリ文字列を追加して、トークンに管理スコープを追加してください: ?scope=speechservicesmanagement
型:
apiKey
/:
header
例
Get all files
要求のサンプル
GET {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files?sasValidityInSeconds=120&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z
応答のサンプル
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
"name": "report.json",
"kind": "ModelReport",
"properties": {
"size": 200
},
"createdDateTime": "2020-01-13T08:00:00Z",
"links": {
"contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/report.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/models/827712a5-f942-4997-91c3-7c6cde35600b/files?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}
定義
名前 | 説明 |
---|---|
Detailed |
DetailedErrorCode |
Error |
エラー |
Error |
ErrorCode |
File |
ファイル |
File |
FileKind |
File |
FileLinks |
File |
FileProperties |
Inner |
InnerError |
Paginated |
PaginatedFiles |
DetailedErrorCode
DetailedErrorCode
名前 | 型 | 説明 |
---|---|---|
DataImportFailed |
string |
データのインポートに失敗しました。 |
DeleteNotAllowed |
string |
削除は許可されません。 |
DeployNotAllowed |
string |
デプロイは許可されていません。 |
DeployingFailedModel |
string |
失敗したモデルのデプロイ。 |
EmptyRequest |
string |
空の要求。 |
EndpointCannotBeDefault |
string |
エンドポイントを既定にすることはできません。 |
EndpointNotUpdatable |
string |
エンドポイントは更新できません。 |
EndpointWithoutLogging |
string |
ログのないエンドポイント。 |
ExceededNumberOfRecordingsUris |
string |
記録 URI の数を超えました。 |
FailedDataset |
string |
失敗したデータセット。 |
Forbidden |
string |
Forbidden. |
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 |
ログの top が無効です。 |
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 またはコンテナーまたはデータセットの 1 つだけ。 |
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 |
|
details |
Error[] |
エラーや予想されるポリシーに関する追加のサポートの詳細。 |
innerError |
InnerError |
|
message |
string |
高レベルのエラー メッセージ。 |
target |
string |
エラーのソースです。 たとえば、無効なドキュメントの場合は "documents" または "document id" になります。 |
ErrorCode
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 |
|
links |
FileLinks |
|
name |
string |
このファイルの名前。 |
properties |
FileProperties |
|
self |
string |
このエンティティの場所。 |
FileKind
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
FileLinks
名前 | 型 | 説明 |
---|---|---|
contentUrl |
string |
このファイルの内容を取得する URL。 |
FileProperties
FileProperties
名前 | 型 | 説明 |
---|---|---|
duration |
string |
このファイルがオーディオ ファイルの場合の期間。 期間は ISO 8601 期間としてエンコードされます (「PnYnMnDTnHnMnS」を参照)。https://en.wikipedia.org/wiki/ISO_8601#Durations |
size |
integer |
データのサイズ (バイト単位)。 |
InnerError
InnerError
名前 | 型 | 説明 |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
エラーや予想されるポリシーに関する追加のサポートの詳細。 |
innerError |
InnerError |
|
message |
string |
高レベルのエラー メッセージ。 |
target |
string |
エラーのソースです。 たとえば、無効なドキュメントの場合は "documents" または "document id" になります。 |
PaginatedFiles
PaginatedFiles
名前 | 型 | 説明 |
---|---|---|
@nextLink |
string |
使用可能なエンティティが増える場合は、次のページ分割された結果のセットへのリンク。それ以外の場合は null。 |
values |
File[] |
渡されたクエリ パラメーター 'skip' と 'top' またはその既定値によって制限されるエンティティの一覧。 ページ分割を使用してリストを反復処理し、並列でエンティティを削除すると、一部のエンティティは結果でスキップされます。 クライアントでリストを作成し、完全なリストをフェッチした後に削除することをお勧めします。 |