Obtenir l’état de tous les travaux de traduction

Fonctionnalité de référence : Azure AI Translator → version de l’API Traduction
de documents : méthode HTTP 2024-05-01
: GET

• Utilisez la get translations status méthode pour demander une liste et l’état de tous les travaux de traduction soumis par l’utilisateur (associé à la ressource).

• Les paramètres de requête $top, $skip et $maxpagesize peuvent être utilisés pour spécifier un nombre de résultats à retourner et un décalage pour la collection.

  • $top indique le nombre total d’enregistrements à retourner sur toutes les pages.
  • $skip indique le nombre d’enregistrements à ignorer dans la liste des lots en fonction de la méthode de tri spécifiée. Par défaut, les enregistrements sont triés par heure de début décroissante.
  • $maxpagesize est le nombre maximal d’éléments retournés dans une page.
  • Si davantage d’éléments sont demandés via $top (ou si $top n’est pas spécifié et qu’il y a plus d’éléments à retourner), @nextLink contient le lien vers la page suivante.
  • Le serveur honore les valeurs spécifiées par le client. Toutefois, les clients doivent être prêts à gérer les réponses qui contiennent une taille de page différente ou un jeton de continuation.
  • Lorsque les deux $top et $skip sont inclus, le serveur s’applique $skip d’abord, puis $top sur la collection.

• $orderBy le paramètre de requête peut être utilisé pour trier la liste retournée (par exemple : $orderBy=createdDateTimeUtc asc ou $orderBy=createdDateTimeUtc desc).
  • Le tri par défaut est décroissant par createdDateTimeUtc. Certains paramètres de requête peuvent être utilisés pour filtrer la liste retournée (par exemple) status=Succeeded,Cancelledretourne les opérations réussies et annulées.
  • Les createdDateTimeUtcStart paramètres de createdDateTimeUtcEnd requête peuvent être combinés ou séparément pour spécifier une plage de datetime pour filtrer la liste retournée.
  • Les paramètres de requête de filtrage pris en charge sont (status, , idcreatedDateTimeUtcStartet createdDateTimeUtcEnd).

URL de la requête

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

Paramètres de la demande

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

En-têtes de requête

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

Codes d’état de réponse

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

Réponse de get translations status

Réponse positive de get translations status

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

Réponse d’erreur

Exemples

Exemple de réponse positive

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

{
    "value": [
        {
            "id": "36724748-f7a0-4db7-b7fd-f041ddc75033",
            "createdDateTimeUtc": "2021-06-18T03:35:30.153374Z",
            "lastActionDateTimeUtc": "2021-06-18T03:36:44.6155316Z",
            "status": "Succeeded",
            "summary": {
                "total": 3,
                "failed": 2,
                "success": 1,
                "inProgress": 0,
                "notYetStarted": 0,
                "cancelled": 0,
                "totalCharacterCharged": 0
            }
        },
        {
            "id": "1c7399a7-6913-4f20-bb43-e2fe2ba1a67d",
            "createdDateTimeUtc": "2021-05-24T17:57:43.8356624Z",
            "lastActionDateTimeUtc": "2021-05-24T17:57:47.128391Z",
            "status": "Failed",
            "summary": {
                "total": 1,
                "failed": 1,
                "success": 0,
                "inProgress": 0,
                "notYetStarted": 0,
                "cancelled": 0,
                "totalCharacterCharged": 0
            }
        },
        {
            "id": "daa2a646-4237-4f5f-9a48-d515c2d9af3c",
            "createdDateTimeUtc": "2021-04-14T19:49:26.988272Z",
            "lastActionDateTimeUtc": "2021-04-14T19:49:43.9818634Z",
            "status": "Succeeded",
            "summary": {
                "total": 2,
                "failed": 0,
                "success": 2,
                "inProgress": 0,
                "notYetStarted": 0,
                "cancelled": 0,
                "totalCharacterCharged": 21899
            }
        }
    ],
    ""@nextLink": "https://westus.cognitiveservices.azure.com/translator/text/batch/v1.1/operations/727BF148-F327-47A0-9481-ABAE6362F11E/documents?`$top`=5&`$skip`=15"
}

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.