Compartir a través de

Endpoints - Get Log

  • Referencia
Servicio:
Azure AI Services
Versión de la API:
v3.2-preview.2

Obtiene un registro de audio o transcripción específico para un punto de conexión determinado.

GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/{id}/files/logs/{logId}
Con parámetros opcionales: 
GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/{id}/files/logs/{logId}?sasValidityInSeconds={sasValidityInSeconds}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
endpoint
 path True

string

Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
id
 path True

string (uuid)

Identificador del punto de conexión.
logId
 path True

string

Identificador del registro.
sasValidityInSeconds
 query

integer (int32)

Duración en segundos que una dirección URL de SAS debe ser válida. La duración predeterminada es de 12 horas. Al usar 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 valor de 0 significa que se generará un URI de blob sin formato sin token de SAS.

Respuestas

Nombre Tipo Description
200 OK

File

De acuerdo
Other Status Codes

Error

Se ha producido un error.

Seguridad

Ocp-Apim-Subscription-Key

Proporcione aquí la clave de la cuenta de Cognitive Services.

Tipo: apiKey
En: header

Authorization

Proporcione un token de acceso del JWT devuelto por el STS de esta región. Asegúrese de agregar el ámbito de administración al token agregando la siguiente cadena de consulta a la dirección URL de STS: ?scope=speechservicesmanagement

Tipo: apiKey
En: header

Ejemplos

Get an endpoint log

Solicitud de ejemplo

GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/afa0669c-a01e-4693-ae3a-93baf40f26d6/files/logs/2019-09-20_080000_3b5f4628-e225-439d-bd27-8804f9eed13f.wav?sasValidityInSeconds=120

Respuesta de muestra

status code:
200 
{
  "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"
  }
}

Definiciones

Nombre Description
DetailedErrorCode

DetailedErrorCode
Error

Error
ErrorCode

ErrorCode
File

Archivo
FileKind

FileKind
FileLinks

FileLinks
FileProperties

FileProperties
InnerError

InnerError

DetailedErrorCode

Enumeración

DetailedErrorCode

Valor Description
DataImportFailed

Error en la importación de datos.
DeleteNotAllowed

Eliminar no permitido.
DeployNotAllowed

No se permite la implementación.
DeployingFailedModel

Se ha producido un error en la implementación del modelo.
EmptyRequest

Solicitud vacía.
EndpointCannotBeDefault

El punto de conexión no puede ser predeterminado.
EndpointNotUpdatable

Punto de conexión no actualizable.
EndpointWithoutLogging

Punto de conexión sin registro.
ExceededNumberOfRecordingsUris

Se superó el número de uris de grabaciones.
FailedDataset

Conjunto de datos con errores.
Forbidden

Prohibido.
InUseViolation

En infracción de uso.
InaccessibleCustomerStorage

Almacenamiento de clientes inaccesible.
InvalidAdaptationMapping

Asignación de adaptación no válida.
InvalidBaseModel

Modelo base no válido.
InvalidCallbackUri

URI de devolución de llamada no válido.
InvalidCollection

Colección no válida.
InvalidDataset

Conjunto de datos no válido.
InvalidDocument

Documento no válido.
InvalidDocumentBatch

Lote de documentos no válido.
InvalidLocale

Configuración regional no válida.
InvalidLogDate

Fecha de registro no válida.
InvalidLogEndTime

Hora de finalización del registro no válida.
InvalidLogId

Identificador de registro no válido.
InvalidLogStartTime

Hora de inicio del registro no válida.
InvalidModel

Modelo no válido.
InvalidModelUri

URI de modelo no válido.
InvalidParameter

Parámetro no válido.
InvalidParameterValue

Valor de parámetro no válido.
InvalidPayload

Carga no válida.
InvalidPermissions

Permisos no válidos.
InvalidPrerequisite

Requisito previo no válido.
InvalidProductId

Identificador de producto no válido.
InvalidProject

Proyecto no válido.
InvalidProjectKind

Tipo de proyecto no válido.
InvalidRecordingsUri

URI de grabaciones no válidos.
InvalidRequestBodyFormat

Formato de cuerpo de la solicitud no válido.
InvalidSasValidityDuration

Duración de validez de sas no válida.
InvalidSkipTokenForLogs

Token de omisión no válido para los registros.
InvalidSourceAzureResourceId

Identificador de recurso de Azure de origen no válido.
InvalidSubscription

Suscripción no válida.
InvalidTest

Prueba no válida.
InvalidTimeToLive

Tiempo de vida no válido.
InvalidTopForLogs

Top no válido para los registros.
InvalidTranscription

Transcripción no válida.
InvalidWebHookEventKind

Tipo de evento web hook no válido.
MissingInputRecords

