Delen via

Models - Get File

  • Referentie
Service:
Azure AI Services
API-versie:
v3.2-preview.2

Hiermee haalt u één specifiek bestand op (geïdentificeerd met fileId) van een model (geïdentificeerd met id).

GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}
Met optionele parameters: 
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}?sasValidityInSeconds={sasValidityInSeconds}

URI-parameters

Name In Vereist Type Description
endpoint
 path True

string

Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
fileId
 path True

string (uuid)

De id van het bestand.
id
 path True

string (uuid)

De id van het model.
sasValidityInSeconds
 query

integer (int32)

De duur in seconden dat een SAS-URL geldig moet zijn. De standaardduur is 12 uur. Wanneer u 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): Een waarde van 0 betekent dat een gewone blob-URI zonder SAS-token wordt gegenereerd.

Antwoorden

Name Type Description
200 OK

File

OK
Other Status Codes

Error

Er is een fout opgetreden.

Beveiliging

Ocp-Apim-Subscription-Key

Geef hier de sleutel van uw Cognitive Services-account op.

Type: apiKey
In: header

Authorization

Geef een toegangstoken op van de JWT die wordt geretourneerd door de STS van deze regio. Zorg ervoor dat u het beheerbereik aan het token toevoegt door de volgende querytekenreeks toe te voegen aan de STS-URL: ?scope=speechservicesmanagement

Type: apiKey
In: header

Voorbeelden

Get a file

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
DetailedErrorCode

DetailedErrorCode
Error

Fout
ErrorCode

ErrorCode
File

Bestand
FileKind

FileKind
FileLinks

FileLinks
FileProperties

FileProperties
InnerError

InnerError

DetailedErrorCode

Inventarisatie

DetailedErrorCode

Waarde Description
DataImportFailed

Het importeren van gegevens is mislukt.
DeleteNotAllowed

Verwijderen is niet toegestaan.
DeployNotAllowed

Implementeren is niet toegestaan.
DeployingFailedModel

Het implementeren van een mislukt model.
EmptyRequest

Lege aanvraag.
EndpointCannotBeDefault

Eindpunt kan niet standaard zijn.
EndpointNotUpdatable

Eindpunt kan niet worden bijgewerkt.
EndpointWithoutLogging

Eindpunt zonder logboekregistratie.
ExceededNumberOfRecordingsUris

Het aantal opnamen is overschreden.
FailedDataset

Mislukte gegevensset.
Forbidden

Verboden.
InUseViolation

Schending van gebruik.
InaccessibleCustomerStorage

Niet-toegankelijke opslag van klanten.
InvalidAdaptationMapping

Ongeldige aanpassingstoewijzing.
InvalidBaseModel

Ongeldig basismodel.
InvalidCallbackUri

Ongeldige callback-URI.
InvalidCollection

Ongeldige verzameling.
InvalidDataset

Ongeldige gegevensset.
InvalidDocument

Ongeldig document.
InvalidDocumentBatch

Ongeldige documentbatch.
InvalidLocale

Ongeldige landinstelling.
InvalidLogDate

Ongeldige logboekdatum.
InvalidLogEndTime

Ongeldige eindtijd van logboek.
InvalidLogId

Ongeldige logboek-id.
InvalidLogStartTime

Ongeldige begintijd voor logboeken.
InvalidModel

Ongeldig model.
InvalidModelUri

Ongeldige model-URI.
InvalidParameter

Ongeldige parameter.
InvalidParameterValue

Ongeldige parameterwaarde.
InvalidPayload

Ongeldige nettolading.
InvalidPermissions

Ongeldige machtigingen.
InvalidPrerequisite

Ongeldige vereiste.
InvalidProductId

Ongeldige product-id.
InvalidProject

Ongeldig project.
InvalidProjectKind

Ongeldig projecttype.
InvalidRecordingsUri

Ongeldige opnamen-URI.
InvalidRequestBodyFormat

Ongeldige indeling voor de hoofdtekst van de aanvraag.
InvalidSasValidityDuration

Ongeldige geldigheidsduur van SAS.
InvalidSkipTokenForLogs

Ongeldig skip-token voor logboeken.
InvalidSourceAzureResourceId

Ongeldige azure-bronresource-id.
InvalidSubscription

Ongeldig abonnement.
InvalidTest

Ongeldige test.
InvalidTimeToLive

Ongeldige time to live.
InvalidTopForLogs

Ongeldig bovenaan voor logboeken.
InvalidTranscription

Ongeldige transcriptie.
InvalidWebHookEventKind

Ongeldig gebeurtenistype webhook.
MissingInputRecords

Ontbrekende invoerrecords.
ModelCopyOperationExists

Er bestaat een modelkopiebewerking.
ModelDeploymentNotCompleteState

Modelimplementatie is niet voltooid.
ModelDeprecated

Model afgeschaft.
ModelExists

Het model bestaat.
ModelMismatch

Model komt niet overeen.
ModelNotDeployable

Model kan niet worden geïmplementeerd.
ModelVersionIncorrect

Modelversie onjuist.
NoUtf8WithBom

Geen utf8 met bom.
OnlyOneOfUrlsOrContainerOrDataset

