Partager via

Obtenir l’état de tous les documents

Fonctionnalité de référence
: Méthode HTTP d’Azure Translator → Version de l’API traduction de documents
: méthode HTTP 2024-05-01
: GET

Important

Toutes les demandes d’API adressées à la fonctionnalité de traduction de documents nécessitent un point de terminaison de domaine personnalisé situé sur la page vue d’ensemble de votre ressource dans le portail Azure.

  • Utilisez la get documents status méthode pour demander l’état de tous les documents d’un travail de traduction.

  • 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 que l’utilisateur souhaite voir retournés dans toutes les pages.
    • $skip indique le nombre d’enregistrements à ignorer dans la liste des états de documents détenus par le serveur 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.
    • Si le nombre de documents dans la réponse dépasse notre limite de pagination, la pagination côté serveur est utilisée.
    • Les réponses paginées indiquent un résultat partiel et incluent un jeton de continuation dans la réponse. L’absence de jeton de continuation signifie qu’aucune autre page n’est disponible.

Remarque

Si le serveur ne peut pas honorer $top et/ou $skip, il doit retourner une erreur au client afin de l’en informer au lieu d’ignorer simplement les options de requête. Cette action réduit le risque que le client effectue des hypothèses sur les données retournées.

  • $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,Cancelledrenvoie uniquement les documents réussis et annulés.
  • Les createdDateTimeUtcStart paramètres de createdDateTimeUtcEnd requête peuvent être combinés ou utilisés 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).
  • Lorsque $top et$skip sont tous deux inclus, le serveur doit d’abord appliquer $skip puis $top à la collection.

URL de la demande

Envoyez une demande GET à :

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

Recherche de la valeur id

  • L’id de travail se trouve dans la valeur d’URL start-batch-translation de l’en-tête de réponse de la méthode Operation-Location POST. La chaîne alphanumérique qui suit le paramètre /document/ est l’id de travail de l’opération :
