Endpoints - List Logs
取得已針對指定端點儲存的音訊和轉譯記錄清單。
GET {endpoint}/speechtotext/v3.1/endpoints/{id}/files/logs
GET {endpoint}/speechtotext/v3.1/endpoints/{id}/files/logs?sasValidityInSeconds={sasValidityInSeconds}&skipToken={skipToken}&top={top}
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
支援的認知服務端點(通訊協定和主機名,例如:https://westus.api.cognitive.microsoft.com)。 |
id
|
path | True |
string (uuid) |
端點的標識碼。 |
sas
|
query |
integer (int32) |
SAS URL 應有效以秒為單位的持續時間。 默認持續時間為12小時。 使用 BYOS 時 (https://docs.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 |
string |
用來略過先前要求中已擷取的記錄的令牌。 當未定義時,分頁會從開頭開始。 |
|
top
|
query |
integer (int32) |
略過之後將包含的數據集數目。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
還行 標題 Retry-After: integer |
|
Other Status Codes |
發生錯誤。 |
安全性
Ocp-Apim-Subscription-Key
在這裡提供您的認知服務帳戶金鑰。
類型:
apiKey
位於:
header
Authorization
提供來自此區域 STS 所傳回之 JWT 的存取令牌。 請務必將下列查詢字串新增至 STS URL,將管理範圍新增至令牌:?scope=speechservicesmanagement
類型:
apiKey
位於:
header
範例
Get all endpoint logs
範例要求
GET {endpoint}/speechtotext/v3.1/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs?sasValidityInSeconds=120&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--&top=2
範例回覆
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.1/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
"name": "2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
"kind": "Audio",
"properties": {
"size": 12345
},
"createdDateTime": "2020-01-13T08:00:00Z",
"links": {
"contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav?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.1/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.json",
"name": "2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.json",
"kind": "Transcription",
"properties": {
"size": 12345
},
"createdDateTime": "2020-01-13T08:00:00Z",
"links": {
"contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.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.1/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs?top=2&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--"
}
定義
名稱 | Description |
---|---|
Detailed |
DetailedErrorCode |
Error |
錯誤 |
Error |
錯誤代碼 |
File |
檔案 |
File |
FileKind |
File |
FileLinks |
File |
FileProperties |
Inner |
InnerError |
Paginated |
PaginatedFiles |
DetailedErrorCode
DetailedErrorCode
值 | Description |
---|---|
DataImportFailed |
數據匯入失敗。 |
DeleteNotAllowed |
不允許刪除。 |
DeployNotAllowed |
不允許部署。 |
DeployingFailedModel |
部署失敗的模型。 |
EmptyRequest |
空白要求。 |
EndpointCannotBeDefault |
端點不可為預設值。 |
EndpointNotUpdatable |
端點無法更新。 |
EndpointWithoutLogging |
沒有記錄的端點。 |
ExceededNumberOfRecordingsUris |
超過錄製 URI 的數目。 |
FailedDataset |
失敗的數據集。 |
Forbidden |
禁止。 |
InUseViolation |
在使用違規中。 |
InaccessibleCustomerStorage |
無法存取的客戶記憶體。 |
InvalidAdaptationMapping |
無效的適應對應。 |
InvalidBaseModel |
基底模型無效。 |
InvalidCallbackUri |
無效的回呼 URI。 |
InvalidCollection |
無效的集合。 |
InvalidDataset |
無效的數據集。 |
InvalidDocument |
無效的檔。 |
InvalidDocumentBatch |
檔批次無效。 |
InvalidLocale |
地區設定無效。 |
InvalidLogDate |
無效的記錄日期。 |
InvalidLogEndTime |
無效的記錄結束時間。 |
InvalidLogId |
無效的記錄標識碼。 |
InvalidLogStartTime |
無效的記錄開始時間。 |
InvalidModel |
無效的模型。 |
InvalidModelUri |
無效的模型 URI。 |
InvalidParameter |
無效的參數。 |
InvalidParameterValue |
無效的參數值。 |
InvalidPayload |
無效的承載。 |
InvalidPermissions |
許可權無效。 |
InvalidPrerequisite |
無效的必要條件。 |
InvalidProductId |
無效的產品標識碼。 |
InvalidProject |
無效的專案。 |
InvalidProjectKind |
無效的項目種類。 |
InvalidRecordingsUri |
無效的錄製 URI。 |
InvalidRequestBodyFormat |
要求本文格式無效。 |
InvalidSasValidityDuration |
無效的 sas 有效性持續時間。 |
InvalidSkipTokenForLogs |
記錄的略過令牌無效。 |
InvalidSubscription |
無效的訂用帳戶。 |
InvalidTest |
無效的測試。 |
InvalidTimeToLive |
存留時間無效。 |
InvalidTopForLogs |
記錄的頂端無效。 |
InvalidTranscription |
無效的轉譯。 |
InvalidWebHookEventKind |
無效的 Web 攔截事件種類。 |
MissingInputRecords |
遺漏輸入記錄。 |
ModelDeploymentNotCompleteState |
模型部署未完成狀態。 |
ModelDeprecated |
模型已被取代。 |
ModelExists |
模型存在。 |
ModelMismatch |
模型不符。 |
ModelNotDeployable |
模型不可部署。 |
ModelVersionIncorrect |
模型版本不正確。 |
NoUtf8WithBom |
沒有 utf8 與 bom。 |
OnlyOneOfUrlsOrContainerOrDataset |
只有一個 URL 或容器或數據集。 |
ProjectGenderMismatch |
專案性別不符。 |
QuotaViolation |
配額違規。 |
SingleDefaultEndpoint |
單一預設端點。 |
SkuLimitsExist |
Sku 限制存在。 |
SubscriptionNotFound |
找不到訂用帳戶。 |
UnexpectedError |
未預期的錯誤。 |
UnsupportedClassBasedAdaptation |
不支援的類別型調整。 |
UnsupportedDelta |
不支持的差異。 |
UnsupportedDynamicConfiguration |
不支援的動態設定。 |
UnsupportedFilter |
不支援的篩選。 |
UnsupportedLanguageCode |
不支援的語言代碼。 |
UnsupportedOrderBy |
不支援的順序依據。 |
UnsupportedPagination |
不支援的分頁。 |
UnsupportedTimeRange |
不支援的時間範圍。 |
Error
錯誤
名稱 | 類型 | Description |
---|---|---|
code |
錯誤代碼 |
|
details |
Error[] |
有關錯誤和/或預期原則的其他支持詳細數據。 |
innerError |
InnerError |
|
message |
string |
高階錯誤訊息。 |
target |
string |
錯誤的來源。 例如,如果檔無效,則會是「檔」或「文件標識碼」。 |
ErrorCode
錯誤代碼
值 | Description |
---|---|
Conflict |
表示衝突錯誤碼。 |
Forbidden |
表示禁止的錯誤碼。 |
InternalCommunicationFailed |
表示內部通訊失敗的錯誤碼。 |
InternalServerError |
表示內部伺服器錯誤碼。 |
InvalidArgument |
表示無效的自變數錯誤碼。 |
InvalidRequest |
表示無效的要求錯誤碼。 |
NotAllowed |
表示不允許的錯誤碼。 |
NotFound |
表示找不到的錯誤碼。 |
PipelineError |
表示管線錯誤碼。 |
ServiceUnavailable |
表示服務無法使用的錯誤碼。 |
TooManyRequests |
表示太多要求錯誤碼。 |
Unauthorized |
表示未經授權的錯誤碼。 |
UnprocessableEntity |
表示無法處理的實體錯誤碼。 |
UnsupportedMediaType |
表示不支援的媒體類型錯誤碼。 |
File
檔案
名稱 | 類型 | Description |
---|---|---|
createdDateTime |
string (date-time) |
這個檔案的建立時間。 時間戳會編碼為 ISO 8601 日期和時間格式(請參閱 https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations)。 |
kind |
FileKind |
|
links |
FileLinks |
|
name |
string |
這個檔案的名稱。 |
properties |
FileProperties |
|
self |
string (uri) |
此實體的位置。 |
FileKind
FileKind
值 | Description |
---|---|
AcousticDataArchive |
數據類型為原音數據封存。 |
AcousticDataTranscriptionV2 |
數據類型為原音數據轉譯 v2。 |
Audio |
數據類型為音訊。 |
DatasetReport |
數據類型為數據集報表。 |
EvaluationDetails |
數據類型是評估詳細數據。 |
LanguageData |
數據類型為語言數據。 |
ModelReport |
數據類型為模型報表。 |
PronunciationData |
數據類型是發音數據。 |
Transcription |
數據類型為轉譯。 |
TranscriptionReport |
數據類型為轉譯報表。 |
FileLinks
FileLinks
名稱 | 類型 | Description |
---|---|---|
contentUrl |
string (uri) |
要擷取此檔案內容的URL。 |
FileProperties
FileProperties
名稱 | 類型 | Description |
---|---|---|
duration |
string |
如果這個檔案是音訊檔案,則持續時間。 持續時間會編碼為 ISO 8601 持續時間(“PnYnMnDTnHnMnS”,請參閱 https://en.wikipedia.org/wiki/ISO_8601#Durations)。 |
size |
integer (int64) |
以位元組為單位的數據大小。 |
InnerError
InnerError
名稱 | 類型 | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
有關錯誤和/或預期原則的其他支持詳細數據。 |
innerError |
InnerError |
|
message |
string |
高階錯誤訊息。 |
target |
string |
錯誤的來源。 例如,如果檔無效,則會是「檔」或「文件標識碼」。 |
PaginatedFiles
PaginatedFiles
名稱 | 類型 | Description |
---|---|---|
@nextLink |
string (uri) |
如果有更多實體可用,則為下一組編頁結果的連結;否則為 null。 |
values |
File[] |
由傳遞的查詢參數 『skip』 和 『top』 或其預設值所限制的實體清單。 使用分頁和平行刪除實體逐一查看清單時,結果中會略過某些實體。 建議在用戶端上建置清單,並在擷取完整清單之後刪除。 |