Datasets - List
Lekéri a hitelesített előfizetés adathalmazainak listáját.
GET {endpoint}/speechtotext/v3.2-preview.2/datasets
GET {endpoint}/speechtotext/v3.2-preview.2/datasets?skip={skip}&top={top}&filter={filter}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com). |
filter
|
query |
string |
Szűrőkifejezés az elérhető adathalmazok egy részhalmazának kiválasztásához.
|
|
skip
|
query |
integer int32 |
Kihagyandó adathalmazok száma. |
|
top
|
query |
integer int32 |
A kihagyás után belefoglalt adathalmazok száma. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK Headers Retry-After: integer |
|
Other Status Codes |
Hiba történt. |
Biztonság
Ocp-Apim-Subscription-Key
Itt adja meg a Cognitive Services-fiókkulcsot.
Type:
apiKey
In:
header
Authorization
Adjon meg egy hozzáférési jogkivonatot a régió STS által visszaadott JWT-ből. Győződjön meg arról, hogy hozzáadja a felügyeleti hatókört a jogkivonathoz, ha hozzáadja a következő lekérdezési sztringet az STS URL-címéhez: ?scope=speechservicesmanagement
Type:
apiKey
In:
header
Példák
Get all acoustic datasets |
Get all datasets |
Get all acoustic datasets
Sample Request
GET {endpoint}/speechtotext/v3.2-preview.2/datasets?skip=0&top=10&filter=kind%20eq%20'Acoustic'
Sample Response
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1",
"kind": "Acoustic",
"contentUrl": "https://www.contoso.com/acousticdata/sourcelocation",
"links": {
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files"
},
"properties": {
"textNormalizationKind": "Default",
"acceptedLineCount": 11,
"rejectedLineCount": 2,
"duration": "PT4M12S"
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Succeeded",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Acoustic dataset"
}
]
}
Get all datasets
Sample Request
GET {endpoint}/speechtotext/v3.2-preview.2/datasets?skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z
Sample Response
{
"values": [
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1",
"kind": "Acoustic",
"contentUrl": "https://www.contoso.com/acousticdata/sourcelocation",
"links": {
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files"
},
"properties": {
"textNormalizationKind": "Default",
"acceptedLineCount": 11,
"rejectedLineCount": 2,
"duration": "PT4M12S"
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Succeeded",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Acoustic dataset"
},
{
"self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c",
"kind": "Language",
"contentUrl": "https://www.contoso.com/LanguageData/SourceLocation",
"links": {
"files": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/cdc91c24-3972-496d-a12f-209c35f4cc6c/files"
},
"properties": {
"textNormalizationKind": "Default",
"acceptedLineCount": 11,
"rejectedLineCount": 2
},
"lastActionDateTime": "2019-01-07T11:36:07Z",
"status": "Succeeded",
"createdDateTime": "2019-01-07T11:34:12Z",
"locale": "en-US",
"displayName": "Language dataset"
}
],
"@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}
Definíciók
Name | Description |
---|---|
Dataset |
Adathalmaz |
Dataset |
DatasetKind |
Dataset |
DatasetLinks |
Dataset |
Adathalmaztulajdonságok |
Detailed |
DetailedErrorCode |
Entity |
EntityError |
Entity |
EntityReference |
Error |
Hiba |
Error |
ErrorCode |
Inner |
InnerError |
Paginated |
Lapszámozott adathalmazok |
Status |
Állapot |
Text |
TextNormalizationKind |
Dataset
Adathalmaz
Name | Típus | Description |
---|---|---|
contentUrl |
string |
Az adathalmaz adatainak URL-címe. |
createdDateTime |
string |
Az objektum létrehozásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("ÉÉÉÉÉ-HH-NNH:mm:ssZ", lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
customProperties |
object |
Az entitás egyéni tulajdonságai. A maximális megengedett kulcshossz 64 karakter, a megengedett érték maximális hossza 256 karakter, az engedélyezett bejegyzések száma pedig 10. |
description |
string |
Az objektum leírása. |
displayName |
string |
Az objektum megjelenítendő neve. |
kind |
DatasetKind |
|
lastActionDateTime |
string |
Az aktuális állapot megadásának időbélyege. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva ("ÉÉÉÉÉ-HH-NNH:mm:ssZ", lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations). |
links |
DatasetLinks |
|
locale |
string |
A tartalmazott adatok területi beállítása. |
project |
EntityReference |
|
properties |
Adathalmaztulajdonságok |
|
self |
string |
Az entitás helye. |
status |
Állapot |
DatasetKind
DatasetKind
Name | Típus | Description |
---|---|---|
Acoustic |
string |
Egy akusztikai adatkészlet. |
AudioFiles |
string |
Hangfájlok adatkészlete. |
Language |
string |
Egy nyelvi adatkészlet. |
LanguageMarkdown |
string |
Nyelvi Markdown-adatkészlet. |
OutputFormatting |
string |
Adatkészlet, amely az inverz szöveg normalizálásának, a nagybetűsítésnek, a reformálásnak, a káromkodásnak a testreszabására vonatkozó szabályokat tartalmaz, és az adathalmaz-érvényesítési teszteket is meghatározza |
Pronunciation |
string |
Kiejtési adatkészlet. |
DatasetLinks
DatasetLinks
Name | Típus | Description |
---|---|---|
commitBlocks |
string |
A blokkok listájának véglegesítésének helye egy adathalmaz blokkokkal való feltöltésekor. További részletekért lásd a "Datasets_CommitBlocks" műveletet. |
files |
string |
Az entitás összes fájljának lekérésének helye. További részletekért lásd a "Datasets_ListFiles" műveletet. |
listBlocks |
string |
Az entitás már feltöltött blokkjainak listázására szolgáló hely, amikor blokkokkal tölt fel egy adathalmazt. További részletekért lásd a "Datasets_GetBlocks" műveletet. |
uploadBlocks |
string |
A blokkok feltöltésének helye az adathalmaz blokkokkal való feltöltésekor. További részletekért lásd a "Datasets_UploadBlock" műveletet. |
DatasetProperties
Adathalmaztulajdonságok
Name | Típus | Description |
---|---|---|
acceptedLineCount |
integer |
Az adatkészlethez elfogadott sorok száma. |
duration |
string |
Az adathalmazok teljes időtartama, ha hangfájlokat tartalmaz. Az időtartam ISO 8601-es időtartamként van kódolva ("PnYnMnDTnHnMnS", lásd: https://en.wikipedia.org/wiki/ISO_8601#Durations). |
string |
Az e-mail-értesítések küldéséhez használt e-mail-cím, ha a művelet befejeződik. Az érték az e-mail sikeres elküldése után törlődik. |
|
error |
EntityError |
|
rejectedLineCount |
integer |
Az adatkészlethez elutasított sorok száma. |
textNormalizationKind |
TextNormalizationKind |
DetailedErrorCode
DetailedErrorCode
Name | Típus | Description |
---|---|---|
DataImportFailed |
string |
Az adatimportálás sikertelen volt. |
DeleteNotAllowed |
string |
A törlés nem engedélyezett. |
DeployNotAllowed |
string |
Az üzembe helyezés nem engedélyezett. |
DeployingFailedModel |
string |
Sikertelen modell üzembe helyezése. |
EmptyRequest |
string |
Üres kérelem. |
EndpointCannotBeDefault |
string |
A végpont nem lehet alapértelmezett. |
EndpointNotUpdatable |
string |
A végpont nem frissíthető. |
EndpointWithoutLogging |
string |
Végpont naplózás nélkül. |
ExceededNumberOfRecordingsUris |
string |
Túllépte a felvételek URI-jainak számát. |
FailedDataset |
string |
Nem sikerült az adathalmaz. |
Forbidden |
string |
Tiltott. |
InUseViolation |
string |
Használaton belüli szabálysértés. |
InaccessibleCustomerStorage |
string |
Elérhetetlen ügyféltároló. |
InvalidAdaptationMapping |
string |
Érvénytelen adaptációs leképezés. |
InvalidBaseModel |
string |
Érvénytelen alapmodell. |
InvalidCallbackUri |
string |
Érvénytelen visszahívási URI. |
InvalidCollection |
string |
Érvénytelen gyűjtemény. |
InvalidDataset |
string |
Érvénytelen adatkészlet. |
InvalidDocument |
string |
Érvénytelen dokumentum. |
InvalidDocumentBatch |
string |
Érvénytelen dokumentumköteg. |
InvalidLocale |
string |
Érvénytelen területi beállítás. |
InvalidLogDate |
string |
Érvénytelen naplódátum. |
InvalidLogEndTime |
string |
Érvénytelen a napló befejezési ideje. |
InvalidLogId |
string |
Érvénytelen naplóazonosító. |
InvalidLogStartTime |
string |
Érvénytelen a napló kezdési időpontja. |
InvalidModel |
string |
Érvénytelen modell. |
InvalidModelUri |
string |
Érvénytelen modell URI-ja. |
InvalidParameter |
string |
Érvénytelen paraméter. |
InvalidParameterValue |
string |
Érvénytelen paraméterérték. |
InvalidPayload |
string |
Érvénytelen hasznos adat. |
InvalidPermissions |
string |
Érvénytelen engedélyek. |
InvalidPrerequisite |
string |
Érvénytelen előfeltétel. |
InvalidProductId |
string |
Érvénytelen termékazonosító. |
InvalidProject |
string |
Érvénytelen projekt. |
InvalidProjectKind |
string |
Érvénytelen projekttípus. |
InvalidRecordingsUri |
string |
Érvénytelen felvételek URI-ja. |
InvalidRequestBodyFormat |
string |
Érvénytelen a kérelem törzsének formátuma. |
InvalidSasValidityDuration |
string |
Érvénytelen sas-érvényességi időtartam. |
InvalidSkipTokenForLogs |
string |
Érvénytelen kihagyó jogkivonat a naplókhoz. |
InvalidSourceAzureResourceId |
string |
Érvénytelen forrás Azure-erőforrás-azonosító. |
InvalidSubscription |
string |
Érvénytelen előfizetés. |
InvalidTest |
string |
Érvénytelen teszt. |
InvalidTimeToLive |
string |
Érvénytelen élettartam. |
InvalidTopForLogs |
string |
A naplók felső része érvénytelen. |
InvalidTranscription |
string |
Érvénytelen átírás. |
InvalidWebHookEventKind |
string |
Érvénytelen webhookesemény-típus. |
MissingInputRecords |
string |
Hiányzó bemeneti rekordok. |
ModelCopyOperationExists |
string |
Létezik modellmásolási művelet. |
ModelDeploymentNotCompleteState |
string |
A modell üzembe helyezése nem fejeződött be. |
ModelDeprecated |
string |
A modell elavult. |
ModelExists |
string |
A modell létezik. |
ModelMismatch |
string |
Modelleltérés. |
ModelNotDeployable |
string |
A modell nem helyezhető üzembe. |
ModelVersionIncorrect |
string |
A modell verziója helytelen. |
NoUtf8WithBom |
string |
Nincs utf8 a bom. |
OnlyOneOfUrlsOrContainerOrDataset |
string |
Csak egy URL-cím, tároló vagy adatkészlet. |
ProjectGenderMismatch |
string |
A projekt neme nem egyezik. |
QuotaViolation |
string |
Kvóta megsértése. |
SingleDefaultEndpoint |
string |
Egyetlen alapértelmezett végpont. |
SkuLimitsExist |
string |
A termékváltozatra vonatkozó korlátozások léteznek. |
SubscriptionNotFound |
string |
Az előfizetés nem található. |
UnexpectedError |
string |
Váratlan hiba. |
UnsupportedClassBasedAdaptation |
string |
Nem támogatott osztályalapú adaptáció. |
UnsupportedDelta |
string |
Nem támogatott változás. |
UnsupportedDynamicConfiguration |
string |
Nem támogatott dinamikus konfiguráció. |
UnsupportedFilter |
string |
Nem támogatott szűrő. |
UnsupportedLanguageCode |
string |
Nem támogatott nyelvi kód. |
UnsupportedOrderBy |
string |
Nem támogatott sorrend szerint. |
UnsupportedPagination |
string |
Nem támogatott lapozás. |
UnsupportedTimeRange |
string |
Nem támogatott időtartomány. |
EntityError
EntityError
Name | Típus | Description |
---|---|---|
code |
string |
A hiba kódja. |
message |
string |
A hiba üzenete. |
EntityReference
EntityReference
Name | Típus | Description |
---|---|---|
self |
string |
A hivatkozott entitás helye. |
Error
Hiba
Name | Típus | Description |
---|---|---|
code |
ErrorCode |
|
details |
Error[] |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
ErrorCode
ErrorCode
Name | Típus | Description |
---|---|---|
Conflict |
string |
Az ütközési hibakódnak megfelelő. |
Forbidden |
string |
A tiltott hibakódot jelöli. |
InternalCommunicationFailed |
string |
A belső kommunikáció hibakódját jelképező hibakód. |
InternalServerError |
string |
A belső kiszolgáló hibakódját jelöli. |
InvalidArgument |
string |
Az érvénytelen argumentum hibakódját jelöli. |
InvalidRequest |
string |
Az érvénytelen kérelem hibakódját jelöli. |
NotAllowed |
string |
A nem engedélyezett hibakódot jelöli. |
NotFound |
string |
A nem található hibakódot jelöli. |
PipelineError |
string |
A folyamat hibakódját jelöli. |
ServiceUnavailable |
string |
A szolgáltatás nem érhető el hibakódját jelöli. |
TooManyRequests |
string |
A túl sok kérés hibakódját jelöli. |
Unauthorized |
string |
A jogosulatlan hibakódot jelöli. |
UnprocessableEntity |
string |
A feldolgozhatatlan entitás hibakódját jelöli. |
UnsupportedMediaType |
string |
A nem támogatott médiatípus hibakódját jelöli. |
InnerError
InnerError
Name | Típus | Description |
---|---|---|
code |
DetailedErrorCode |
|
details |
object |
További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban. |
innerError |
InnerError |
|
message |
string |
Magas szintű hibaüzenet. |
target |
string |
A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító". |
PaginatedDatasets
Lapszámozott adathalmazok
Name | Típus | Description |
---|---|---|
@nextLink |
string |
Hivatkozás a lapszámozott eredmények következő készletére, ha több entitás érhető el; egyébként null értékű. |
values |
Dataset[] |
A "skip" és a "top" átadott lekérdezési paraméterek vagy az alapértelmezett értékek által korlátozott entitások listája. Ha egy listát lapszámozással és entitások párhuzamos törlésével iterál, egyes entitások kimaradnak az eredményekből. Javasoljuk, hogy hozzon létre egy listát az ügyfélen, és törölje a teljes lista lekérése után. |
Status
Állapot
Name | Típus | Description |
---|---|---|
Failed |
string |
A hosszú ideig futó művelet meghiúsult. |
NotStarted |
string |
A hosszú ideig futó művelet még nem indult el. |
Running |
string |
A hosszú ideig futó művelet feldolgozása folyamatban van. |
Succeeded |
string |
A hosszú ideig futó művelet sikeresen befejeződött. |
TextNormalizationKind
TextNormalizationKind
Name | Típus | Description |
---|---|---|
Default |
string |
Az alapértelmezett szöveg normalizálása (például a "2–3" helyett a "kettő–három" lép az en-US-ben). |
None |
string |
A szöveg normalizálása nem lesz alkalmazva a bemeneti szövegre. Ez egy felülbírálási lehetőség, amelyet csak akkor szabad használni, ha a szöveg normalizálva van a feltöltés előtt. |