En-tête de réponse URL de réponse
Opération-Emplacement {document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec ?api-version=2024-05-01
  • Vous pouvez également utiliser une requête get-translations-status pour récupérer une liste de travaux de traduction et leurs id.

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. Dans Obligatoire Catégorie Descriptif
id chemin Vrai ficelle ID de l’opération.
$maxpagesize requête Faux entier int32 $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. Les clients peuvent demander une pagination pilotée par le serveur avec une taille de page spécifique en spécifiant une $maxpagesize préférence. Le serveur DOIT respecter cette préférence si la taille de page spécifiée est inférieure à la taille de page par défaut du serveur.
$orderBy requête Faux tableau La requête de tri pour la collection (ex : CreatedDateTimeUtc asc, CreatedDateTimeUtc desc).
$skip requête Faux entier int32 $skip indique le nombre d’enregistrements à ignorer dans la liste des enregistrements détenus par le serveur en fonction de la méthode de tri spécifiée. Par défaut, le tri est effectué par ordre décroissant de l’heure de début. Les clients PEUVENT utiliser les paramètres de requête $top et $skip pour spécifier un nombre de résultats à retourner et un décalage dans la collection. Lorsque le client retourne à la fois $top et$skip, le serveur DOIT d’abord appliquer $skip puis $top à la collection. Si le serveur ne peut pas respecter $top et/ou $skip, le serveur DOIT renvoyer une erreur au client en l’informant au lieu d’ignorer simplement les options de requête.
$top requête Faux entier int32 $top indique le nombre total d’enregistrements que l’utilisateur souhaite voir retournés dans toutes les pages. Les clients peuvent utiliser $top et $skip interroger des paramètres pour spécifier le nombre de résultats à retourner et un décalage dans la collection. Lorsque le client retourne à la fois $top et$skip, le serveur DOIT d’abord appliquer $skip puis $top à la collection. Si le serveur ne peut pas respecter $top et/ou $skip, le serveur DOIT renvoyer une erreur au client en l’informant au lieu d’ignorer simplement les options de requête.
createdDateTimeUtcEnd requête Faux chaîne date-heure Date et heure de fin pour l’extraction des éléments.
createdDateTimeUtcStart requête Faux chaîne date-heure Date et heure de début pour l’extraction des éléments.
ids requête Faux tableau ID à utiliser pour le filtrage.
Statuts requête Faux tableau États à utiliser pour le filtrage.

En-têtes de requête

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

headers Descriptif Condition
Ocp-Apim-Subscription-Key Votre clé API Translator à partir du portail Azure. Obligatoire
Ocp-Apim-Subscription-Region Région dans laquelle votre ressource a été créée. Obligatoire lors de l’utilisation d’une ressource régionale (géographique) comme USA Ouest
Type de contenu Type de contenu de la charge utile. Les valeurs acceptées sont application/json ou charset=UTF-8. Obligatoire

Codes d’état de réponse

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

Code d’état Descriptif
200 D’ACCORD. Demande réussie, et retourne l’état des documents. HeadersRetry-After : integerETag : string
400 Demande non valide. Vérifiez les paramètres d’entrée.
401 Non autorisé. Vérifiez vos informations d’identification.
404 La ressource est introuvable.
500 Erreur interne du serveur.
Autres codes d’état • Trop de demandes
• Le serveur n’est pas disponible temporairement

Réponse de la méthode get documents status

Réponse positive de la méthode get documents status

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

Nom Catégorie Descriptif
@nextLink ficelle URL de la page suivante. Null s’il n’y a plus de page disponible.
valeur DocumentStatus [] Liste d’états détaillée des documents individuels.
value.path ficelle Emplacement du document ou du dossier.
value.sourcePath ficelle Emplacement du document source.
value.createdDateTimeUtc ficelle Date et heure de création de l’opération.
value.lastActionDateTimeUtc ficelle Date à laquelle l’état de l’opération est mis à jour.
value.status statut Liste des états possibles pour un travail ou un document.
• Annulé
•Annulation
•Raté
• NotStarted
•Course
•Réussi
• Échec de la validation
value.to ficelle Langue cible.
value.progress nombre Progression de la traduction, si elle est disponible.
value.id ficelle ID de document.
value.characterCharged entier Caractères facturés par l’API.

Réponse d’erreur

Nom Catégorie Descriptif
code ficelle Enums contenant des codes d’erreur généraux. Valeurs acceptées :
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Non autorisée
Message ficelle Obtient un message d’erreur général.
cible ficelle Obtient la source de l’erreur. Par exemple, ce serait documents ou document id pour un document non valide.
erreur interne InnerTranslationError Nouveau format d’erreur interne conforme aux instructions de l’API Foundry Tools. 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 ficelle Obtient la chaîne d’erreur de code.
innerError.message ficelle Obtient un message d’erreur général.
innerError.target ficelle Obtient la source de l’erreur. Par exemple, ce serait documents ou document id s’il y avait un document non valide.

Exemples

Conseil

Utilisez cette méthode pour récupérer le documentId paramètre de la chaîne de requête get-document-status .

Exemple de réponse positive

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

{
  "value": [
    {
      "path": "https://myblob.blob.core.windows.net/destinationContainer/fr/mydoc.txt",
      "sourcePath": "https://myblob.blob.core.windows.net/sourceContainer/fr/mydoc.txt",
      "createdDateTimeUtc": "2020-03-26T00:00:00Z",
      "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
      "status": "Running",
      "to": "fr",
      "progress": 0.1,
      "id": "273622bd-835c-4946-9798-fd8f19f6bbf2",
      "characterCharged": 0
    }
  ],
  "@nextLink": "https://westus.cognitiveservices.azure.com/translator/text/batch/v1.1/operation/0FA2822F-4C2A-4317-9C20-658C801E0E55/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 de la traduction de documents et de la bibliothèque cliente.

Prise en main de la traduction de documents

  • Last updated on