Dela via

Avbryt översättning

  • Artikel

Referensfunktion
: Azure AI Translator → API-version för dokumentöversättning
: HTTP-metod 2024-05-01
: DELETE

  • Den här metoden avbryter ett översättningsjobb som för närvarande bearbetas eller placeras i kö (väntar) enligt frågeparameterns id begäran.
  • En åtgärd avbryts inte om den redan har slutförts, misslyckats eller fortfarande avbryts. I dessa fall returneras en felaktig begäran.
  • Slutförda översättningar kan inte avbrytas och debiteras.

Begärans-URL

Viktigt!

Alla API-begäranden till funktionen Dokumentöversättning kräver en anpassad domänslutpunkt som finns på resursöversiktssidan i Azure Portal.

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

Parametrar för begäran

Begärandeparametrar som skickas på frågesträngen är:

Frågeparameter Obligatoriskt Beskrivning
id Sant Åtgärds-ID.

Hitta värdet id

Du hittar jobbet id i POST-metodens start-batch-translation svarshuvud-URL-värde Operation-Location . Den alfanumeriska strängen som följer parametern /document/ är åtgärdens jobb id:

Svarsrubrik Svars-URL
Åtgärdsplats {document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

Begärandehuvuden

Begärandehuvuden är:

Sidhuvuden beskrivning
Ocp-Apim-Subscription-Key Obligatoriskt begärandehuvud

Svarsstatuskoder

Följande är de möjliga HTTP-statuskoder som en begäran returnerar.

Statuskod beskrivning
200 OK. Avbryt begäran som skickats
401 Behörighet saknas. Kontrollera dina autentiseringsuppgifter.
404 Hittades inte Det går inte att hitta resursen.
500 Internt serverfel.
Andra statuskoder • För många förfrågningar
• Servern är tillfälligt otillgänglig

Avbryt översättningssvar

Lyckat svar

Följande information returneras i ett lyckat svar.

Namn Type Description
id sträng ID för åtgärden.
createdDateTimeUtc sträng Åtgärden skapade datumtid.
lastActionDateTimeUtc sträng Datum då åtgärdens status uppdateras.
status String Lista över möjliga statusar för jobb eller dokument: • Avbröts
•Avbryta
•Misslyckades
• Ej startad
•Löpning
•Lyckades
• ValidationFailed
Sammanfattning StatusSumma Sammanfattning som innehåller en lista med information.
summary.total integer Antal dokument totalt.
summary.failed integer Antalet dokument misslyckades.
summary.success integer Antal dokument som har översatts.
summary.inProgress integer Antal dokument som pågår.
summary.notYetStarted integer Antalet dokument som ännu inte har börjat bearbetas.
summary.cancelled integer Antal avbrutna.
summary.totalCharacterCharged integer Totalt antal tecken som debiteras av API:et.

Felsvar

Namn Type Beskrivning
kod sträng Uppräkningar som innehåller felkoder på hög nivå. Möjliga värden:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Obehörig
meddelande sträng Hämtar felmeddelande på hög nivå.
mål sträng Hämtar källan till felet. Det skulle till exempel vara "dokument" eller document id för ett ogiltigt dokument.
innerError InnerTranslationError Nytt format för inre fel som överensstämmer med API-riktlinjerna för Azure AI-tjänster. Det här felmeddelandet innehåller nödvändiga egenskaper ErrorCode, meddelande och valfria egenskaper, information (nyckelvärdespar), inre fel (det kan kapslas).
innerError.code sträng Hämtar kodfelsträngen.
innerError.message sträng Hämtar felmeddelande på hög nivå.
innerError.target sträng Hämtar källan till felet. Det skulle till exempel vara documents eller document id om det fanns ett ogiltigt dokument.

Exempel

Exempel på lyckat svar

Följande JSON-objekt är ett exempel på ett lyckat svar.

Statuskod: 200

{
  "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
  }
}

Exempel på felsvar

Följande JSON-objekt är ett exempel på ett felsvar. Schemat för andra felkoder är detsamma.

Statuskod: 500

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

Nästa steg

Följ vår snabbstart om du vill veta mer om hur du använder dokumentöversättning och klientbiblioteket.

Kom igång med dokumentöversättning