Condividi tramite

Models - Get File

Servizio:
Azure AI Services
Versione API:
v3.2-preview.2

Ottiene un file specifico (identificato con fileId) da un modello (identificato con ID).

GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}
Con parametri facoltativi: 
GET {endpoint}/speechtotext/v3.2-preview.2/models/{id}/files/{fileId}?sasValidityInSeconds={sasValidityInSeconds}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
 path True

string

Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
fileId
 path True

string (uuid)

Identificatore del file.
id
 path True

string (uuid)

Identificatore del modello.
sasValidityInSeconds
 query

integer (int32)

Durata in secondi in cui deve essere valido un URL di firma di accesso condiviso. La durata predefinita è 12 ore. Quando si usa 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): il valore 0 indica che verrà generato un URI BLOB normale senza token di firma di accesso condiviso.

Risposte

Nome Tipo Descrizione
200 OK

File

Va bene
Other Status Codes

Error

Si è verificato un errore.

Sicurezza

Ocp-Apim-Subscription-Key

Specificare la chiave dell'account di Servizi cognitivi qui.

Tipo: apiKey
In: header

Authorization

Fornire un token di accesso dal token JWT restituito dal servizio token di sicurezza di questa area. Assicurarsi di aggiungere l'ambito di gestione al token aggiungendo la stringa di query seguente all'URL sts: ?scope=speechservicesmanagement

Tipo: apiKey
In: header

Esempio

Get a file

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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"
  }
}

Definizioni

Nome Descrizione
DetailedErrorCode

DetailedErrorCode
Error

Errore
ErrorCode

Codice Errore
File

Documento
FileKind

FileKind
FileLinks

FileLinks
FileProperties

Proprietà file
InnerError

InnerError

DetailedErrorCode

Enumerazione

DetailedErrorCode

Valore Descrizione
InvalidParameterValue

Valore del parametro non valido.
InvalidRequestBodyFormat

Formato del corpo della richiesta non valido.
EmptyRequest

Richiesta vuota.
MissingInputRecords

Record di input mancanti.
InvalidDocument

Documento non valido.
ModelVersionIncorrect

Versione del modello non corretta.
InvalidDocumentBatch

Batch di documenti non valido.
UnsupportedLanguageCode

Codice del linguaggio non supportato.
DataImportFailed

Importazione dei dati non riuscita.
InUseViolation

In violazione dell'uso.
InvalidLocale

Impostazioni locali non valide.
InvalidBaseModel

Modello di base non valido.
InvalidAdaptationMapping

Mapping di adattamento non valido.
InvalidDataset

Set di dati non valido.
InvalidTest

Test non valido.
FailedDataset

Set di dati non riuscito.
InvalidModel

Modello non valido.
InvalidTranscription

Trascrizione non valida.
InvalidPayload

Payload non valido.
InvalidParameter

Parametro non valido.
EndpointWithoutLogging

Endpoint senza registrazione.
InvalidPermissions

Autorizzazioni non valide.
InvalidPrerequisite

Prerequisito non valido.
InvalidProductId

ID prodotto non valido.
InvalidSubscription

Sottoscrizione non valida.
InvalidProject

Progetto non valido.
InvalidProjectKind

Tipo di progetto non valido.
InvalidRecordingsUri

URI delle registrazioni non valido.
OnlyOneOfUrlsOrContainerOrDataset

Solo uno degli URL o del contenitore o del set di dati.
ExceededNumberOfRecordingsUris

È stato superato il numero di URI delle registrazioni.
ModelMismatch

Mancata corrispondenza del modello.
ProjectGenderMismatch

Mancata corrispondenza di genere del progetto.
ModelDeprecated

Modello deprecato.
ModelExists

Il modello esiste.
ModelNotDeployable

Modello non distribuibile.
EndpointNotUpdatable

Endpoint non aggiornabile.
SingleDefaultEndpoint

Singolo endpoint predefinito.
EndpointCannotBeDefault

L'endpoint non può essere predefinito.
InvalidModelUri

URI del modello non valido.
SubscriptionNotFound

Sottoscrizione non trovata.
QuotaViolation

Violazione della quota.
UnsupportedDelta

Delta non supportato.
UnsupportedFilter

Filtro non supportato.
UnsupportedPagination

Impaginazione non supportata.
UnsupportedDynamicConfiguration

Configurazione dinamica non supportata.
UnsupportedOrderBy

Ordine non supportato per.
NoUtf8WithBom

Nessun utf8 con bom.
ModelDeploymentNotCompleteState

Lo stato della distribuzione del modello non è completo.
SkuLimitsExist

Esistono limiti di SKU.
DeployingFailedModel

Distribuzione del modello non riuscito.
UnsupportedTimeRange

Intervallo di tempo non supportato.
InvalidLogDate

Data del log non valida.
InvalidLogId

ID log non valido.
InvalidLogStartTime

Ora di inizio del log non valida.
InvalidLogEndTime

