Udostępnij za pośrednictwem

Pobieranie stanu dla wszystkich dokumentów

  • Artykuł

Funkcja referencyjna
: Azure AI Translator → interfejsu API tłumaczenia
dokumentów Wersja: 2024-05-01
metoda HTTP: GET

Ważne

Wszystkie żądania interfejsu API do funkcji tłumaczenia dokumentów wymagają niestandardowego punktu końcowego domeny znajdującego się na stronie przeglądu zasobu w witrynie Azure Portal.

  • get documents status Użyj metody , aby zażądać stanu wszystkich dokumentów w zadaniu tłumaczenia.

  • $topparametrów , $skipi $maxpagesize zapytania można użyć do określenia liczby wyników do zwrócenia i przesunięcia dla kolekcji.

    • $top wskazuje łączną liczbę rekordów, które użytkownik chce zwrócić na wszystkich stronach.
    • $skip wskazuje liczbę rekordów do pominięcia z listy stanu dokumentu przechowywanego przez serwer na podstawie określonej metody sortowania. Domyślnie rekordy są sortowane według malejącego czasu rozpoczęcia.
    • $maxpagesize to maksymalna liczba elementów zwracanych na stronie.
    • Jeśli więcej elementów zostanie żądanych za pośrednictwem $top (lub $top nie zostanie określonych i zostanie zwróconych więcej elementów), @nextLink będzie zawierać link do następnej strony.
    • Jeśli liczba dokumentów w odpowiedzi przekracza limit stronicowania, używane jest stronicowanie po stronie serwera.
    • Odpowiedzi podzielone na strony wskazują częściowy wynik i zawierają token kontynuacji w odpowiedzi. Brak tokenu kontynuacji oznacza, że żadne inne strony nie są dostępne.

Uwaga

Jeśli serwer nie może honorować $top i/lub $skip, serwer musi zwrócić błąd do klienta informującego o nim zamiast ignorować opcje zapytania. Zmniejsza to ryzyko podejmowania przez klienta założeń dotyczących zwracanych danych.

  • $orderBy Parametr zapytania może służyć do sortowania zwracanej listy (np. $orderBy=createdDateTimeUtc asc lub $orderBy=createdDateTimeUtc desc).
  • Domyślne sortowanie jest malejące według createdDateTimeUtcwartości . Niektóre parametry zapytania mogą służyć do filtrowania zwracanej listy (np. status=Succeeded,Cancelled) zwraca tylko zakończone powodzeniem i anulowane dokumenty.
  • Parametry createdDateTimeUtcStart zapytania i createdDateTimeUtcEnd mogą być używane w połączeniu lub oddzielnie, aby określić zakres daty/godziny filtrowania zwracanej listy.
  • Obsługiwane parametry zapytania filtrowania to (status, id, createdDateTimeUtcStarti createdDateTimeUtcEnd).
  • Po dołączeniu obu $top elementów $skip i serwer powinien najpierw mieć zastosowanie $skip , a następnie $top w kolekcji.

Adres URL żądania

Wyślij żądanie GET do:

  curl -i -X GET "{document-translation-endpoint}/translator/document/batches/{id}/documents?api-version={date}"

Lokalizowanie id wartości

  • Zadanie id można znaleźć w wartości adresu URL nagłówka Operation-Location odpowiedzi metody POSTstart-batch-translation. Ciąg alfanumeryczny po parametrze /document/ jest zadaniem idoperacji :
