Sdílet prostřednictvím

Evaluations - Get File

Služba:
Azure AI Services
Verze rozhraní API:
v3.2-preview.2

Získá jeden konkrétní soubor (identifikovaný pomocí fileId) z vyhodnocení (identifikovaný s ID).

GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}/files/{fileId}
S volitelnými parametry: 
GET {endpoint}/speechtotext/v3.2-preview.2/evaluations/{id}/files/{fileId}?sasValidityInSeconds={sasValidityInSeconds}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
fileId
 path True

string (uuid)

Identifikátor souboru.
id
 path True

string (uuid)

Identifikátor vyhodnocení.
sasValidityInSeconds
 query

integer (int32)

Doba trvání v sekundách, po kterou má být adresa URL SAS platná. Výchozí doba trvání je 12 hodin. Při použití funkce 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): Hodnota 0 znamená, že se vygeneruje identifikátor URI prostého objektu blob bez tokenu SAS.

Odpovědi

Name Typ Description
200 OK

File

OK
Other Status Codes

Error

Došlo k chybě.

Zabezpečení

Ocp-Apim-Subscription-Key

Tady zadejte svůj klíč účtu služeb Cognitive Services.

Typ: apiKey
V: header

Authorization

Zadejte přístupový token z JWT vráceného službou STS této oblasti. Nezapomeňte do tokenu přidat obor správy přidáním následujícího řetězce dotazu do adresy URL služby STS: ?scope=speechservicesmanagement

Typ: apiKey
V: header

Příklady

Get a file

Ukázkový požadavek

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

Ukázková odpověď

Stavový kó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"
  }
}

Definice

Name Description
DetailedErrorCode

DetailedErrorCode
Error

Chyba
ErrorCode

Kód chyby
File

Soubor
FileKind

FileKind
FileLinks

FileLinks
FileProperties

FileProperties
InnerError

Vnitřní chyba

DetailedErrorCode

Výčet

DetailedErrorCode

Hodnota Description
InvalidParameterValue

Neplatná hodnota parametru
InvalidRequestBodyFormat

Neplatný formát textu požadavku
EmptyRequest

Prázdný požadavek.
MissingInputRecords

Chybí vstupní záznamy.
InvalidDocument

Neplatný dokument
ModelVersionIncorrect

Verze modelu není správná.
InvalidDocumentBatch

Neplatná dávka dokumentu
UnsupportedLanguageCode

Nepodporovaný kód jazyka
DataImportFailed

Import dat se nezdařil.
InUseViolation

V narušení používání.
InvalidLocale

Neplatné národní prostředí
InvalidBaseModel

Neplatný základní model
InvalidAdaptationMapping

Neplatné mapování adaptací
InvalidDataset

Neplatná datová sada
InvalidTest

Neplatný test.
FailedDataset

Datová sada se nezdařila.
InvalidModel

Neplatný model.
InvalidTranscription

Neplatný přepis
InvalidPayload

Neplatná datová část
InvalidParameter

Neplatný parametr.
EndpointWithoutLogging

Koncový bod bez protokolování
InvalidPermissions

Neplatná oprávnění
InvalidPrerequisite

Neplatný požadavek.
InvalidProductId

Neplatné ID produktu
InvalidSubscription

Neplatné předplatné
InvalidProject

Neplatný projekt.
InvalidProjectKind

Neplatný druh projektu.
InvalidRecordingsUri

Identifikátor URI pro neplatné nahrávky
OnlyOneOfUrlsOrContainerOrDataset

Pouze jedna z adres URL nebo kontejneru nebo datové sady.
ExceededNumberOfRecordingsUris

Byl překročen počet nahrávek.
ModelMismatch

Neshoda modelů
ProjectGenderMismatch

Neshoda pohlaví projektu
ModelDeprecated

Model je zastaralý.
ModelExists

Model existuje.
ModelNotDeployable

Model nejde nasadit.
EndpointNotUpdatable

Koncový bod nejde aktualizovat.
SingleDefaultEndpoint

Jeden výchozí koncový bod
EndpointCannotBeDefault

Koncový bod nemůže být výchozí.
InvalidModelUri

Neplatný identifikátor URI modelu
SubscriptionNotFound

Předplatné se nenašlo.
QuotaViolation

Porušení kvóty
UnsupportedDelta

Nepodporovaný rozdíl.
UnsupportedFilter

Nepodporovaný filtr
UnsupportedPagination

Nepodporované stránkování
UnsupportedDynamicConfiguration

Nepodporovaná dynamická konfigurace
UnsupportedOrderBy

Nepodporované pořadí podle.
NoUtf8WithBom

Žádné utf8 s bom.
ModelDeploymentNotCompleteState

Nasazení modelu není dokončeno.
SkuLimitsExist

Existují omezení skladové položky.
DeployingFailedModel

Nasazení neúspěšného modelu
UnsupportedTimeRange

Nepodporovaný časový rozsah
InvalidLogDate

Neplatné datum protokolu
InvalidLogId

Neplatné ID protokolu
InvalidLogStartTime

