Endpoints - List Base Model Logs

Odwołanie

Usługa:: Azure AI Services

Wersja interfejsu API:: v3.2-preview.2

Pobiera listę dzienników audio i transkrypcji, które zostały zapisane podczas korzystania z domyślnego modelu podstawowego danego języka.

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

Z parametrami opcjonalnymi:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
locale	path	True	string	Język używany do wybierania domyślnego modelu podstawowego.
sasValidityInSeconds	query		integer (int32)	Czas trwania w sekundach, przez który adres URL sygnatury dostępu współdzielonego powinien być prawidłowy. Domyślny czas trwania to 12 godzin. W przypadku korzystania z funkcji 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): wartość 0 oznacza, że zostanie wygenerowany zwykły identyfikator URI obiektu blob bez tokenu SAS.
skipToken	query		string	Token pomijający dzienniki, które zostały już pobrane w poprzednich żądaniach. Stronicowanie rozpoczyna się od początku, gdy nie jest zdefiniowana.
top	query		integer (int32)	Liczba zestawów danych, które zostaną uwzględnione po pomijaniu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	PaginatedFiles	OK
Other Status Codes	Error	Wystąpił błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Tutaj podaj klucz konta usług Cognitive Services.

Typ: apiKey
W: header

Authorization

Podaj token dostępu z zestawu JWT zwróconego przez usługę STS w tym regionie. Pamiętaj, aby dodać zakres zarządzania do tokenu, dodając następujący ciąg zapytania do adresu URL usługi STS: ?scope=speechservicesmanagement

Typ: apiKey
W: header

Przykłady

Get all base model logs

Przykładowe żądanie

HTTP

GET {endpoint}/speechtotext/v3.2-preview.2/endpoints/base/Acoustic/files/logs?sasValidityInSeconds=120&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--&top=2

Przykładowa odpowiedź

Kod stanu:: 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/base/en-us/files/logs?top=2&skipToken=2!188!MDAwMDk1ITZhMjhiMDllLTg0MDYtNDViMi1hMGRkLWFlNzRlOGRhZWJkNi8yMDIwLTA0LTAxLzEyNDY0M182MzI5NGRkMi1mZGYzLTRhZmEtOTA0NC1mODU5ZTcxOWJiYzYud2F2ITAwMDAyOCE5OTk5LTEyLTMxVDIzOjU5OjU5Ljk5OTk5OTlaIQ--"
}

Definicje

Nazwa	Opis
DetailedErrorCode	DetailedErrorCode
Error	Błąd
ErrorCode	ErrorCode
File	File
FileKind	FileKind
FileLinks	PlikiLinki
FileProperties	Właściwości pliku
InnerError	Błąd wewnętrzny
PaginatedFiles	Pliki podzielone na strony

DetailedErrorCode

Wyliczanie

DetailedErrorCode

