Datasets - List Files

Riferimento

Servizio:: Azure AI Services

Versione API:: v3.2-preview.2

Ottiene i file del set di dati identificato dall'ID specificato.

GET {endpoint}/speechtotext/v3.2-preview.2/datasets/{id}/files

Con parametri facoltativi:

GET {endpoint}/speechtotext/v3.2-preview.2/datasets/{id}/files?sasValidityInSeconds={sasValidityInSeconds}&skip={skip}&top={top}&filter={filter}

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).
id	path	True	string uuid	Identificatore del set di dati.
filter	query		string	Espressione di filtro per la selezione di un subset dei file disponibili. `- Supported properties: name, createdDateTime, kind. - Operators: - eq, ne are supported for all properties. - gt, ge, lt, le are supported for createdDateTime. - and, or, not are supported. - Example: filter=name eq 'myaudio.wav' and kind eq 'Audio'`
sasValidityInSeconds	query		integer int32	Durata in secondi in cui deve essere valido un URL di firma di accesso condiviso. La durata predefinita è di 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): un valore pari a 0 significa che verrà generato un URI BLOB normale senza token di firma di accesso condiviso.
skip	query		integer int32	Numero di set di dati che verranno ignorati.
top	query		integer int32	Numero di set di dati che verranno inclusi dopo aver ignorato.

Risposte

Nome	Tipo	Descrizione
200 OK	PaginatedFiles	OK Intestazioni Retry-After: integer
Other Status Codes	Error	Si è verificato un errore.

Nome

Tipo

Descrizione

200 OK

PaginatedFiles

Intestazioni

Retry-After: integer

Other Status Codes

Error

Si è verificato un errore.

Sicurezza

Ocp-Apim-Subscription-Key

Specificare qui la chiave dell'account dei servizi cognitivi.

Tipo: apiKey
In: header

Authorization

Fornire un token di accesso dal JWT restituito dal servizio 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 all dataset report files

Get all files

Get all dataset report files

Esempio di richiesta

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files?sasValidityInSeconds=120&skip=0&top=10&filter=kind%20eq%20'DatasetReport'

Risposta di esempio

Codice di stato:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "report.json",
      "kind": "DatasetReport",
      "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"
      }
    }
  ]
}

Get all files

Esempio di richiesta

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files?sasValidityInSeconds=120&skip=0&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z

Risposta di esempio

Codice di stato:: 200

{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files/ee4733cd-b1a7-4813-87e2-00d582c28a29",
      "name": "report.json",
      "kind": "DatasetReport",
      "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"
      }
    },
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files/f035cf2d-4051-4131-85e7-97e3a7349c86",
      "name": "language_data.txt",
      "kind": "LanguageData",
      "properties": {
        "size": 200
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/language_data.txt?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"
      }
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/datasets/9d5f4100-5f8e-4dd6-bd83-9bbbf50d57f1/files?skip=2&top=2&filter=createdDateTime%20ge%202018-01-24T09:54:39Z"
}

Definizioni

Nome	Descrizione
DetailedErrorCode	DetailedErrorCode
Error	Errore
ErrorCode	ErrorCode
File	File
FileKind	FileKind
FileLinks	FileLink
FileProperties	Proprietà file
InnerError	InnerError
PaginatedFiles	PaginatedFiles

DetailedErrorCode

