Datasets - Get

Szolgáltatás:: Azure AI Services

API-verzió:: v3.2-preview.2

Lekéri a megadott azonosító által azonosított adatkészletet.

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

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).
id	path	True	string (uuid)	Az adathalmaz azonosítója.

Válaszok

Name	Típus	Description
200 OK	Dataset	OKÉ Fejlécek Retry-After: integer
Other Status Codes	Error	Hiba történt.

Name

Típus

Description

200 OK

Dataset

OKÉ

Fejlécek

Retry-After: integer

Other Status Codes

Error

Hiba történt.

Biztonság

Ocp-Apim-Subscription-Key

Itt adja meg a Cognitive Services-fiókkulcsot.

Típus: 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

Típus: apiKey
In: header

Példák

Get a dataset

Mintakérelem

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1

Mintaválasz

Állapotkód:: 200

{
  "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"
}

Definíciók

Name	Description
Dataset	Adatkészlet
DatasetKind	DatasetKind
DatasetLinks	DatasetLinks
DatasetProperties	DatasetProperties
DetailedErrorCode	DetailedErrorCode
EntityError	EntityError
EntityReference	EntityReference
Error	Hiba
ErrorCode	Hibakód
InnerError	InnerError
Status	Állapot
TextNormalizationKind	TextNormalizationKind

Dataset

Objektum

Adatkészlet

