Datasets - Get File

Referencia

Szolgáltatás:: Azure AI Services

API-verzió:: 3.2

Lekér egy adott (fileId azonosítóval azonosított) fájlt egy (azonosítóval azonosított) adatkészletből.

GET {endpoint}/speechtotext/v3.2/datasets/{id}/files/{fileId}

Opcionális paraméterekkel:

GET {endpoint}/speechtotext/v3.2/datasets/{id}/files/{fileId}?sasValidityInSeconds={sasValidityInSeconds}

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).
fileId	path	True	string uuid	A fájl azonosítója.
id	path	True	string uuid	Az adathalmaz azonosítója.
sasValidityInSeconds	query		integer int32	Az SAS URL-cím érvényességének időtartama másodpercben. Az alapértelmezett időtartam 12 óra. 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): A 0 érték azt jelenti, hogy sas jogkivonat nélküli egyszerű blob URI jön létre.

Válaszok

Name	Típus	Description
200 OK	File	OK
Other Status Codes	Error	Hiba történt.

Biztonság

Ocp-Apim-Subscription-Key

Itt adhatja 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. Ehhez adja hozzá 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 file

Mintakérelem

HTTP

GET {endpoint}/speechtotext/v3.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files/ee4733cd-b1a7-4813-87e2-00d582c28a29?sasValidityInSeconds=120

Mintaválasz

Állapotkód:: 200

{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
  "name": "report.json",
  "kind": "DatasetReport",
  "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"
  }
}

Definíciók

Name	Description
DetailedErrorCode	DetailedErrorCode
Error	Hiba
ErrorCode	ErrorCode
File	Fájl
FileKind	FileKind
FileLinks	Fájlhivatkozások
FileProperties	Fájltulajdonságok
InnerError	InnerError

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	Nem érhető el az ü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.
InvalidChannels	string	Érvénytelen csatornák.
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 naplóvégzési idő.
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.
ModelCopyAuthorizationExpired	string	Lejárt ModelCopyAuthorization.
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.

Error

Hiba

Name	Típus	Description
code	ErrorCode	ErrorCode 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 a Cognitive Services API-irányelveinek, amely a címen https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owérhető el. 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

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.

File

Fájl

Name	Típus	Description
createdDateTime	string	A fájl létrehozási ideje. Az időbélyeg ISO 8601 dátum- és időformátumként van kódolva (lásd: https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind	FileKind	FileKind Adattípus.
links	FileLinks	Fájlhivatkozások
name	string	A fájl neve.
properties	FileProperties	Fájltulajdonságok
self	string	Az entitás helye.

FileKind

Name	Típus	Description
AcousticDataArchive	string	Az adatok típusa az akusztikai adatarchívum.
AcousticDataTranscriptionV2	string	Az adatok típusa az akusztikai adatátírás v2.
Audio	string	Az adatok típusa hang.
DatasetReport	string	Az adattípus adathalmaz-jelentés.
EvaluationDetails	string	Az adatok típusa a kiértékelési adatok.
LanguageData	string	Az adatok típusa a nyelvi adatok.
ModelReport	string	Az adatok típusa modelljelentés.
OutputFormattingData	string	Az adatok típusa a bemeneti fájl kimeneti formázása.
PronunciationData	string	Az adatok típusa a kiejtési adatok.
Transcription	string	Az adatok típusa az átírás.
TranscriptionReport	string	Az adatok típusa átírási jelentés.

FileLinks

Fájlhivatkozások

Name	Típus	Description
contentUrl	string	A fájl tartalmának lekéréséhez tartozó URL-cím.

FileProperties

Fájltulajdonságok

Name	Típus	Description
duration	string	Az időtartam, ha ez a fájl hangfájl. Az időtartam ISO 8601-es időtartamként van kódolva ("PnYnMnDTnHnMnS", lásd: https://en.wikipedia.org/wiki/ISO_8601#Durations).
size	integer	Az adatok mérete bájtban.

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 a Cognitive Services API-irányelveinek, amely a címen https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owérhető el. 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ó".

Megosztás a következőn keresztül: