Models - Get File

  • Referenz
Dienst:
Azure AI Services
API-Version:
v3.2-preview.2

Ruft eine bestimmte Datei (identifiziert mit fileId) aus einem Modell (identifiziert mit id) ab.

GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}
Mit optionalen Parametern: 
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}?sasValidityInSeconds={sasValidityInSeconds}

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://westus.api.cognitive.microsoft.com
fileId
 path True

string

uuid

Der Bezeichner der Datei.
id
 path True

string

uuid

Der Bezeichner des Modells.
sasValidityInSeconds
 query

integer

int32

Die Dauer in Sekunden, für die eine SAS-URL gültig sein soll. Die Standarddauer beträgt 12 Stunden. Bei Verwendung von BYOS (https://video2.skills-academy.com/en-us/azure/cognitive-services/speech-service/speech-encryption-of-data-at-rest#bring-your-own-storage-byos-for-customization-and-logging): Der Wert 0 bedeutet, dass ein einfacher Blob-URI ohne SAS-Token generiert wird.

Antworten

Name Typ Beschreibung
200 OK

File

OK
Other Status Codes

Error

Ein Fehler ist aufgetreten.

Sicherheit

Ocp-Apim-Subscription-Key

Geben Sie hier Ihren Cognitive Services-Kontoschlüssel an.

Typ: apiKey
In: header

Authorization

Stellen Sie ein Zugriffstoken aus dem JWT bereit, das vom STS dieser Region zurückgegeben wird. Stellen Sie sicher, dass Sie dem Token den Verwaltungsbereich hinzufügen, indem Sie der STS-URL die folgende Abfragezeichenfolge hinzufügen: ?scope=speechservicesmanagement

Typ: apiKey
In: header

Beispiele

Get a file

Beispielanforderung

GET {endpoint}/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files/ee4733cd-b1a7-4813-87e2-00d582c28a29?sasValidityInSeconds=120

Beispiel für eine Antwort

Statuscode:
200 
{
  "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/models/827712a5-f942-4997-91c3-7c6cde35600b/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
  "name": "report.json",
  "kind": "ModelReport",
  "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"
  }
}

Definitionen

Name Beschreibung
DetailedErrorCode

DetailedErrorCode
Error

Fehler
ErrorCode

ErrorCode
File

Datei
FileKind

FileKind
FileLinks

FileLinks
FileProperties

Fileproperties
InnerError

InnerError

DetailedErrorCode

DetailedErrorCode

Name Typ Beschreibung
DataImportFailed

string

Fehler beim Datenimport.
DeleteNotAllowed

string

Löschen nicht zulässig.
DeployNotAllowed

string

Bereitstellen ist nicht zulässig.
DeployingFailedModel

string

Bereitstellen eines fehlerhaften Modells.
EmptyRequest

string

Leere Anforderung.
EndpointCannotBeDefault

string

Der Endpunkt kann nicht standardmäßig sein.
EndpointNotUpdatable

string

Endpunkt nicht aktualisierbar.
EndpointWithoutLogging

string

Endpunkt ohne Protokollierung.
ExceededNumberOfRecordingsUris

string

Die Anzahl der Aufzeichnungsuris wurde überschritten.
FailedDataset

string

Fehlgeschlagenes Dataset.
Forbidden

string

Unzulässig.
InUseViolation

string

In der Nutzungsverletzung.
InaccessibleCustomerStorage

string

Auf den Kundenspeicher kann nicht zugegriffen werden.
InvalidAdaptationMapping

string

Ungültige Anpassungszuordnung.
InvalidBaseModel

string

Ungültiges Basismodell.
InvalidCallbackUri

string

Ungültiger Rückruf-URI.
InvalidCollection

string

Ungültige Auflistung.
InvalidDataset

string

Ungültiges Dataset.
InvalidDocument

string

Ungültiges Dokument.
InvalidDocumentBatch

string

Ungültiger Dokumentbatch.
InvalidLocale

string

Ungültiges Gebietsschema.
InvalidLogDate