Wartość	Opis
DataImportFailed	Importowanie danych nie powiodło się.
DeleteNotAllowed	Usuń niedozwolone.
DeployNotAllowed	Wdrażanie jest niedozwolone.
DeployingFailedModel	Wdrażanie modelu, który zakończył się niepowodzeniem.
EmptyRequest	Puste żądanie.
EndpointCannotBeDefault	Punkt końcowy nie może być domyślny.
EndpointNotUpdatable	Punkt końcowy nie można aktualizować.
EndpointWithoutLogging	Punkt końcowy bez rejestrowania.
ExceededNumberOfRecordingsUris	Przekroczono liczbę nagrań uris.
FailedDataset	Zestaw danych, który zakończył się niepowodzeniem.
Forbidden	Zakazane.
InUseViolation	W przypadku naruszenia użycia.
InaccessibleCustomerStorage	Niedostępny magazyn klienta.
InvalidAdaptationMapping	Nieprawidłowe mapowanie adaptacji.
InvalidBaseModel	Nieprawidłowy model podstawowy.
InvalidCallbackUri	Nieprawidłowy identyfikator URI wywołania zwrotnego.
InvalidCollection	Nieprawidłowa kolekcja.
InvalidDataset	Nieprawidłowy zestaw danych.
InvalidDocument	Nieprawidłowy dokument.
InvalidDocumentBatch	Nieprawidłowa partia dokumentów.
InvalidLocale	Nieprawidłowe ustawienia regionalne.
InvalidLogDate	Nieprawidłowa data dziennika.
InvalidLogEndTime	Nieprawidłowy czas zakończenia dziennika.
InvalidLogId	Nieprawidłowy identyfikator dziennika.
InvalidLogStartTime	Nieprawidłowy czas rozpoczęcia dziennika.
InvalidModel	Nieprawidłowy model.
InvalidModelUri	Nieprawidłowy identyfikator URI modelu.
InvalidParameter	Nieprawidłowy parametr.
InvalidParameterValue	Nieprawidłowa wartość parametru.
InvalidPayload	Nieprawidłowy ładunek.
InvalidPermissions	Nieprawidłowe uprawnienia.
InvalidPrerequisite	Nieprawidłowe wymaganie wstępne.
InvalidProductId	Nieprawidłowy identyfikator produktu.
InvalidProject	Nieprawidłowy projekt.
InvalidProjectKind	Nieprawidłowy rodzaj projektu.
InvalidRecordingsUri	Nieprawidłowy identyfikator URI nagrań.
InvalidRequestBodyFormat	Nieprawidłowy format treści żądania.
InvalidSasValidityDuration	Nieprawidłowy czas trwania ważności sygnatury dostępu współdzielonego.
InvalidSkipTokenForLogs	Nieprawidłowy token pomijania dzienników.
InvalidSourceAzureResourceId	Nieprawidłowy źródłowy identyfikator zasobu platformy Azure.
InvalidSubscription	Nieprawidłowa subskrypcja.
InvalidTest	Nieprawidłowy test.
InvalidTimeToLive	Nieprawidłowy czas wygaśnięcia.
InvalidTopForLogs	Nieprawidłowy górny element dla dzienników.
InvalidTranscription	Nieprawidłowa transkrypcja.
InvalidWebHookEventKind	Nieprawidłowy rodzaj zdarzenia elementu webhook.
MissingInputRecords	Brak rekordów wejściowych.
ModelCopyOperationExists	Istnieje operacja kopiowania modelu.
ModelDeploymentNotCompleteState	Wdrożenie modelu nie zostało ukończone.
ModelDeprecated	Model jest przestarzały.
ModelExists	Model istnieje.
ModelMismatch	Niezgodność modelu.
ModelNotDeployable	Nie można wdrożyć modelu.
ModelVersionIncorrect	Nieprawidłowa wersja modelu.
NoUtf8WithBom	Brak utf8 z bom.
OnlyOneOfUrlsOrContainerOrDataset	Tylko jeden z adresów URL lub kontenera lub zestawu danych.
ProjectGenderMismatch	Niezgodność płci projektu.
QuotaViolation	Naruszenie limitu przydziału.
SingleDefaultEndpoint	Pojedynczy domyślny punkt końcowy.
SkuLimitsExist	Istnieją limity jednostek SKU.
SubscriptionNotFound	Nie można odnaleźć subskrypcji.
UnexpectedError	Nieoczekiwany błąd.
UnsupportedClassBasedAdaptation	Nieobsługiwana adaptacja oparta na klasach.
UnsupportedDelta	Nieobsługiwana delta.
UnsupportedDynamicConfiguration	Nieobsługiwana konfiguracja dynamiczna.
UnsupportedFilter	Nieobsługiwany filtr.
UnsupportedLanguageCode	Nieobsługiwany kod języka.
UnsupportedOrderBy	Nieobsługiwana kolejność według.
UnsupportedPagination	Nieobsługiwana stronicowanie.
UnsupportedTimeRange	Nieobsługiwany zakres czasu.

Error

Objekt

Błąd

Nazwa	Typ	Opis
code	ErrorCode	ErrorCode Kody błędów wysokiego poziomu.
details	Error[]	Dodatkowe szczegóły dotyczące błędów i/lub oczekiwanych zasad.
innerError	InnerError	Błąd wewnętrzny Nowy format błędu wewnętrznego zgodny z wytycznymi interfejsu API usług Cognitive Services dostępnymi pod adresem https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Zawiera on wymagane właściwości ErrorCode, komunikat i opcjonalne właściwości obiektu docelowego, szczegóły (para klucz-wartość), błąd wewnętrzny (można to zagnieżdżać).
message	string	Komunikat o błędzie wysokiego poziomu.
target	string	Źródło błędu. Na przykład będzie to "dokumenty" lub "identyfikator dokumentu" w przypadku nieprawidłowego dokumentu.

ErrorCode

Wyliczanie

ErrorCode

Wartość	Opis
Conflict	Reprezentowanie kodu błędu powodującego konflikt.
Forbidden	Reprezentowanie niedozwolonego kodu błędu.
InternalCommunicationFailed	Reprezentowanie kodu błędu komunikacji wewnętrznej nie powiodło się.
InternalServerError	Reprezentowanie wewnętrznego kodu błędu serwera.
InvalidArgument	Reprezentowanie nieprawidłowego kodu błędu argumentu.
InvalidRequest	Reprezentowanie nieprawidłowego kodu błędu żądania.
NotAllowed	Reprezentowanie niedozwolonego kodu błędu.
NotFound	Reprezentowanie kodu błędu, który nie został znaleziony.
PipelineError	Reprezentowanie kodu błędu potoku.
ServiceUnavailable	Reprezentuje kod błędu niedostępności usługi.
TooManyRequests	Reprezentacja kodu błędu zbyt wielu żądań.
Unauthorized	Reprezentowanie nieautoryzowanego kodu błędu.
UnprocessableEntity	Reprezentowanie nieprzetworzonego kodu błędu jednostki.
UnsupportedMediaType	Reprezentowanie nieobsługiwanego kodu błędu typu nośnika.