Neplatný čas spuštění protokolu
InvalidLogEndTime

Neplatný čas ukončení protokolu
InvalidTopForLogs

Neplatný horní okraj pro protokoly.
InvalidSkipTokenForLogs

Neplatný token pro přeskočení protokolů
DeleteNotAllowed

Odstranění není povoleno.
Forbidden

Zakázaný.
DeployNotAllowed

Nasazení není povoleno.
UnexpectedError

Neočekávaná chyba
InvalidCollection

Neplatná kolekce.
InvalidCallbackUri

Neplatný identifikátor URI zpětného volání.
InvalidSasValidityDuration

Neplatná doba platnosti SAS.
InaccessibleCustomerStorage

Nepřístupné úložiště zákazníka
UnsupportedClassBasedAdaptation

Nepodporovaná úprava založená na třídách.
InvalidWebHookEventKind

Neplatný druh události webhooku
InvalidTimeToLive

Neplatný čas naživo.
InvalidSourceAzureResourceId

Neplatné ID zdroje prostředku Azure
ModelCopyOperationExists

Operace kopírování modelu existuje.

Error

Objekt

Chyba

Name Typ Description
code

ErrorCode

Kód chyby
Kódy chyb vysoké úrovně.
details

Error[]

Další podrobnosti podpory týkající se chyb a/nebo očekávaných zásad
innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, který odpovídá pokynům rozhraní API služeb Cognitive Services, které jsou k dispozici v https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message and optional properties target, details(key value pair), inner error(this can be vnořováno).
message

string

Chybová zpráva vysoké úrovně
target

string

Zdroj chyby. Například v případě neplatného dokumentu by to bylo "dokumenty" nebo "ID dokumentu".

ErrorCode

Výčet

Kód chyby

Hodnota Description
InvalidRequest

Představuje neplatný kód chyby požadavku.
InvalidArgument

Představuje neplatný kód chyby argumentu.
InternalServerError

Představuje kód chyby vnitřní chyby serveru.
ServiceUnavailable

Představuje kód chyby nedostupné služby.
NotFound

Představuje kód chyby, který nebyl nalezen.
PipelineError

Představuje kód chyby kanálu.
Conflict

Představuje kód chyby konfliktu.
InternalCommunicationFailed

Představuje kód chyby selhání interní komunikace.
Forbidden

Představuje zakázaný kód chyby.
NotAllowed

Představuje kód chyby, který není povolený.
Unauthorized

Představuje neautorizovaný kód chyby.
UnsupportedMediaType

Představuje nepodporovaný kód chyby typu média.
TooManyRequests

Představuje kód chyby příliš velkého počtu požadavků.
UnprocessableEntity

Představuje nezpracovaný kód chyby entity.

File

Objekt

Soubor

Name Typ Description
createdDateTime

string (date-time)

Čas vytvoření tohoto souboru. Časové razítko je kódováno jako formát data a času ISO 8601 (viz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind

FileKind

FileKind
Typ dat
links

FileLinks

FileLinks
name

string

Název tohoto souboru.
properties

FileProperties

FileProperties
self

string (uri)

Umístění této entity.

FileKind

Výčet

FileKind

Hodnota Description
DatasetReport

Typ dat je sestava datové sady.
Audio

Typ dat je zvuk.
LanguageData

Typ dat je jazyková data.
PronunciationData

Typ dat je výslovnost dat.
AcousticDataArchive

Typ dat je archiv akustických dat.
AcousticDataTranscriptionV2

Typ dat je přepis akustických dat v2.
Transcription

Typ dat je přepis.
TranscriptionReport

Typ dat je sestava přepisu.
EvaluationDetails

Typ dat je podrobnosti vyhodnocení.
ModelReport

Typ dat je sestava modelu.
OutputFormattingData

Typ dat je výstupní formát vstupního souboru.
Objekt

FileLinks

Name Typ Description
contentUrl

string (uri)

Adresa URL pro načtení obsahu tohoto souboru.

FileProperties

Objekt

FileProperties

Name Typ Description
duration

string

Doba trvání v případě, že se jedná o zvukový soubor. Doba trvání je kódována jako ISO 8601 duration ("PnYnMnDTnHnMnS", viz https://en.wikipedia.org/wiki/ISO_8601#Durations).
size

integer (int64)

Velikost dat vbajch

InnerError

Objekt

Vnitřní chyba

Name Typ Description
code

DetailedErrorCode

DetailedErrorCode
Podrobný výčet kódu chyby
details

object

Další podrobnosti podpory týkající se chyb a/nebo očekávaných zásad
innerError

InnerError

Vnitřní chyba
Nový formát vnitřní chyby, který odpovídá pokynům rozhraní API služeb Cognitive Services, které jsou k dispozici v https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Obsahuje požadované vlastnosti ErrorCode, message and optional properties target, details(key value pair), inner error(this can be vnořováno).
message

string

Chybová zpráva vysoké úrovně
target

string

Zdroj chyby. Například v případě neplatného dokumentu by to bylo "dokumenty" nebo "ID dokumentu".