Endpoints - List Logs

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

Ottiene l'elenco dei log di trascrizione e audio archiviati per un determinato endpoint.

GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/{id}/files/logs
Con parametri facoltativi: 
GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/{id}/files/logs?sasValidityInSeconds={sasValidityInSeconds}&skipToken={skipToken}&top={top}

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 dell'endpoint.
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://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): un valore pari a 0 significa che verrà generato un URI BLOB normale senza token di firma di accesso condiviso.
skipToken
 query

string

Token per ignorare i log già recuperati nelle richieste precedenti. La paginazione inizia dall'inizio quando non è definita.
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.

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 endpoint logs

Esempio di richiesta

GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs?sasValidityInSeconds=120&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--&top=2

Risposta di esempio

Codice di stato:
200 
{
  "values": [
    {
      "self": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
      "name": "2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav",
      "kind": "Audio",
      "properties": {
        "size": 12345
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav?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/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.json",
      "name": "2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.json",
      "kind": "Transcription",
      "properties": {
        "size": 12345
      },
      "createdDateTime": "2020-01-13T08:00:00Z",
      "links": {
        "contentUrl": "https://customspeech-usw.blob.core.windows.net/artifacts/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.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"
      }
    }
  ],
  "@nextLink": "https://westus.api.cognitive.microsoft.com/speechtotext/v3.2-preview.2/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs?top=2&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--"
}

Definizioni

Nome Descrizione
DetailedErrorCode

DettagliErrorCode
Error

Errore
ErrorCode

ErrorCode
File

File
FileKind

FileKind
FileLinks

FileLinks
FileProperties

Proprietà file
InnerError

InnerError
PaginatedFiles

File impaginati

DetailedErrorCode

DettagliErrorCode

Nome Tipo Descrizione
DataImportFailed

string

Importazione dei 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

Superato il numero di uri delle registrazioni.
FailedDataset

string

Set di dati non riuscito.
Forbidden

string

Non consentito.
InUseViolation

string

In 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 le API servizi cognitivi disponibili in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene proprietà necessarie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia di valori chiave), errore interno(può essere annidato).
message

string

Messaggio di errore di alto livello.
target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "documenti" o "ID documento" nel caso di documento non valido.

ErrorCode

ErrorCode

Nome Tipo Descrizione
Conflict

string

Rappresenta il codice di errore del conflitto.
Forbidden

string

Rappresenta il codice di errore non consentito.
InternalCommunicationFailed

string

Rappresentazione del codice di errore interno della comunicazione non riuscita.
InternalServerError

string

Rappresenta il codice di errore del server interno.
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

Rappresenta il codice di errore non trovato.
PipelineError

string

Rappresenta il codice di errore della pipeline.
ServiceUnavailable

string

Rappresenta il codice di errore non disponibile del servizio.
TooManyRequests

string

Rappresenta il codice di errore di 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

File

Nome Tipo Descrizione
createdDateTime

string

Ora di creazione di questo 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

FileLinks
name

string

Nome del file.
properties

FileProperties

Proprietà file
self

string

Posizione di questa entità.

FileKind

FileKind

Nome Tipo Descrizione
AcousticDataArchive

string

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

string

Il tipo di dati è la trascrizione dei dati acustica 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 è 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 è trascrizione.
TranscriptionReport

string

Il tipo di dati è il report di trascrizione.

FileLinks

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

InnerError

Nome Tipo Descrizione
code

DetailedErrorCode

DettagliErrorCode
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 le API servizi cognitivi disponibili in https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene proprietà necessarie ErrorCode, message e proprietà facoltative di destinazione, dettagli(coppia di valori chiave), errore interno(può essere annidato).
message

string

Messaggio di errore di alto livello.
target

string

Indica l'origine dell'errore. Ad esempio, sarebbe "documenti" o "ID documento" nel caso di documento non valido.

PaginatedFiles

File impaginati

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.

Quando si esegue l'iterazione tramite 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 eliminare dopo il recupero dell'elenco completo.