Adott fordítási feladat állapotának lekérése

Referenciafunkció: Azure AI Translator → Document Translation
API-verzió: 2024-05-01
HTTP-módszer: GET

• Ezzel a get translation status módszerrel kérheti le egy adott fordítási feladat állapotát. A válasz tartalmazza a feladat általános állapotát és a feladat részeként lefordított dokumentumok állapotát.

URL-cím kérése

Fontos

A Dokumentumfordítás szolgáltatáshoz érkező összes API-kéréshez egyéni tartományvégpont szükséges, amely az Azure Portal erőforrás-áttekintési oldalán található.

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

Kérelemparaméterek

A lekérdezési sztringen átadott kérelemparaméterek a következők:

Lekérdezési paraméter	Kötelező	Leírás
id	Igaz	A művelet azonosítója.

Az id érték keresése

A feladatot id a POST start-batch-translation metódus válaszfejlécÉNEK Operation-Location URL-címében találja. A paramétert követő /document/ alfanumerikus sztring a művelet feladata id:

Válaszfejléc	Válasz URL-címe
Művelet helye	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

• A fordítási feladatok és azok idlistájának lekéréséhez a get-translations állapotkérelmet is használhatja.

Kérésfejlécek

A kérelemfejlécek a következők:

Fejlécek	Leírás	Feltétel
Ocp-Apim-Subscription-Key	A Translator szolgáltatás API-kulcsa az Azure Portalról.	Kötelező
Ocp-Apim-Subscription-Region	Az a régió, ahol az erőforrás létre lett hozva.	• Olyan regionális (földrajzi) erőforrás használatakor szükséges, mint az USA nyugati régiója. >listajel.
Tartalomtípus	A hasznos adat tartalomtípusa. Az elfogadott érték az application/json vagy charset=UTF-8.	• Kötelező

Válaszállapot-kódok

A következő lehetséges HTTP-állapotkódokat adja vissza egy kérés.

Állapotkód	Leírás
200	OK. Sikeres kérelem, és visszaadja a kötegelt fordítási művelet állapotát. HeadersRetry-After: integerETag: string
401	Nem engedélyezett. Ellenőrizze a hitelesítő adatait.
404	Az erőforrás nem található.
500	Belső kiszolgálóhiba.
Egyéb állapotkódok	• Túl sok kérés • A kiszolgáló ideiglenesen nem érhető el

Fordítási állapotra adott válasz lekérése

Fordítási állapotra adott válasz sikeres lekérése

A rendszer a következő adatokat adja vissza egy sikeres válaszban.

Név	Típus	Leírás
id	húr	A művelet azonosítója.
createdDateTimeUtc	húr	A művelet létrehozta a dátumot.
lastActionDateTimeUtc	húr	A művelet állapotának frissítésének dátuma.
status	Sztring	Feladat vagy dokumentum lehetséges állapotainak listája: •Visszavont •Érvénytelenítés •Nem sikerült • Nincs megadva •Futás •Sikerült • ValidationFailed
összegzés	StatusSummary	A felsorolt adatokat tartalmazó összegzés.
summary.total	egész szám	Teljes szám.
summary.failed	egész szám	Sikertelen szám.
summary.success	egész szám	Sikeresek száma.
summary.inProgress	egész szám	Folyamatban lévők száma.
summary.notYetStarted	egész szám	Még nem kezdődött el.
summary.cancelled	egész szám	Megszakítottak száma.
summary.totalCharacterCharged	egész szám	Az API által felszámított összes karakter.

Hibaválasz

Név	Típus	Leírás
code	húr	Magas szintű hibakódokat tartalmazó enumerálások. Lehetséges értékek: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Jogosulatlan
üzenet	húr	Magas szintű hibaüzenetet kap.
target	húr	Lekéri a hiba forrását. Például érvénytelen dokumentumról van szó documents document id .
innerError	InnerTranslationError	Új belső hibaformátum, amely megfelel az Azure AI-szolgáltatások API-irányelveinek. Ez a hibaüzenet tartalmazza a szükséges tulajdonságokat: ErrorCode, üzenet és opcionális tulajdonságcél, részletek (kulcsértékpár), belső hiba (beágyazható).
innerError.code	húr	Kódhiba sztringet kap.
innerError.message	húr	Magas szintű hibaüzenetet kap.
innerError.target	húr	Lekéri a hiba forrását. Például érvénytelen dokumentumról van szó documents document id .

Példák

Példa a sikeres válaszra

A következő JSON-objektum egy sikeres válasz példája.

{
  "id": "727bf148-f327-47a0-9481-abae6362f11e",
  "createdDateTimeUtc": "2020-03-26T00:00:00Z",
  "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
  "status": "Succeeded",
  "summary": {
    "total": 10,
    "failed": 1,
    "success": 9,
    "inProgress": 0,
    "notYetStarted": 0,
    "cancelled": 0,
    "totalCharacterCharged": 0
  }
}

Példa hibaválaszra

Az alábbi JSON-objektum egy példa egy hibaválaszra. A többi hibakód sémája ugyanaz.

Állapotkód: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "User is not authorized",
    "target": "Document",
    "innerError": {
      "code": "Unauthorized",
      "message": "Operation is not authorized"
    }
  }
}

Következő lépések

A dokumentumfordítás és az ügyféloldali kódtár használatával kapcsolatos további információkért kövesse a rövid útmutatót.

Ismerkedés a dokumentumfordítással