Nome	Tipo	Descrizione
DataImportFailed	string	Importazione dati non riuscita.
DeleteNotAllowed	string	Eliminazione non consentita.
DeployNotAllowed	string	Distribuire non consentito.
DeployingFailedModel	string	Distribuzione di un modello non riuscito.
EmptyRequest	string	Richiesta vuota.
EndpointCannotBeDefault	string	L'endpoint non può essere predefinito.
EndpointNotUpdatable	string	Endpoint non aggiornabile.
EndpointWithoutLogging	string	Endpoint senza registrazione.
ExceededNumberOfRecordingsUris	string	È stato superato il numero di URI delle registrazioni.
FailedDataset	string	Set di dati non riuscito.
Forbidden	string	Non consentito.
InUseViolation	string	Violazione dell'uso.
InaccessibleCustomerStorage	string	Archiviazione clienti inaccessibile.
InvalidAdaptationMapping	string	Mapping di adattamento non valido.
InvalidBaseModel	string	Modello di base non valido.
InvalidCallbackUri	string	URI di callback non valido.
InvalidCollection	string	Raccolta non valida.
InvalidDataset	string	Set di dati non valido.
InvalidDocument	string	Documento non valido.
InvalidDocumentBatch	string	Batch di documenti non valido.
InvalidLocale	string	Impostazioni locali non valide.
InvalidLogDate	string	Data di log non valida.
InvalidLogEndTime	string	Ora di fine del log non valida.
InvalidLogId	string	ID log non valido.
InvalidLogStartTime	string	Ora di inizio del log non valida.
InvalidModel	string	Modello non valido.
InvalidModelUri	string	URI modello non valido.
InvalidParameter	string	Parametro non valido.
InvalidParameterValue	string	Valore del parametro non valido.
InvalidPayload	string	Payload non valido.
InvalidPermissions	string	Autorizzazioni non valide.
InvalidPrerequisite	string	Prerequisito non valido.
InvalidProductId	string	ID prodotto non valido.
InvalidProject	string	Progetto non valido.
InvalidProjectKind	string	Tipo di progetto non valido.
InvalidRecordingsUri	string	URI registrazioni non valide.
InvalidRequestBodyFormat	string	Formato del corpo della richiesta non valido.
InvalidSasValidityDuration	string	Durata della validità della firma di accesso condiviso non valida.
InvalidSkipTokenForLogs	string	Token ignora non valido per i log.
InvalidSourceAzureResourceId	string	ID risorsa di Azure di origine non valido.
InvalidSubscription	string	Sottoscrizione non valida.
InvalidTest	string	Test non valido.
InvalidTimeToLive	string	Tempo non valido da vivere.
InvalidTopForLogs	string	Top non valido per i log.
InvalidTranscription	string	Trascrizione non valida.
InvalidWebHookEventKind	string	Tipo di evento web hook non valido.
MissingInputRecords	string	Record di input mancanti.
ModelCopyOperationExists	string	Esiste un'operazione di copia modello.
ModelDeploymentNotCompleteState	string	Distribuzione del modello non completa stato.
ModelDeprecated	string	Modello deprecato.
ModelExists	string	Il modello esiste.
ModelMismatch	string	Mancata corrispondenza del modello.
ModelNotDeployable	string	Modello non distribuibile.
ModelVersionIncorrect	string	Versione del modello non corretta.
NoUtf8WithBom	string	Nessun utf8 con bom.
OnlyOneOfUrlsOrContainerOrDataset	string	Solo uno degli URL o del contenitore o del set di dati.
ProjectGenderMismatch	string	Mancata corrispondenza di genere del progetto.
QuotaViolation	string	Violazione della quota.
SingleDefaultEndpoint	string	Endpoint predefinito singolo.
SkuLimitsExist	string	Esistono limiti di SKU.
SubscriptionNotFound	string	Sottoscrizione non trovata.
UnexpectedError	string	Errore imprevisto.
UnsupportedClassBasedAdaptation	string	Adattamento basato su classi non supportate.
UnsupportedDelta	string	Delta non supportato.
UnsupportedDynamicConfiguration	string	Configurazione dinamica non supportata.
UnsupportedFilter	string	Filtro non supportato.
UnsupportedLanguageCode	string	Codice del linguaggio non supportato.
UnsupportedOrderBy	string	Ordine non supportato per.
UnsupportedPagination	string	Impaginazione non supportata.
UnsupportedTimeRange	string	Intervallo di tempo non supportato.

Error

Errore

Nome	Tipo	Descrizione
code	ErrorCode	ErrorCode Codici di errore di alto livello.
details	Error[]	Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.
innerError	InnerError	InnerError Nuovo formato di errore interno conforme alle linee guida per l'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, details(coppia chiave-valore), errore interno(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

