Endpoints - List Logs

Tjänst:: Azure AI Services

API-version:: v3.2-preview.2

Hämtar listan över ljud- och transkriptionsloggar som har lagrats för en viss slutpunkt.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
id	path	True	string (uuid)	Slutpunktens identifierare.
sasValidityInSeconds	query		integer (int32)	Varaktigheten i sekunder som en SAS-URL ska vara giltig. Standardvaraktigheten är 12 timmar. När du använder 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): Ett värde på 0 innebär att en vanlig blob-URI utan SAS-token genereras.
skipToken	query		string	Token för att hoppa över loggar som redan har hämtats i tidigare begäranden. Sidnumreringen börjar från början när den inte har definierats.
top	query		integer (int32)	Antal datauppsättningar som ska ingå när du hoppar över.

Svar

Name	Typ	Description
200 OK	PaginatedFiles	OK Sidhuvuden Retry-After: integer
Other Status Codes	Error	Ett fel uppstod.

Name

Typ

Description

200 OK

PaginatedFiles

Sidhuvuden

Retry-After: integer

Other Status Codes

Error

Ett fel uppstod.

Säkerhet

Ocp-Apim-Subscription-Key

Ange din cognitive services-kontonyckel här.

Typ: apiKey
I: header

Authorization

Ange en åtkomsttoken från JWT som returneras av STS i den här regionen. Se till att lägga till hanteringsomfånget i token genom att lägga till följande frågesträng i STS-URL:en: ?scope=speechservicesmanagement

Typ: apiKey
I: header

Exempel

Get all endpoint logs

Exempelbegäran

HTTP

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

Exempelsvar

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

Definitioner

Name	Description
DetailedErrorCode	DetailedErrorCode
Error	Fel
ErrorCode	Felkod
File	Fil
FileKind	FileKind
FileLinks	FileLinks
FileProperties	FileProperties
InnerError	InnerError
PaginatedFiles	Sidnumrerade filer

DetailedErrorCode

Uppräkning

DetailedErrorCode

Värde	Description
InvalidParameterValue	Ogiltigt parametervärde.
InvalidRequestBodyFormat	Ogiltigt brödtextformat för begäran.
EmptyRequest	Tom begäran.
MissingInputRecords	Indataposter saknas.
InvalidDocument	Ogiltigt dokument.
ModelVersionIncorrect	Modellversionen är felaktig.
InvalidDocumentBatch	Ogiltig dokumentbatch.
UnsupportedLanguageCode	Språkkod som inte stöds.
DataImportFailed	Dataimporten misslyckades.
InUseViolation	Vid användningsöverträdelse.
InvalidLocale	Ogiltigt språk.
InvalidBaseModel	Ogiltig basmodell.
InvalidAdaptationMapping	Ogiltig anpassningsmappning.
InvalidDataset	Ogiltig datauppsättning.
InvalidTest	Ogiltigt test.
FailedDataset	Datauppsättningen misslyckades.
InvalidModel	Ogiltig modell.
InvalidTranscription	Ogiltig transkription.
InvalidPayload	Ogiltig nyttolast.
InvalidParameter	Ogiltig parameter.
EndpointWithoutLogging	Slutpunkt utan loggning.
InvalidPermissions	Ogiltiga behörigheter.
InvalidPrerequisite	Ogiltigt krav.
InvalidProductId	Ogiltigt produkt-ID.
InvalidSubscription	Ogiltig prenumeration.
InvalidProject	Ogiltigt projekt.
InvalidProjectKind	Ogiltig projekttyp.
InvalidRecordingsUri	Ogiltig inspelnings-URI.
OnlyOneOfUrlsOrContainerOrDataset	Endast en av url:erna eller containern eller datamängden.
ExceededNumberOfRecordingsUris	Överskred antalet inspelningar uris.
ModelMismatch	Modellmatchningsfel.
ProjectGenderMismatch	Matchningsfel för projektkön.
ModelDeprecated	Modellen är inaktuell.
ModelExists	Modellen finns.
ModelNotDeployable	Modellen kan inte distribueras.
EndpointNotUpdatable	Slutpunkten kan inte uppdateras.
SingleDefaultEndpoint	Enskild standardslutpunkt.
EndpointCannotBeDefault	Slutpunkten kan inte vara standard.
InvalidModelUri	Ogiltig modell-URI.
SubscriptionNotFound	Det går inte att hitta prenumerationen.
QuotaViolation	Kvotöverträdelse.
UnsupportedDelta	Delta stöds inte.
UnsupportedFilter	Filter som inte stöds.
UnsupportedPagination	Sidnumrering stöds inte.
UnsupportedDynamicConfiguration	Dynamisk konfiguration stöds inte.
UnsupportedOrderBy	Order som inte stöds av.
NoUtf8WithBom	Ingen utf8 med bom.
ModelDeploymentNotCompleteState	Modelldistributionen har inte slutförts.
SkuLimitsExist	Det finns SKU-gränser.
DeployingFailedModel	Distribution av en misslyckad modell.
UnsupportedTimeRange	Tidsintervall som inte stöds.
InvalidLogDate	Ogiltigt loggdatum.
InvalidLogId	Ogiltigt logg-ID.
InvalidLogStartTime	Ogiltig starttid för loggen.
InvalidLogEndTime	Ogiltig loggsluttid.
InvalidTopForLogs	Ogiltig topp för loggar.
InvalidSkipTokenForLogs	Ogiltig hopptoken för loggar.
DeleteNotAllowed	Ta bort tillåts inte.
Forbidden	Förbjuden.
DeployNotAllowed	Distribution tillåts inte.
UnexpectedError	Oväntat fel.
InvalidCollection	Ogiltig samling.
InvalidCallbackUri	Ogiltig återanrops-URI.
InvalidSasValidityDuration	Ogiltig varaktighet för sas-giltighet.
InaccessibleCustomerStorage	Otillgänglig kundlagring.
UnsupportedClassBasedAdaptation	Klassbaserad anpassning som inte stöds.
InvalidWebHookEventKind	Ogiltig typ av webbhookhändelse.
InvalidTimeToLive	Ogiltig tid att leva.
InvalidSourceAzureResourceId	Ogiltigt azure-källresurs-ID.
ModelCopyOperationExists	Modellkopieringsåtgärden finns.