string

Ungültiges Protokolldatum.
InvalidLogEndTime

string

Ungültige Protokollendzeit.
InvalidLogId

string

Ungültige Protokoll-ID.
InvalidLogStartTime

string

Ungültige Protokollstartzeit.
InvalidModel

string

Ungültiges Modell.
InvalidModelUri

string

Ungültiger Modell-URI.
InvalidParameter

string

Ungültiger Parameter.
InvalidParameterValue

string

Ungültiger Parameterwert.
InvalidPayload

string

Ungültige Nutzlast.
InvalidPermissions

string

Ungültige Berechtigungen.
InvalidPrerequisite

string

Ungültige Voraussetzung.
InvalidProductId

string

Ungültige Produkt-ID.
InvalidProject

string

Ungültiges Projekt.
InvalidProjectKind

string

Ungültige Projektart.
InvalidRecordingsUri

string

Ungültiger Aufzeichnungs-URI.
InvalidRequestBodyFormat

string

Ungültiges Anforderungstextformat.
InvalidSasValidityDuration

string

Ungültige SAS-Gültigkeitsdauer.
InvalidSkipTokenForLogs

string

Ungültiges Überspringen des Tokens für Protokolle.
InvalidSourceAzureResourceId

string

Ungültige Azure-Quellressourcen-ID.
InvalidSubscription

string

Ungültiges Abonnement.
InvalidTest

string

Ungültiger Test.
InvalidTimeToLive

string

Ungültige Gültigkeitsdauer.
InvalidTopForLogs

string

Ungültiger Anfang für Protokolle.
InvalidTranscription

string

Ungültige Transkription.
InvalidWebHookEventKind

string

Ungültige Webhookereignisart.
MissingInputRecords

string

Fehlende Eingabedatensätze.
ModelCopyOperationExists

string

Modellkopiervorgang ist vorhanden.
ModelDeploymentNotCompleteState

string

Der Status der Modellbereitstellung ist nicht abgeschlossen.
ModelDeprecated

string

Das Modell ist veraltet.
ModelExists

string

Das Modell ist vorhanden.
ModelMismatch

string

Modellkonflikt.
ModelNotDeployable

string

Das Modell kann nicht bereitgestellt werden.
ModelVersionIncorrect

string

Modellversion falsch.
NoUtf8WithBom

string

Kein utf8 mit bom.
OnlyOneOfUrlsOrContainerOrDataset

string

Nur eine der URLs, container oder datasets.
ProjectGenderMismatch

string

Projekt gender mismatch.
QuotaViolation

string

Kontingentverletzung.
SingleDefaultEndpoint

string

Einzelner Standardendpunkt.
SkuLimitsExist

string

SKU-Grenzwerte sind vorhanden.
SubscriptionNotFound

string

Das Abonnement wurde nicht gefunden.
UnexpectedError

string

Unerwarteter Fehler.
UnsupportedClassBasedAdaptation

string

Nicht unterstützte klassenbasierte Anpassung.
UnsupportedDelta

string

Nicht unterstütztes Delta.
UnsupportedDynamicConfiguration

string

Nicht unterstützte dynamische Konfiguration.
UnsupportedFilter

string

Nicht unterstützter Filter.
UnsupportedLanguageCode

string

Nicht unterstützter Sprachcode.
UnsupportedOrderBy

string

Nicht unterstützte Reihenfolge nach.
UnsupportedPagination

string

Nicht unterstützte Paginierung.
UnsupportedTimeRange

string

Nicht unterstützter Zeitbereich.

Error

Fehler

Name Typ Beschreibung
code

ErrorCode

ErrorCode
Allgemeine Fehlercodes.
details

Error[]

Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien.
innerError

InnerError

InnerError
Neues Innere Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar ist. Enthält die erforderlichen Eigenschaften ErrorCode, Message und Optional Properties Target, Details (Key Value Pair), Inner Error (kann geschachtelt werden).
message

string

Allgemeine Fehlermeldung.
target

string