Slechts één van url's of containers of gegevenssets.
ProjectGenderMismatch

Project geslacht komt niet overeen.
QuotaViolation

Quotumschending.
SingleDefaultEndpoint

Eén standaardeindpunt.
SkuLimitsExist

Er bestaan SKU-limieten.
SubscriptionNotFound

Abonnement is niet gevonden.
UnexpectedError

Onverwachte fout.
UnsupportedClassBasedAdaptation

Niet-ondersteunde aanpassing op basis van klassen.
UnsupportedDelta

Niet-ondersteunde delta.
UnsupportedDynamicConfiguration

Niet-ondersteunde dynamische configuratie.
UnsupportedFilter

Niet-ondersteund filter.
UnsupportedLanguageCode

Niet-ondersteunde taalcode.
UnsupportedOrderBy

Niet-ondersteunde volgorde door.
UnsupportedPagination

Niet-ondersteunde paginering.
UnsupportedTimeRange

Niet-ondersteund tijdsbereik.

Error

Object

Fout

Name Type Description
code

ErrorCode

ErrorCode
Foutcodes op hoog niveau.
details

Error[]

Aanvullende ondersteunende informatie over de fout en/of het verwachte beleid.
innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de Richtlijnen voor de Cognitive Services-API die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat vereiste eigenschappen ErrorCode, bericht en optionele eigenschappendoel, details (sleutelwaardepaar), interne fout (dit kan worden genest).
message

string

Foutbericht op hoog niveau.
target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.

ErrorCode

Inventarisatie

ErrorCode

Waarde Description
Conflict

Vertegenwoordiging van de conflictfoutcode.
Forbidden

Vertegenwoordiging van de verboden foutcode.
InternalCommunicationFailed

De foutcode voor de interne communicatie is mislukt.
InternalServerError

De foutcode van de interne server vertegenwoordigt.
InvalidArgument

De foutcode van het ongeldige argument vertegenwoordigt.
InvalidRequest

De foutcode van de ongeldige aanvraag vertegenwoordigt.
NotAllowed

Vertegenwoordiging van de niet-toegestane foutcode.
NotFound

De foutcode wordt niet gevonden.
PipelineError

De foutcode van de pijplijnfout weergeven.
ServiceUnavailable

Vertegenwoordiging van de service niet-beschikbare foutcode.
TooManyRequests

De foutcode voor te veel aanvragen vertegenwoordigt.
Unauthorized

Vertegenwoordiging van de niet-geautoriseerde foutcode.
UnprocessableEntity

De foutcode van de niet-verwerkte entiteit vertegenwoordigt.
UnsupportedMediaType

De foutcode van het niet-ondersteunde mediatype vertegenwoordigt.

File

Object

Bestand

Name Type Description
createdDateTime

string (date-time)

De aanmaaktijd van dit bestand. De tijdstempel wordt gecodeerd als ISO 8601-datum- en tijdnotatie (zie https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind

FileKind

FileKind
Type gegevens.
links

FileLinks

FileLinks
name

string

De naam van dit bestand.
properties

FileProperties

FileProperties
self

string (uri)

De locatie van deze entiteit.

FileKind

Inventarisatie

FileKind

Waarde Description
AcousticDataArchive

Het type gegevens is akoestisch gegevensarchief.
AcousticDataTranscriptionV2

Het type gegevens is akoestische gegevenstranscriptie v2.
Audio

Het type gegevens is audio.
DatasetReport

Het type gegevens is een gegevenssetrapport.
EvaluationDetails

Het type gegevens is evaluatiedetails.
LanguageData

Het type gegevens is taalgegevens.
ModelReport

Het type gegevens is een modelrapport.
OutputFormattingData

Het type gegevens is het invoerbestand voor uitvoeropmaak.
PronunciationData

Het type gegevens is uitspraakgegevens.
Transcription

Het type gegevens is transcriptie.
TranscriptionReport

Het type gegevens is een transcriptierapport.
Object

FileLinks

Name Type Description
contentUrl

string (uri)

De URL voor het ophalen van de inhoud van dit bestand.

FileProperties

Object

FileProperties

Name Type Description
duration

string

De duur voor het geval dit bestand een audiobestand is. De duur wordt gecodeerd als ISO 8601-duur ('PnYnMnDTnHnMnS', zie https://en.wikipedia.org/wiki/ISO_8601#Durations).
size

integer (int64)

De grootte van de gegevens in bytes.

InnerError

Object

InnerError

Name Type Description
code

DetailedErrorCode

DetailedErrorCode
Gedetailleerde opsomming van foutcodes.
details

object

Aanvullende ondersteunende informatie over de fout en/of het verwachte beleid.
innerError

InnerError

InnerError
Nieuwe indeling voor interne fouten die voldoet aan de Richtlijnen voor de Cognitive Services-API die beschikbaar zijn op https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Dit bevat vereiste eigenschappen ErrorCode, bericht en optionele eigenschappendoel, details (sleutelwaardepaar), interne fout (dit kan worden genest).
message

string

Foutbericht op hoog niveau.
target

string

De bron van de fout. Dit is bijvoorbeeld 'documenten' of 'document-id' in het geval van een ongeldig document.