Faltan registros de entrada.
ModelCopyOperationExists

Existe una operación de copia del modelo.
ModelDeploymentNotCompleteState

La implementación del modelo no está completa.
ModelDeprecated

Modelo en desuso.
ModelExists

El modelo existe.
ModelMismatch

Error de coincidencia del modelo.
ModelNotDeployable

El modelo no se puede implementar.
ModelVersionIncorrect

Versión del modelo incorrecta.
NoUtf8WithBom

No hay utf8 con bom.
OnlyOneOfUrlsOrContainerOrDataset

Solo una de direcciones URL o contenedor o conjunto de datos.
ProjectGenderMismatch

No coinciden los géneros del proyecto.
QuotaViolation

Infracción de cuota.
SingleDefaultEndpoint

Punto de conexión predeterminado único.
SkuLimitsExist

Existen límites de SKU.
SubscriptionNotFound

No se encontró la suscripción.
UnexpectedError

Error inesperado.
UnsupportedClassBasedAdaptation

Adaptación basada en clases no admitidas.
UnsupportedDelta

Delta no admitido.
UnsupportedDynamicConfiguration

Configuración dinámica no admitida.
UnsupportedFilter

Filtro no admitido.
UnsupportedLanguageCode

Código de lenguaje no admitido.
UnsupportedOrderBy

Orden no admitido por.
UnsupportedPagination

Paginación no admitida.
UnsupportedTimeRange

Intervalo de tiempo no admitido.

Error

Object

Error

Nombre Tipo Description
code

ErrorCode

ErrorCode
Códigos de error de alto nivel.
details

Error[]

Detalles de apoyo adicionales relacionados con el error o las directivas esperadas.
innerError

InnerError

InnerError
Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message

string

Mensaje de error de alto nivel.
target

string

Origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.

ErrorCode

Enumeración

ErrorCode

Valor Description
Conflict

Representa el código de error en conflicto.
Forbidden

Representa el código de error prohibido.
InternalCommunicationFailed

Representa el código de error de comunicación interna con error.
InternalServerError

Representa el código de error interno del servidor.
InvalidArgument

Representa el código de error de argumento no válido.
InvalidRequest

Representa el código de error de solicitud no válido.
NotAllowed

Representa el código de error no permitido.
NotFound

Representa el código de error no encontrado.
PipelineError

Representa el código de error de canalización.
ServiceUnavailable

Representa el código de error del servicio no disponible.
TooManyRequests

Representa el código de error de demasiadas solicitudes.
Unauthorized

Representa el código de error no autorizado.
UnprocessableEntity

Representa el código de error de entidad no procesado.
UnsupportedMediaType

Representa el código de error de tipo de medio no admitido.

File

Object

Archivo

Nombre Tipo Description
createdDateTime

string (date-time)

Hora de creación de este archivo. La marca de tiempo se codifica como formato de fecha y hora ISO 8601 (consulte https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind

FileKind

FileKind
Tipo de datos.
links

FileLinks

FileLinks
name

string

Nombre de este archivo.
properties

FileProperties

FileProperties
self

string (uri)

Ubicación de esta entidad.

FileKind

Enumeración

FileKind

Valor Description
AcousticDataArchive

El tipo de datos es el archivo de datos acústico.
AcousticDataTranscriptionV2

El tipo de datos es la transcripción de datos acústica v2.
Audio

El tipo de datos es audio.
DatasetReport

El tipo de datos es el informe del conjunto de datos.
EvaluationDetails

El tipo de datos es detalles de evaluación.
LanguageData

El tipo de datos es datos de idioma.
ModelReport

El tipo de datos es el informe del modelo.
OutputFormattingData

El tipo de datos es el archivo de entrada de formato de salida.
PronunciationData

El tipo de datos es datos de pronunciación.
Transcription

El tipo de datos es la transcripción.
TranscriptionReport

El tipo de datos es el informe de transcripción.
Object

FileLinks

Nombre Tipo Description
contentUrl

string (uri)

Dirección URL para recuperar el contenido de este archivo.

FileProperties

Object

FileProperties

Nombre Tipo Description
duration

string

La duración en caso de que este archivo sea un archivo de audio. La duración se codifica como duración ISO 8601 ("PnYnMnDTnHnMnS", vea https://en.wikipedia.org/wiki/ISO_8601#Durations).
size

integer (int64)

Tamaño de los datos en bytes.

InnerError

Object

InnerError

Nombre Tipo Description
code

DetailedErrorCode

DetailedErrorCode
Enumeración detallada del código de error.
details

object

Detalles de apoyo adicionales relacionados con el error o las directivas esperadas.
innerError

InnerError

InnerError
Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message

string

Mensaje de error de alto nivel.
target

string

Origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.