Nagłówek odpowiedzi Adres URL odpowiedzi
Lokalizacja operacji {document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

Parametry żądania

Parametry żądania przekazane w ciągu zapytania to:

Parametr zapytania W Wymagania Type Opis
id path Prawda string Identyfikator operacji.
$maxpagesize zapytanie Fałsz liczba całkowita int32 $maxpagesize to maksymalna liczba elementów zwracanych na stronie. Jeśli więcej elementów zostanie żądanych za pośrednictwem $top (lub $top nie zostanie określonych i zostanie zwróconych więcej elementów), @nextLink będzie zawierać link do następnej strony. Klienci mogą żądać stronicowania opartego na serwerze o określonym rozmiarze strony, określając preferencję $maxpagesize . Serwer powinien przestrzegać tej preferencji, jeśli określony rozmiar strony jest mniejszy niż domyślny rozmiar strony serwera.
$orderBy zapytanie Fałsz tablica Zapytanie sortowania dla kolekcji (np. CreatedDateTimeUtc asc, CreatedDateTimeUtc desc).
$skip zapytanie Fałsz liczba całkowita int32 $skip wskazuje liczbę rekordów do pominięcia z listy rekordów przechowywanych przez serwer na podstawie określonej metody sortowania. Domyślnie sortujemy według malejącego czasu rozpoczęcia. Klienci MOGĄ używać $top i $skip parametrów zapytania, aby określić liczbę wyników do zwrócenia i przesunięcie do kolekcji. Gdy klient zwróci wartości i $top $skip, serwer POWINIEN najpierw zastosować $skip , a następnie $top w kolekcji. Jeśli serwer nie może honorować $top i/lub $skip, serwer MUSI zwrócić błąd do klienta informującego o nim zamiast ignorować opcje zapytania.
$top zapytanie Fałsz liczba całkowita int32 $top wskazuje łączną liczbę rekordów, które użytkownik chce zwrócić na wszystkich stronach. Klienci mogą używać $top parametrów i $skip wysyłać zapytania, aby określić liczbę wyników do zwrócenia i przesunięcie do kolekcji. Gdy klient zwróci wartości i $top $skip, serwer POWINIEN najpierw zastosować $skip , a następnie $top w kolekcji. Jeśli serwer nie może honorować $top i/lub $skip, serwer MUSI zwrócić błąd do klienta informującego o nim zamiast ignorować opcje zapytania.
createdDateTimeUtcEnd zapytanie Fałsz ciąg daty i godziny Data/godzina zakończenia pobierania elementów przed.
createdDateTimeUtcStart zapytanie Fałsz ciąg daty i godziny Data/godzina rozpoczęcia pobierania elementów po.
ids zapytanie Fałsz tablica Identyfikatory do użycia w filtrowaniu.
Statusy zapytanie Fałsz tablica Stany do użycia w filtrowaniu.

Nagłówki żądań

Nagłówki żądań to:

Nagłówki opis Warunek
Ocp-Apim-Subscription-Key Klucz interfejsu API usługi Translator z witryny Azure Portal. Wymagane
Ocp-Apim-Subscription-Region Region, w którym utworzono zasób. Wymagane w przypadku korzystania z zasobu regionalnego (geograficznego), takiego jak Zachodnie stany USA
Typ zawartości Typ zawartości ładunku. Zaakceptowana wartość to application/json lub charset=UTF-8. Wymagane

Kody stanu odpowiedzi

Poniżej przedstawiono możliwe kody stanu HTTP zwracane przez żądanie.

Kod stanu opis
200 OK. Pomyślne żądanie i zwraca stan dokumentów. HeadersRetry-After: integerETag: string
400 Nieprawidłowa prośba. Sprawdź parametry wejściowe.
401 Brak autoryzacji. Sprawdź poświadczenia.
404 Nie można odnaleźć zasobu.
500 Wewnętrzny błąd serwera.
Inne kody stanu • Zbyt wiele żądań
• Serwer jest tymczasowo niedostępny

Uzyskiwanie odpowiedzi na stan dokumentów

Pomyślna odpowiedź na stan dokumentów

Następujące informacje są zwracane w pomyślnej odpowiedzi.

Nazwisko Pisz Opis
@nextLink string Adres URL następnej strony. Wartość null, jeśli nie ma więcej dostępnych stron.
wartość DocumentStatus [] Szczegółowa lista stanów poszczególnych dokumentów.
value.path string Lokalizacja dokumentu lub folderu.
value.sourcePath string Lokalizacja dokumentu źródłowego.
value.createdDateTimeUtc string Operacja utworzona data/godzina.
value.lastActionDateTimeUtc string Data i godzina aktualizacji stanu operacji.
value.status status Lista możliwych stanów zadania lub dokumentu.
• Anulowana
•Anulowanie
•Nie powiodło się
• Niestartowane
•Bieganie
•Zakończyła się pomyślnie
• ValidationFailed
value.to string Język.
value.progress Liczba Postęp tłumaczenia, jeśli jest dostępny.
value.id string Identyfikator dokumentu.
value.characterCharged integer Znaki naliczane przez interfejs API.

Odpowiedź błędna

Nazwisko Pisz Opis
code string Wyliczenia zawierające kody błędów wysokiego poziomu. Możliwe wartości:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Nieautoryzowanych
wiadomość string Pobiera komunikat o błędzie wysokiego poziomu.
target string Pobiera źródło błędu. Na przykład byłoby documents to lub document id dla nieprawidłowego dokumentu.
innerError InnerTranslationError Nowy format błędu wewnętrznego zgodny z wytycznymi interfejsu API usług AI platformy Azure. Ten komunikat o błędzie zawiera wymagane właściwości ErrorCode, message i optional properties target, details (key value pair), wewnętrzny błąd (można go zagnieżdżać).
innerError.code string Pobiera ciąg błędu kodu.
innerError.message string Pobiera komunikat o błędzie wysokiego poziomu.
innerError.target string Pobiera źródło błędu. Na przykład byłoby documents to lub document id gdyby dokument był nieprawidłowy.

Przykłady

Napiwek

Użyj tej metody, aby pobrać documentId parametr dla ciągu zapytania get-document-status .

Przykład pomyślnej odpowiedzi

Poniższy obiekt JSON jest przykładem pomyślnej odpowiedzi.

{
  "value": [
    {
      "path": "https://myblob.blob.core.windows.net/destinationContainer/fr/mydoc.txt",
      "sourcePath": "https://myblob.blob.core.windows.net/sourceContainer/fr/mydoc.txt",
      "createdDateTimeUtc": "2020-03-26T00:00:00Z",
      "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
      "status": "Running",
      "to": "fr",
      "progress": 0.1,
      "id": "273622bd-835c-4946-9798-fd8f19f6bbf2",
      "characterCharged": 0
    }
  ],
  "@nextLink": "https://westus.cognitiveservices.azure.com/translator/text/batch/v1.1/operation/0FA2822F-4C2A-4317-9C20-658C801E0E55/documents?$top=5&$skip=15"
}

Przykładowa odpowiedź na błąd

Poniższy obiekt JSON jest przykładem odpowiedzi na błąd. Schemat innych kodów błędów jest taki sam.

Kod stanu: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "target": "Operation",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Następne kroki

Postępuj zgodnie z naszym przewodnikiem Szybki start, aby dowiedzieć się więcej na temat korzystania z tłumaczenia dokumentów i biblioteki klienta.

Wprowadzenie do tłumaczenia dokumentów