Fordítás állapotának lekérése

  • Cikk

Referenciaszolgáltatás
: Azure AI Document Translation
API-verzió: 1.1-es verzió

A Fordítás lekérése állapot metódus egy dokumentumfordítási kérelem állapotát adja vissza. Az állapot tartalmazza a kérelem általános állapotát és a kérelem részeként lefordított dokumentumok állapotát.

URL-cím kérése

GET kérés küldése ide:

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}

Megtudhatja, hogyan keresheti meg az egyéni tartománynevet.

Fontos

  • A Dokumentumfordítási szolgáltatásnak küldött összes API-kéréshez egyéni tartományvégpont szükséges.
  • Nem használhatja az Azure Portal erőforráskulcsai és végpontoldalán található végpontot, sem a globális fordítóvégpontot –api.cognitive.microsofttranslator.com a dokumentumfordításra irányuló HTTP-kérések igényléséhez.

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.

Kérésfejlécek

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

Fejlécek Leírás
Ocp-Apim-Subscription-Key Szükséges kérelemfejléc

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ó documentsdocument 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ó documentsdocument 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