Annuler la traduction

  • Article

Service de référence
: Traduction de documentation Azure AI
Version de l’API : v1.1

Annule une opération en cours de traitement ou en file d’attente. Une opération n’est pas annulée si elle est terminée, a échoué ou annulée. Une demande incorrecte est renvoyé. Les traductions terminées ne sont pas annulées et sont facturées. Toutes les traductions en attente sont annulées si possible.

URL de la demande

Envoyez une demande DELETE à :

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

Découvrez comment déterminer votre nom de domaine personnalisé.

Important

  • Toutes les requêtes d’API adressées au service Traduction de documentation nécessitent un point de terminaison de domaine personnalisé.
  • Vous ne pouvez pas utiliser le point de terminaison qui se trouve dans la page Clés et point de terminaison de votre ressource du portail Azure, ni le point de terminaison du traducteur global (api.cognitive.microsofttranslator.com) pour soumettre des requêtes HTTP au service Traduction de documentation.

Paramètres de la demande

Les paramètres de demande transmis à la chaîne de requête sont les suivants :

Paramètre de requête. Obligatoire Description
id True ID de l’opération.

En-têtes de requête

Les en-têtes de requête sont les suivants :

headers Description
Ocp-Apim-Subscription-Key En-tête de requête obligatoire

Codes d’état de réponse

Voici les codes d’état HTTP qu’une demande peut retourner.

Code d’état Description
200 OK. Annuler la demande envoyée
401 Non autorisé. Vérifiez vos informations d’identification.
404 Introuvable. La ressource est introuvable.
500 Erreur interne du serveur.
Autres codes d’état • Trop de demandes
• Serveur temporaire indisponible

Réponse de cancel translation

Réponse correcte

Les informations suivantes sont retournées dans une réponse positive.

Nom Type Description
id string ID de l'opération.
createdDateTimeUtc string Date et heure de création de l’opération.
lastActionDateTimeUtc string Date à laquelle l’état de l’opération est mis à jour.
statut Chaîne Liste des états possibles pour le travail ou le document : • Annulé
•Annulation
•Échoué
• NotStarted
•Exécution
•Réussi
• Échec de la validation
résumé StatusSummary Résumé contenant une liste de détails.
summary.total entier Nombre total de documents.
summary.failed entier Nombre de documents ayant échoué.
summary.success entier Nombre de documents traduits avec succès.
summary.inProgress entier Nombre de documents en cours de traitement.
summary.notYetStarted entier Nombre de documents dont le traitement n’a pas encore commencé.
summary.cancelled entier Nombre de documents annulés.
summary.totalCharacterCharged entier Nombre total de caractères facturés par l’API.

Réponse d’erreur

Nom Type Description
code string Enums contenant des codes d’erreur généraux. Valeurs possibles :
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Non autorisée
message string Obtient un message d’erreur général.
target string Obtient la source de l’erreur. Par exemple, il s’agirait de « documents » ou document id pour un document non valide.
innerError InnerTranslationError Nouveau format d’erreur interne conforme aux instructions de l’API Azure AI services. Ce message d'erreur contient les propriétés obligatoires ErrorCode, le message et la cible de propriétés facultatives, les détails (paire clé-valeur) et l’erreur interne (qui peut être imbriquée).
innerError.code string Obtient la chaîne d’erreur de code.
innerError.message string Obtient un message d’erreur général.
innerError.target string Obtient la source de l’erreur. Par exemple, ce serait documents ou document id s’il y avait un document non valide.

Exemples

Exemple de réponse positive

L’objet JSON suivant est un exemple de réponse positive.

Code d’état : 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
  }
}

Exemple de réponse d’erreur

L’objet JSON suivant est un exemple de réponse d’erreur. Le schéma des autres codes d’erreur est le même.

Code d’état : 500

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

Étapes suivantes

Suivez notre guide de démarrage rapide pour en savoir plus sur l’utilisation du service Traduction de document et de la bibliothèque de client.

Bien démarrer avec la traduction de documentation