Die Ursache des Fehlers. Dies wäre z. B. „Dokumente“ oder „Dokument-ID“ im Falle eines ungültigen Dokuments.

ErrorCode

ErrorCode

Name Typ Beschreibung
Conflict

string

Stellt den Konfliktfehlercode dar.
Forbidden

string

Stellt den unzulässigen Fehlercode dar.
InternalCommunicationFailed

string

Stellt den fehlerlosen Fehlercode für die interne Kommunikation dar.
InternalServerError

string

Stellt den internen Fehlercode des Servers dar.
InvalidArgument

string

Stellt den Fehlercode des ungültigen Arguments dar.
InvalidRequest

string

Stellt den ungültigen Anforderungsfehlercode dar.
NotAllowed

string

Stellt den nicht zulässigen Fehlercode dar.
NotFound

string

Stellt den nicht gefundenen Fehlercode dar.
PipelineError

string

Stellt den Pipelinefehlerfehlercode dar.
ServiceUnavailable

string

Stellt den nicht verfügbaren Fehlercode des Diensts dar.
TooManyRequests

string

Stellt den Fehlercode für zu viele Anforderungen dar.
Unauthorized

string

Stellt den nicht autorisierten Fehlercode dar.
UnprocessableEntity

string

Stellt den Fehlercode für nicht bearbeitbare Entitäten dar.
UnsupportedMediaType

string

Stellt den Fehlercode für nicht unterstützte Medientypen dar.

File

Datei

Name Typ Beschreibung
createdDateTime

string

Die Erstellungszeit dieser Datei. Der Zeitstempel ist als ISO 8601-Datums- und Uhrzeitformat codiert (siehe https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind

FileKind

FileKind
Datentyp.
links

FileLinks

FileLinks
name

string

Der Name dieser Datei.
properties

FileProperties

Fileproperties
self

string

Der Speicherort dieser Entität.

FileKind

FileKind

Name Typ Beschreibung
AcousticDataArchive

string

Der Typ der Daten ist das Akustikdatenarchiv.
AcousticDataTranscriptionV2

string

Der Datentyp ist die Akustikdatentranskription v2.
Audio

string

Der Typ der Daten ist Audio.
DatasetReport

string

Der Typ der Daten ist ein Datasetbericht.
EvaluationDetails

string

Der Typ der Daten sind Auswertungsdetails.
LanguageData

string

Der Typ der Daten sind Sprachdaten.
ModelReport

string

Der Typ der Daten ist der Modellbericht.
OutputFormattingData

string

Der Typ der Daten ist die Ausgabeformatierungseingabedatei.
PronunciationData

string

Der Typ der Daten sind Aussprachedaten.
Transcription

string

Der Datentyp ist die Transkription.
TranscriptionReport

string

Der Typ der Daten ist der Transkriptionsbericht.

FileLinks

Name Typ Beschreibung
contentUrl

string

Die URL zum Abrufen des Inhalts dieser Datei.

FileProperties

Fileproperties

Name Typ Beschreibung
duration

string

Die Dauer, wenn es sich bei dieser Datei um eine Audiodatei handelt. Die Dauer ist als ISO 8601-Dauer codiert ("PnYnMnDTnHnMnS", siehe https://en.wikipedia.org/wiki/ISO_8601#Durations).
size

integer

Die Größe der Daten in Bytes.

InnerError

InnerError

Name Typ Beschreibung
code

DetailedErrorCode

DetailedErrorCode
Detaillierte Fehlercodeenume.
details

object

Zusätzliche unterstützende Details zum Fehler und/oder zu den erwarteten Richtlinien.
innerError

InnerError

InnerError
Neues Innere Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar ist. Enthält die erforderlichen Eigenschaften ErrorCode, Message und Optional Properties Target, Details (Key Value Pair), Inner Error (kann geschachtelt werden).
message

string

Allgemeine Fehlermeldung.
target

string

Die Ursache des Fehlers. Dies wäre z. B. „Dokumente“ oder „Dokument-ID“ im Falle eines ungültigen Dokuments.