Error

Objekt

Fel

Name	Typ	Description
code	ErrorCode	Felkod Felkoder på hög nivå.
details	Error[]	Ytterligare stödjande information om fel och/eller förväntade principer.
innerError	InnerError	InnerError Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper mål, information (nyckel värde par), inre fel (detta kan kapslas).
message	string	Felmeddelande på hög nivå.
target	string	Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

ErrorCode

Uppräkning

Felkod

Värde	Description
InvalidRequest	Representerar den ogiltiga felkoden för begäran.
InvalidArgument	Representerar den ogiltiga argumentfelkoden.
InternalServerError	Representerar felkoden för den interna servern.
ServiceUnavailable	Representerar felkoden för tjänsten som inte är tillgänglig.
NotFound	Representerar felkoden som inte hittades.
PipelineError	Representerar felkoden för pipelinefel.
Conflict	Representerar konfliktfelkoden.
InternalCommunicationFailed	Det gick inte att ange felkoden för intern kommunikation.
Forbidden	Representerar den otillåtna felkoden.
NotAllowed	Representerar den felkod som inte tillåts.
Unauthorized	Representerar den obehöriga felkoden.
UnsupportedMediaType	Representerar felkoden för medietypen som inte stöds.
TooManyRequests	Representerar felkoden för för många begäranden.
UnprocessableEntity	Representerar felkoden för entitetsfel som inte kan bearbetas.

File

Objekt

Fil

Name	Typ	Description
createdDateTime	string (date-time)	Skapandetiden för den här filen. Tidsstämpeln är kodad som ISO 8601-datum- och tidsformat (se https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind	FileKind	FileKind Typ av data.
links	FileLinks	FileLinks
name	string	Namnet på den här filen.
properties	FileProperties	FileProperties
self	string (uri)	Platsen för den här entiteten.

FileKind

Uppräkning

FileKind

Värde	Description
DatasetReport	Typ av data är datamängdsrapport.
Audio	Typ av data är ljud.
LanguageData	Typ av data är språkdata.
PronunciationData	Typ av data är uttalsdata.
AcousticDataArchive	Typ av data är akustiskt dataarkiv.
AcousticDataTranscriptionV2	Typ av data är akustisk dataranskription v2.
Transcription	Typ av data är transkription.
TranscriptionReport	Typ av data är transkriptionsrapport.
EvaluationDetails	Typ av data är utvärderingsinformation.
ModelReport	Typ av data är modellrapport.
OutputFormattingData	Typ av data är indatafilen för utdataformatering.

FileLinks

Objekt

FileLinks

Name	Typ	Description
contentUrl	string (uri)	Url:en för att hämta innehållet i den här filen.

FileProperties

Objekt

FileProperties

Name	Typ	Description
duration	string	Varaktigheten om den här filen är en ljudfil. Varaktigheten kodas som ISO 8601-varaktighet ("PnYnMnDTnHnMnS", se https://en.wikipedia.org/wiki/ISO_8601#Durations).
size	integer (int64)	Storleken på data i byte.

InnerError

Objekt

InnerError

Name	Typ	Description
code	DetailedErrorCode	DetailedErrorCode Detaljerad felkodsuppräkning.
details	object	Ytterligare stödjande information om fel och/eller förväntade principer.
innerError	InnerError	InnerError Nytt format för inre fel som överensstämmer med Cognitive Services API Guidelines som finns på https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Detta innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper mål, information (nyckel värde par), inre fel (detta kan kapslas).
message	string	Felmeddelande på hög nivå.
target	string	Källan till felet. Det skulle till exempel vara "dokument" eller "dokument-ID" om dokumentet är ogiltigt.

PaginatedFiles

Objekt

Sidnumrerade filer

Name	Typ	Description
@nextLink	string (uri)	En länk till nästa uppsättning sidnumrerade resultat om det finns fler tillgängliga entiteter. annars null.
values	File[]	En lista över entiteter som begränsas av antingen de skickade frågeparametrarna "skip" och "top" eller deras standardvärden. När du itererar genom en lista med sidnumrering och tar bort entiteter parallellt hoppas vissa entiteter över i resultatet. Vi rekommenderar att du skapar en lista på klienten och tar bort efter hämtningen av den fullständiga listan.

Name

Typ

Description

@nextLink

string (uri)

En länk till nästa uppsättning sidnumrerade resultat om det finns fler tillgängliga entiteter. annars null.

values

File[]

En lista över entiteter som begränsas av antingen de skickade frågeparametrarna "skip" och "top" eller deras standardvärden.

När du itererar genom en lista med sidnumrering och tar bort entiteter parallellt hoppas vissa entiteter över i resultatet. Vi rekommenderar att du skapar en lista på klienten och tar bort efter hämtningen av den fullständiga listan.