File

Objekt

File

Nazwa	Typ	Opis
createdDateTime	string (date-time)	Czas utworzenia tego pliku. Sygnatura czasowa jest kodowana jako format daty i godziny ISO 8601 (zobacz https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
kind	FileKind	FileKind Typ danych.
links	FileLinks	PlikiLinki
name	string	Nazwa tego pliku.
properties	FileProperties	Właściwości pliku
self	string (uri)	Lokalizacja tej jednostki.

FileKind

Wyliczanie

FileKind

Wartość	Opis
AcousticDataArchive	Typ danych to archiwum danych akustycznych.
AcousticDataTranscriptionV2	Typ danych to transkrypcja danych akustycznych w wersji 2.
Audio	Typ danych to dźwięk.
DatasetReport	Typ danych to raport zestawu danych.
EvaluationDetails	Typ danych to szczegóły oceny.
LanguageData	Typ danych to dane językowe.
ModelReport	Typ danych to raport modelu.
OutputFormattingData	Typ danych to formatowanie pliku wejściowego.
PronunciationData	Typ danych to dane wymowy.
Transcription	Typ danych to transkrypcja.
TranscriptionReport	Typ danych to raport transkrypcji.

FileLinks

Objekt

PlikiLinki

Nazwa	Typ	Opis
contentUrl	string (uri)	Adres URL umożliwiający pobranie zawartości tego pliku.

FileProperties

Objekt

Właściwości pliku

Nazwa	Typ	Opis
duration	string	Czas trwania w przypadku, gdy ten plik jest plikiem audio. Czas trwania jest zakodowany jako czas trwania ISO 8601 ("PnYnMnDTnHnMnS", zobacz https://en.wikipedia.org/wiki/ISO_8601#Durations).
size	integer (int64)	Rozmiar danych w bajtach.

InnerError

Objekt

Błąd wewnętrzny

Nazwa	Typ	Opis
code	DetailedErrorCode	DetailedErrorCode Szczegółowe wyliczenie kodu błędu.
details	object	Dodatkowe szczegóły dotyczące błędów i/lub oczekiwanych zasad.
innerError	InnerError	Błąd wewnętrzny Nowy format błędu wewnętrznego zgodny z wytycznymi interfejsu API usług Cognitive Services dostępnymi pod adresem https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Zawiera on wymagane właściwości ErrorCode, komunikat i opcjonalne właściwości obiektu docelowego, szczegóły (para klucz-wartość), błąd wewnętrzny (można to zagnieżdżać).
message	string	Komunikat o błędzie wysokiego poziomu.
target	string	Źródło błędu. Na przykład będzie to "dokumenty" lub "identyfikator dokumentu" w przypadku nieprawidłowego dokumentu.

PaginatedFiles

Objekt

Pliki podzielone na strony

Nazwa	Typ	Opis
@nextLink	string (uri)	Link do następnego zestawu wyników podzielonych na strony, jeśli jest dostępnych więcej jednostek; w przeciwnym razie wartość null.
values	File[]	Lista jednostek ograniczonych przez przekazane parametry zapytania "skip" i "top" lub ich wartości domyślne. W przypadku iteracji po liście przy użyciu stronicowania i równoległego usuwania jednostek niektóre jednostki zostaną pominięte w wynikach. Zaleca się utworzenie listy na kliencie i usunięcie po pobraniu pełnej listy.

Nazwa

Typ

Opis

@nextLink

string (uri)

Link do następnego zestawu wyników podzielonych na strony, jeśli jest dostępnych więcej jednostek; w przeciwnym razie wartość null.

values

File[]

Lista jednostek ograniczonych przez przekazane parametry zapytania "skip" i "top" lub ich wartości domyślne.

W przypadku iteracji po liście przy użyciu stronicowania i równoległego usuwania jednostek niektóre jednostki zostaną pominięte w wynikach. Zaleca się utworzenie listy na kliencie i usunięcie po pobraniu pełnej listy.

Udostępnij za pośrednictwem

Endpoints - List Base Model Logs

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

Ocp-Apim-Subscription-Key

Authorization

Przykłady

Get all base model logs

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

DetailedErrorCode

Error

ErrorCode

File

FileKind

FileLinks

FileProperties

InnerError

PaginatedFiles

Dodatkowe zasoby