Nome	Tipo	Descrizione
Conflict	string	Rappresentazione del codice di errore del conflitto.
Forbidden	string	Rappresentazione del codice di errore non consentito.
InternalCommunicationFailed	string	Rappresentazione del codice di errore della comunicazione interna non riuscita.
InternalServerError	string	Rappresentazione del codice di errore interno del server.
InvalidArgument	string	Rappresenta il codice di errore dell'argomento non valido.
InvalidRequest	string	Rappresenta il codice di errore della richiesta non valido.
NotAllowed	string	Rappresenta il codice di errore non consentito.
NotFound	string	Rappresentazione del codice di errore non trovato.
PipelineError	string	Rappresentazione del codice di errore della pipeline.
ServiceUnavailable	string	Rappresenta il codice di errore del servizio non disponibile.
TooManyRequests	string	Rappresenta il codice di errore troppe richieste.
Unauthorized	string	Rappresenta il codice di errore non autorizzato.
UnprocessableEntity	string	Rappresenta il codice di errore dell'entità non elaborabile.
UnsupportedMediaType	string	Rappresenta il codice di errore del tipo di supporto non supportato.

File

Nome	Tipo	Descrizione
createdDateTime	string	Ora di creazione del file. Il timestamp viene 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	FileLink
name	string	Nome del file.
properties	FileProperties	Proprietà file
self	string	Posizione dell'entità.

FileKind

Nome	Tipo	Descrizione
AcousticDataArchive	string	Il tipo di dati è l'archivio dati acustico.
AcousticDataTranscriptionV2	string	Il tipo di dati è la trascrizione dei dati acustici v2.
Audio	string	Il tipo di dati è audio.
DatasetReport	string	Il tipo di dati è il report del set di dati.
EvaluationDetails	string	Il tipo di dati è dettagli di valutazione.
LanguageData	string	Il tipo di dati è costituito dai dati linguistici.
ModelReport	string	Il tipo di dati è il report del modello.
OutputFormattingData	string	Il tipo di dati è il file di input di formattazione dell'output.
PronunciationData	string	Il tipo di dati è dati di pronuncia.
Transcription	string	Il tipo di dati è la trascrizione.
TranscriptionReport	string	Il tipo di dati è il report di trascrizione.

FileLinks

FileLink

Nome	Tipo	Descrizione
contentUrl	string	URL per recuperare il contenuto di questo file.

FileProperties

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	Dimensioni dei dati in byte.

InnerError

Nome	Tipo	Descrizione
code	DetailedErrorCode	DetailedErrorCode Enumerazione dettagliata del codice di errore.
details	object	Dettagli aggiuntivi di supporto relativi all'errore e/o ai criteri previsti.
innerError	InnerError	InnerError Nuovo formato di errore interno conforme alle linee guida per l'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, details(coppia chiave-valore), errore interno(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.

PaginatedFiles

Nome	Tipo	Descrizione
@nextLink	string	Collegamento al set successivo di risultati impaginati se sono disponibili più entità; in caso contrario, null.
values	File[]	Elenco di entità limitate dai parametri di query passati 'skip' e 'top' o dai relativi valori predefiniti. Durante l'iterazione di un elenco usando la paginazione e l'eliminazione di entità in parallelo, alcune entità verranno ignorate nei risultati. È consigliabile compilare un elenco nel client ed eliminarlo dopo il recupero dell'elenco completo.

Nome

Tipo

Descrizione

@nextLink

string

Collegamento al set successivo di risultati impaginati se sono disponibili più entità; in caso contrario, null.

values

File[]

Elenco di entità limitate dai parametri di query passati 'skip' e 'top' o dai relativi valori predefiniti.

Durante l'iterazione di un elenco usando la paginazione e l'eliminazione di entità in parallelo, alcune entità verranno ignorate nei risultati. È consigliabile compilare un elenco nel client ed eliminarlo dopo il recupero dell'elenco completo.

Condividi tramite

Datasets - List Files

Parametri dell'URI

Risposte

Sicurezza

Ocp-Apim-Subscription-Key

Authorization

Esempio

Get all dataset report files

Esempio di richiesta

Risposta di esempio

Get all files

Esempio di richiesta

Risposta di esempio

Definizioni

DetailedErrorCode

Error

ErrorCode

File

FileKind

FileLinks

FileProperties

InnerError

PaginatedFiles

Risorse aggiuntive