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

Evaluations - Get File

  • Referencia
Szolgáltatás:
Azure AI Services
API-verzió:
v3.2-preview.2

Lekér egy adott fájlt (a fileId azonosítóval azonosítva) egy kiértékelésből (azonosítóval azonosítva).

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}/files/{fileId}
Opcionális paraméterekkel: 
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{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)

A kiértékelés 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 egy 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 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 file

Mintakérelem

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6/files/ee4733cd-b1a7-4813-87e2-00d582c28a29?sasValidityInSeconds=120

Mintaválasz

Állapotkód:
200 
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/evaluations/1c50ce42-6ab7-454f-8c39-54a752d1a5b6/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
  "name": "mywavefile1.wav.model2_score.json",
  "kind": "EvaluationDetails",
  "properties": {
    "size": 200
  },
  "createdDateTime": "2020-01-13T08:00:00Z",
  "links": {
    "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/mywavefile1.wav.model2_score.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

Hibakód
File

Fájl
FileKind

FileKind
FileLinks

FileLinks
FileProperties

FileProperties
InnerError

InnerError

DetailedErrorCode

Enumerálás

DetailedErrorCode

Érték Description
DataImportFailed

Az adatimportálás nem sikerült.
DeleteNotAllowed

A törlés nem engedélyezett.
DeployNotAllowed

Az üzembe helyezés nem engedélyezett.
DeployingFailedModel

Sikertelen modell üzembe helyezése.
EmptyRequest

Üres kérelem.
EndpointCannotBeDefault

A végpont nem lehet alapértelmezett.
EndpointNotUpdatable

A végpont nem frissíthető.
EndpointWithoutLogging

Végpont naplózás nélkül.
ExceededNumberOfRecordingsUris

Túllépte a felvételek URI-jainak számát.
FailedDataset

Sikertelen adathalmaz.
Forbidden

Tiltott.
InUseViolation

Használaton belüli szabálysértés.
InaccessibleCustomerStorage

Elérhetetlen ügyféltároló.
InvalidAdaptationMapping

Érvénytelen adaptációs leképezés.
InvalidBaseModel

Érvénytelen alapmodell.
InvalidCallbackUri

Érvénytelen visszahívási uri.
InvalidCollection

Érvénytelen gyűjtemény.
InvalidDataset

Érvénytelen adatkészlet.
InvalidDocument

Érvénytelen dokumentum.
InvalidDocumentBatch

Érvénytelen dokumentumköteg.
InvalidLocale

Érvénytelen területi beállítás.
InvalidLogDate

Érvénytelen naplódátum.
InvalidLogEndTime

Érvénytelen naplóvégzési idő.
InvalidLogId

Érvénytelen naplóazonosító.
InvalidLogStartTime

Érvénytelen naplóindítási időpont.
InvalidModel

Érvénytelen modell.
InvalidModelUri

Érvénytelen modell uri.
InvalidParameter

Érvénytelen paraméter.
InvalidParameterValue

Érvénytelen paraméterérték.
InvalidPayload

Érvénytelen hasznos adat.
InvalidPermissions

Érvénytelen engedélyek.
InvalidPrerequisite

Érvénytelen előfeltétel.
InvalidProductId

Érvénytelen termékazonosító.
InvalidProject

Érvénytelen projekt.
InvalidProjectKind

Érvénytelen projekttípus.
InvalidRecordingsUri

Érvénytelen felvételek uri.
InvalidRequestBodyFormat

Érvénytelen kérelem törzsformátuma.
InvalidSasValidityDuration

Érvénytelen sas-érvényességi időtartam.
InvalidSkipTokenForLogs

Érvénytelen kihagyó jogkivonat a naplókhoz.
InvalidSourceAzureResourceId

Érvénytelen forrás Azure-erőforrás-azonosító.
InvalidSubscription

Érvénytelen előfizetés.
InvalidTest

Érvénytelen teszt.
InvalidTimeToLive

Érvénytelen élettartam.
InvalidTopForLogs

A naplók felső része érvénytelen.
InvalidTranscription

Érvénytelen átírás.
InvalidWebHookEventKind

Érvénytelen webhookesemény-típus.
MissingInputRecords

Hiányzó bemeneti rekordok.
ModelCopyOperationExists

Létezik modellmásolási művelet.
ModelDeploymentNotCompleteState

A modell üzembe helyezése nem fejeződött be.
ModelDeprecated

A modell elavult.
ModelExists

A modell létezik.
ModelMismatch

Modelleltérés.
ModelNotDeployable

A modell nem telepíthető.
ModelVersionIncorrect

A modell verziója helytelen.
NoUtf8WithBom

Nincs utf8 a bom.
OnlyOneOfUrlsOrContainerOrDataset

Csak egy URL-cím, tároló vagy adatkészlet.
ProjectGenderMismatch

A projekt neme nem egyezik.
QuotaViolation

Kvóta megsértése.
SingleDefaultEndpoint

Egyetlen alapértelmezett végpont.
SkuLimitsExist

A termékváltozat korlátai léteznek.
SubscriptionNotFound

Az előfizetés nem található.
UnexpectedError

Váratlan hiba.
UnsupportedClassBasedAdaptation

Nem támogatott osztályalapú adaptáció.
UnsupportedDelta

Nem támogatott változás.
UnsupportedDynamicConfiguration

Nem támogatott dinamikus konfiguráció.
UnsupportedFilter

Nem támogatott szűrő.
UnsupportedLanguageCode

Nem támogatott nyelvi kód.
UnsupportedOrderBy

Nem támogatott sorrend szerint.
UnsupportedPagination

Nem támogatott lapozás.
UnsupportedTimeRange

Nem támogatott időtartomány.

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
Conflict

Az ütközési hibakódot jelöli.
Forbidden

A tiltott hibakódot jelöli.
InternalCommunicationFailed

A belső kommunikáció nem sikerült hibakódját jelöli.
InternalServerError

A belső kiszolgáló hibakódját jelöli.
InvalidArgument

Az érvénytelen argumentum hibakódját jelöli.
InvalidRequest

Az érvénytelen kérés hibakódját jelöli.
NotAllowed

A nem engedélyezett hibakódot jelöli.
NotFound

A nem található hibakódot jelöli.
PipelineError

A folyamat hibakódjának ábrázolása.
ServiceUnavailable

A szolgáltatás nem érhető el hibakódjának ábrázolása.
TooManyRequests

A túl sok kérés hibakódját jelöli.
Unauthorized

A jogosulatlan hibakódot jelöli.
UnprocessableEntity

A feldolgozhatatlan entitás hibakódját jelöli.
UnsupportedMediaType

A nem támogatott médiatípus hibakódját jelöli.

File

Objektum

Fájl

Name Típus Description
createdDateTime

string (date-time)

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

FileLinks
name

string

A fájl neve.
properties

FileProperties

FileProperties
self

string (uri)

Az entitás helye.

FileKind

Enumerálás

FileKind

Érték Description
AcousticDataArchive

Az adatok típusa az akusztikai adatarchívum.
AcousticDataTranscriptionV2

Az adatok típusa az akusztikai adatátírás v2.
Audio

Az adatok típusa hang.
DatasetReport

Az adattípus adathalmaz-jelentés.
EvaluationDetails

Az adatok típusa a kiértékelési részletek.
LanguageData

Az adatok típusa a nyelvi adatok.
ModelReport

Az adatok típusa modelljelentés.
OutputFormattingData

Az adatok típusa a bemeneti fájl kimeneti formázása.
PronunciationData

Az adatok típusa kiejtési adatok.
Transcription

Az adatok típusa átírás.
TranscriptionReport

Az adatok típusa átírási jelentés.
Objektum

FileLinks

Name Típus Description
contentUrl

string (uri)

A fájl tartalmának lekéréséhez tartozó URL-cím.

FileProperties

Objektum

FileProperties

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 (int64)

Az adatok mérete bájtban.

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ó".