Name	Típus	Description
contentUrl	string (uri)	Az adathalmaz adatainak URL-címe.
createdDateTime	string (date-time)	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 ("YYYY-MM-DDThh: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álisan megengedett kulcshossz 64 karakter, az engedélyezett é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 minLength: 1	Az objektum megjelenítendő neve.
kind	DatasetKind	DatasetKind Adatimportálás típusa.
lastActionDateTime	string (date-time)	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 ("YYYY-MM-DDThh:mm:ssZ", lásd https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
links	DatasetLinks	DatasetLinks
locale	string minLength: 1	A tartalmazott adatok területi beállítása.
project	EntityReference	EntityReference
properties	DatasetProperties	DatasetProperties
self	string (uri)	Az entitás helye.
status	Status	Állapot Az API aktuális állapotának ismertetése

DatasetKind

Enumerálás

DatasetKind

Érték	Description
Language	Egy nyelvi adatkészlet.
Acoustic	Akusztikai adatkészlet.
Pronunciation	Kiejtési adatkészlet.
AudioFiles	Hangfájlok adatkészlete.
LanguageMarkdown	Nyelvi Markdown-adatkészlet.
OutputFormatting	Az inverz szöveg normalizálásának, a nagybetűsítésnek, az újraformázásnak, a trágárságnak a testreszabására szolgáló szabályokat tartalmazó adathalmaz, valamint meghatározza az adathalmaz-érvényesítési teszteket is

DatasetLinks

Objektum

DatasetLinks

Name	Típus	Description
commitBlocks	string (uri)	A blokkok listájának véglegesítésének helye egy adathalmaz blokkokkal való feltöltésekor. További részletekért tekintse meg a "Datasets_CommitBlocks" műveletet.
files	string (uri)	Az entitás összes fájljának lekérési helye. További részletekért tekintse meg a "Datasets_ListFiles" műveletet.
listBlocks	string (uri)	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 (uri)	A blokkok feltöltésének helye egy adathalmaz blokkokkal való feltöltésekor. További részletekért tekintse meg a "Datasets_UploadBlock" műveletet.

DatasetProperties

Objektum

DatasetProperties

Name	Típus	Description
acceptedLineCount	integer (int32)	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).
email	string	A művelet befejeződése esetén az e-mail-értesítések küldéséhez szükséges e-mail-cím. Az érték az e-mail sikeres elküldése után törlődik.
error	EntityError	EntityError
rejectedLineCount	integer (int32)	Az adatkészlethez elutasított sorok száma.
textNormalizationKind	TextNormalizationKind	TextNormalizationKind A szöveg normalizálásának típusa.

DetailedErrorCode

Enumerálás

DetailedErrorCode

Érték	Description
InvalidParameterValue	Érvénytelen paraméterérték.
InvalidRequestBodyFormat	Érvénytelen kérelem törzsformátuma.
EmptyRequest	Üres kérelem.
MissingInputRecords	Hiányzó bemeneti rekordok.
InvalidDocument	Érvénytelen dokumentum.
ModelVersionIncorrect	A modell verziója helytelen.
InvalidDocumentBatch	Érvénytelen dokumentumköteg.
UnsupportedLanguageCode	Nem támogatott nyelvi kód.
DataImportFailed	Az adatimportálás nem sikerült.
InUseViolation	Használaton belüli szabálysértés.
InvalidLocale	Érvénytelen területi beállítás.
InvalidBaseModel	Érvénytelen alapmodell.
InvalidAdaptationMapping	Érvénytelen adaptációs leképezés.
InvalidDataset	Érvénytelen adatkészlet.
InvalidTest	Érvénytelen teszt.
FailedDataset	Sikertelen adathalmaz.
InvalidModel	Érvénytelen modell.
InvalidTranscription	Érvénytelen átírás.
InvalidPayload	Érvénytelen hasznos adat.
InvalidParameter	Érvénytelen paraméter.
EndpointWithoutLogging	Végpont naplózás nélkül.
InvalidPermissions	Érvénytelen engedélyek.
InvalidPrerequisite	Érvénytelen előfeltétel.
InvalidProductId	Érvénytelen termékazonosító.
InvalidSubscription	Érvénytelen előfizetés.
InvalidProject	Érvénytelen projekt.
InvalidProjectKind	Érvénytelen projekttípus.
InvalidRecordingsUri	Érvénytelen felvételek uri.
OnlyOneOfUrlsOrContainerOrDataset	Csak egy URL-cím, tároló vagy adatkészlet.
ExceededNumberOfRecordingsUris	Túllépte a felvételek URI-jainak számát.
ModelMismatch	Modelleltérés.
ProjectGenderMismatch	A projekt neme nem egyezik.
ModelDeprecated	A modell elavult.
ModelExists	A modell létezik.
ModelNotDeployable	A modell nem telepíthető.
EndpointNotUpdatable	A végpont nem frissíthető.
SingleDefaultEndpoint	Egyetlen alapértelmezett végpont.
EndpointCannotBeDefault	A végpont nem lehet alapértelmezett.
InvalidModelUri	Érvénytelen modell uri.
SubscriptionNotFound	Az előfizetés nem található.
QuotaViolation	Kvóta megsértése.
UnsupportedDelta	Nem támogatott változás.
UnsupportedFilter	Nem támogatott szűrő.
UnsupportedPagination	Nem támogatott lapozás.
UnsupportedDynamicConfiguration	Nem támogatott dinamikus konfiguráció.
UnsupportedOrderBy	Nem támogatott sorrend szerint.
NoUtf8WithBom	Nincs utf8 a bom.
ModelDeploymentNotCompleteState	A modell üzembe helyezése nem fejeződött be.
SkuLimitsExist	A termékváltozat korlátai léteznek.
DeployingFailedModel	Sikertelen modell üzembe helyezése.
UnsupportedTimeRange	Nem támogatott időtartomány.
InvalidLogDate	Érvénytelen naplódátum.
InvalidLogId	Érvénytelen naplóazonosító.
InvalidLogStartTime	Érvénytelen naplóindítási időpont.
InvalidLogEndTime	Érvénytelen naplóvégzési idő.
InvalidTopForLogs	A naplók felső része érvénytelen.
InvalidSkipTokenForLogs	Érvénytelen kihagyó jogkivonat a naplókhoz.
DeleteNotAllowed	A törlés nem engedélyezett.
Forbidden	Tiltott.
DeployNotAllowed	Az üzembe helyezés nem engedélyezett.
UnexpectedError	Váratlan hiba.
InvalidCollection	Érvénytelen gyűjtemény.
InvalidCallbackUri	Érvénytelen visszahívási uri.
InvalidSasValidityDuration	Érvénytelen sas-érvényességi időtartam.
InaccessibleCustomerStorage	Elérhetetlen ügyféltároló.
UnsupportedClassBasedAdaptation	Nem támogatott osztályalapú adaptáció.
InvalidWebHookEventKind	Érvénytelen webhookesemény-típus.
InvalidTimeToLive	Érvénytelen élettartam.
InvalidSourceAzureResourceId	Érvénytelen forrás Azure-erőforrás-azonosító.
ModelCopyOperationExists	Létezik modellmásolási művelet.

EntityError

Objektum

EntityError

Name	Típus	Description
code	string	A hiba kódja.
message	string	A hiba üzenete.

EntityReference

Objektum

EntityReference

Name	Típus	Description
self	string (uri)	A hivatkozott entitás helye.

Error

Objektum

Hiba

Name	Típus	Description
code	ErrorCode	Hibakód Magas szintű hibakódok.
details	Error[]	További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban.
innerError	InnerError	InnerError Új belső hibaformátum, amely megfelel az https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owcímen elérhető Cognitive Services API-irányelveknek. Ez tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és választható tulajdonságok célértéke, részletek (kulcsértékpár), belső hiba (ez beágyazható).
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

Enumerálás

Hibakód

Érték	Description
InvalidRequest	Az érvénytelen kérés hibakódját jelöli.
InvalidArgument	Az érvénytelen argumentum hibakódját jelöli.
InternalServerError	A belső kiszolgáló hibakódját jelöli.
ServiceUnavailable	A szolgáltatás nem érhető el hibakódjának ábrázolása.
NotFound	A nem található hibakódot jelöli.
PipelineError	A folyamat hibakódjának ábrázolása.
Conflict	Az ütközési hibakódot jelöli.
InternalCommunicationFailed	A belső kommunikáció nem sikerült hibakódját jelöli.
Forbidden	A tiltott hibakódot jelöli.
NotAllowed	A nem engedélyezett hibakódot jelöli.
Unauthorized	A jogosulatlan hibakódot jelöli.
UnsupportedMediaType	A nem támogatott médiatípus hibakódját jelöli.
TooManyRequests	A túl sok kérés hibakódját jelöli.
UnprocessableEntity	A feldolgozhatatlan entitás hibakódját jelöli.

InnerError

Objektum

InnerError

Name	Típus	Description
code	DetailedErrorCode	DetailedErrorCode Részletes hibakód enumerálás.
details	object	További támogató részletek a hibával és/vagy a várt szabályzatokkal kapcsolatban.
innerError	InnerError	InnerError Új belső hibaformátum, amely megfelel az https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owcímen elérhető Cognitive Services API-irányelveknek. Ez tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és választható tulajdonságok célértéke, részletek (kulcsértékpár), belső hiba (ez beágyazható).
message	string	Magas szintű hibaüzenet.
target	string	A hiba forrása. Érvénytelen dokumentum esetén például "dokumentumok" vagy "dokumentumazonosító".

Status

Enumerálás

Állapot

Érték	Description
NotStarted	A hosszú ideig futó művelet még nem indult el.
Running	A hosszú ideig futó művelet jelenleg feldolgozásra kerül.
Succeeded	A hosszú ideig futó művelet sikeresen befejeződött.
Failed	A hosszú ideig futó művelet nem sikerült.

TextNormalizationKind

Enumerálás

TextNormalizationKind

Érték	Description
Default	Az alapértelmezett szöveg normalizálása (például a "2–3" helyett "kettő–három" lép en-US).
None	A program nem alkalmaz szöveg normalizálást a bemeneti szövegre. Ez egy felülbírálási beállítás, amelyet csak akkor érdemes használni, ha a szöveg normalizálása a feltöltés előtt történik.