Ora di fine del log non valida.
InvalidTopForLogs

Top non valido per i log.
InvalidSkipTokenForLogs

Token skip non valido per i log.
DeleteNotAllowed

Eliminazione non consentita.
Forbidden

Vietato.
DeployNotAllowed

Distribuzione non consentita.
UnexpectedError

Errore imprevisto.
InvalidCollection

Raccolta non valida.
InvalidCallbackUri

URI di callback non valido.
InvalidSasValidityDuration

Durata della validità della firma di accesso condiviso non valida.
InaccessibleCustomerStorage

Archiviazione dei clienti inaccessibile.
UnsupportedClassBasedAdaptation

Adattamento basato su classe non supportato.
InvalidWebHookEventKind

Tipo di evento web hook non valido.
InvalidTimeToLive

Tempo di vita non valido.
InvalidSourceAzureResourceId

ID risorsa di Azure di origine non valido.
ModelCopyOperationExists

Esiste un'operazione di copia del modello.

Error

Object

Errore

Nome Tipo Descrizione
code

ErrorCode

Codice Errore
Codici di errore di alto livello.
details

Error[]

Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti.
innerError

InnerError

InnerError
Nuovo formato di errore interno conforme alle linee guida dell'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia chiave-valore), errore interno (che può essere annidato).
message

string

Messaggio di errore di alto livello.
target

string

Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.

ErrorCode

Enumerazione

Codice Errore

Valore Descrizione
InvalidRequest

Rappresentazione del codice di errore della richiesta non valido.
InvalidArgument

Rappresentazione del codice di errore dell'argomento non valido.
InternalServerError

Rappresentazione del codice di errore interno del server.
ServiceUnavailable

Rappresentazione del codice di errore del servizio non disponibile.
NotFound

Rappresentazione del codice di errore non trovato.
PipelineError

Rappresentazione del codice di errore della pipeline.
Conflict

Rappresentazione del codice di errore del conflitto.
InternalCommunicationFailed

Rappresentazione del codice di errore della comunicazione interna non riuscita.
Forbidden

Rappresentazione del codice di errore non consentito.
NotAllowed

Rappresentazione del codice di errore non consentito.
Unauthorized

Rappresentazione del codice di errore non autorizzato.
UnsupportedMediaType

Rappresentazione del codice di errore del tipo di supporto non supportato.
TooManyRequests

Rappresentazione del codice di errore troppe richieste.
UnprocessableEntity

Rappresentazione del codice di errore dell'entità non elaborabile.

File

Object

Documento

Nome Tipo Descrizione
createdDateTime

string (date-time)

Ora di creazione del file. Il timestamp è codificato come formato di data e ora ISO 8601 (vedere https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind

FileKind

FileKind
Tipo di dati.
links

FileLinks

FileLinks
name

string

Nome del file.
properties

FileProperties

Proprietà file
self

string (uri)

Posizione dell'entità.

FileKind

Enumerazione

FileKind

Valore Descrizione
DatasetReport

Il tipo di dati è il report del set di dati.
Audio

Il tipo di dati è audio.
LanguageData

Il tipo di dati è dati linguistici.
PronunciationData

Il tipo di dati è dati di pronuncia.
AcousticDataArchive

Il tipo di dati è l'archivio dati acustico.
AcousticDataTranscriptionV2

Il tipo di dati è la trascrizione dei dati acustici v2.
Transcription

Il tipo di dati è la trascrizione.
TranscriptionReport

Il tipo di dati è il report di trascrizione.
EvaluationDetails

Il tipo di dati è dettagli di valutazione.
ModelReport

Il tipo di dati è il report del modello.
OutputFormattingData

Il tipo di dati è il file di input di formattazione dell'output.
Object

FileLinks

Nome Tipo Descrizione
contentUrl

string (uri)

URL per recuperare il contenuto di questo file.

FileProperties

Object

Proprietà file

Nome Tipo Descrizione
duration

string

La durata nel caso in cui questo file sia un file audio. La durata viene codificata come durata ISO 8601 ("PnYnMnDTnHnMnS", vedere https://en.wikipedia.org/wiki/ISO_8601#Durations).
size

integer (int64)

Dimensioni dei dati in byte.

InnerError

Object

InnerError

Nome Tipo Descrizione
code

DetailedErrorCode

DetailedErrorCode
Enumerazione dettagliata del codice di errore.
details

object

Ulteriori dettagli di supporto relativi all'errore e/o ai criteri previsti.
innerError

InnerError

InnerError
Nuovo formato di errore interno conforme alle linee guida dell'API Servizi cognitivi, disponibile in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene le proprietà obbligatorie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia chiave-valore), errore interno (che può essere annidato).
message

string

Messaggio di errore di alto livello.
target

string

Indica l'origine dell'errore. Ad esempio, si tratta di "documenti" o "ID documento" in caso di documento non valido.