Ottenere lo stato delle traduzioni
Servizio di riferimento
: Versione dell'API Traduzione
documenti di Azure per intelligenza artificiale: v1.1
Il metodo Get translations status restituisce un elenco di richieste batch inviate e lo stato per ogni richiesta. Questo elenco contiene solo le richieste batch inviate dall'utente (in base alla risorsa).
Se il numero di richieste supera il limite di paging, viene usato il paging lato server. Le risposte impaginate indicano un risultato parziale e includono un token di continuazione nella risposta. L'assenza di un token di continuazione significa che non sono disponibili altre pagine.
$top
I parametri di query , $skip
e $maxpagesize
possono essere usati per specificare il numero di risultati da restituire e un offset per la raccolta.
$top
indica il numero totale di record che l'utente desidera restituire in tutte le pagine. $skip
indica il numero di record da ignorare dall'elenco di batch in base al metodo di ordinamento specificato. Per impostazione predefinita, l'ordinamento viene eseguito in base all'ora di inizio decrescente. $maxpagesize
è il numero massimo di elementi restituiti in una pagina. Se vengono richiesti più elementi tramite $top
(o $top
non viene specificato e sono presenti più elementi da restituire), @nextLink conterrà il collegamento alla pagina successiva.
$orderBy parametro di query può essere usato per ordinare l'elenco restituito ,ad esempio "$orderBy=createdDateTimeUtc asc" o "$orderBy=createdDateTimeUtc desc"). L'ordinamento predefinito è decrescente in base a createdDateTimeUtc. Alcuni parametri di query possono essere usati per filtrare l'elenco restituito (ad esempio"status=Succeeded,Cancelled") restituisce le operazioni riuscite e annullate. createdDateTimeUtcStart e createdDateTimeUtcEnd possono essere usati in combinazione o separatamente per specificare un intervallo di datetime in base al quale filtrare l'elenco restituito. I parametri di query di filtro supportati sono (stato, ID, createdDateTimeUtcStart, createdDateTimeUtcEnd).
Il server rispetta i valori specificati dal client. Tuttavia, i client devono essere preparati a gestire le risposte che contengono dimensioni di pagina diverse o che contengono un token di continuazione.
Quando vengono inclusi sia $top
che $skip
, il server deve prima applicare $skip
e quindi $top
nella raccolta.
Nota
Se il server non può rispettare $top
e/o $skip
, il server deve restituire un errore al client informandolo invece di ignorare solo le opzioni di query. In questo modo si riduce il rischio che il client eseduca presupposti sui dati restituiti.
Richiesta URL
Inviare una richiesta GET
a:
GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batches
Informazioni su come trovare il nome di dominio personalizzato.
Importante
- Tutte le richieste API al servizio traduzione documenti richiedono un endpoint di dominio personalizzato.
- Non è possibile usare l'endpoint trovato nella pagina delle chiavi e dell'endpoint della risorsa portale di Azure né nell'endpoint traduttore globale,
api.cognitive.microsofttranslator.com
per effettuare richieste HTTP a Traduzione documenti.
Parametri della richiesta
I parametri della richiesta inviati a una stringa di query sono:
Query parameter (Parametro di query) | Tra | Richiesto | Type | Descrizione |
---|---|---|---|---|
$maxpagesize |
query | Falso | integer int32 | $maxpagesize è il numero massimo di elementi restituiti in una pagina. Se vengono richiesti più elementi tramite $top (o $top non viene specificato e sono presenti più elementi da restituire), @nextLink conterrà il collegamento alla pagina successiva. I client POSSONO richiedere il paging basato su server con dimensioni di pagina specifiche specificando una $maxpagesize preferenza. Il server DEVE rispettare questa preferenza se le dimensioni della pagina specificate sono inferiori alle dimensioni predefinite della pagina del server. |
$orderBy | query | Falso | array | Query di ordinamento per la raccolta (ad esempio CreatedDateTimeUtc asc , , CreatedDateTimeUtc desc ) |
$skip |
query | Falso | integer int32 | $skip indica il numero di record da ignorare dall'elenco di record contenuti nel server in base al metodo di ordinamento specificato. Per impostazione predefinita, l'ordinamento viene eseguito in base all'ora di inizio decrescente. I client POSSONO utilizzare $top parametri di query e $skip per specificare il numero di risultati da restituire e un offset nella raccolta. Quando il client restituisce sia $top e $skip , il server DEVE prima applicare $skip e quindi $top nella raccolta. Nota: se il server non può rispettare $top e/o $skip , il server DEVE restituire un errore al client informandolo invece di ignorare solo le opzioni di query. |
$top |
query | Falso | integer int32 | $top indica il numero totale di record che l'utente desidera restituire in tutte le pagine. I client POSSONO utilizzare $top parametri di query e $skip per specificare il numero di risultati da restituire e un offset nella raccolta. Quando il client restituisce sia $top e $skip , il server DEVE prima applicare $skip e quindi $top nella raccolta. Nota: se il server non può rispettare $top e/o $skip , il server DEVE restituire un errore al client informandolo invece di ignorare solo le opzioni di query. |
createdDateTimeUtcEnd | query | Falso | stringa data e ora | Data/ora di fine per ottenere gli elementi prima. |
createdDateTimeUtcStart | query | Falso | stringa data e ora | Data/ora di inizio per ottenere gli elementi dopo. |
ids |
query | Falso | array | ID da usare nei filtri. |
Stati | query | Falso | array | Stati da usare nel filtro. |
Intestazioni delle richieste
Le intestazioni della richiesta sono le seguenti:
Intestazioni | Descrizione |
---|---|
Ocp-Apim-Subscription-Key | Intestazione della richiesta obbligatoria |
Codici di stato della risposta
Di seguito sono riportati i possibili codici di stato HTTP restituiti da una richiesta.
Codice di stato | Descrizione |
---|---|
200 | OK. Richiesta riuscita e restituisce lo stato di tutte le operazioni. HeadersRetry-After: integerETag: string |
400 | Richiesta non valida. Richiesta non valida. Controllare i parametri di input. |
401 | Non autorizzato. Controllare le credenziali. |
500 | Errore interno del server. |
Altri codici di stato | • Troppe richieste • Server temporaneo non disponibile |
Ottenere la risposta dello stato delle traduzioni
Risposta di stato di recupero delle traduzioni riuscita
Le informazioni seguenti vengono restituite in una risposta con esito positivo.
Nome | Tipo | Descrizione |
---|---|---|
@nextLink | string | URL per la pagina successiva. Null se non sono disponibili altre pagine. |
value | TranslationStatus[] | TranslationStatus[] Matrice |
value.id | string | ID dell'operazione. |
value.createdDateTimeUtc | string | L'operazione ha creato data e ora. |
value.lastActionDateTimeUtc | string | Data di aggiornamento dello stato dell'operazione. |
value.status | String | Elenco degli stati possibili per il processo o il documento: • Annullata •Annullamento •Fallito • NotStarted •Corsa •Riuscito • ConvalidaFailed |
value.summary | StatusSummary[] | Riepilogo contenente i dettagli elencati. |
value.summary.total | integer | Conteggio dei documenti totali. |
value.summary.failed | integer | Numero di documenti non riusciti. |
value.summary.success | integer | Conteggio dei documenti tradotti correttamente. |
value.summary.inProgress | integer | Numero di documenti in corso. |
value.summary.notYetStarted | integer | Numero di documenti non ancora avviati per l'elaborazione. |
value.summary.cancelled | integer | Numero di documenti annullati. |
value.summary.totalCharacterCharged | integer | Numero totale di caratteri addebitati. |
Risposta con errore
Nome | Tipo | Descrizione |
---|---|---|
codice | string | Enumerazioni contenenti codici di errore di alto livello. Valori possibili: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • Servizio Non disponibile • Non autorizzato |
messaggio | string | Ottiene un messaggio di errore di alto livello. |
bersaglio | string | Ottiene l'origine dell'errore. Ad esempio, sarebbe documents o document id se fosse presente un documento non valido. |
innerError | InnerTranslationError | Nuovo formato di errore interno conforme alle linee guida dell'API dei servizi di intelligenza artificiale di Azure. Questo messaggio di errore contiene le proprietà necessarie ErrorCode, message e proprietà facoltative di destinazione, dettagli (coppia chiave-valore), errore interno (può essere annidato). |
innerError.code | string | Ottiene la stringa di errore del codice. |
innerError.message | string | Ottiene un messaggio di errore di alto livello. |
innerError.target | string | Ottiene l'origine dell'errore. Ad esempio, sarebbe documents o document id se fosse presente un documento non valido. |
Esempi
Esempio di risposta riuscita
L'oggetto JSON seguente è un esempio di risposta riuscita.
{
"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"
}
Esempio di risposta di errore
L'oggetto JSON seguente è un esempio di risposta di errore. Lo schema per altri codici di errore è lo stesso.
Codice di stato: 500
{
"error": {
"code": "InternalServerError",
"message": "Internal Server Error",
"target": "Operation",
"innerError": {
"code": "InternalServerError",
"message": "Unexpected internal server error has occurred"
}
}
}
Passaggi successivi
Seguire la guida introduttiva per altre informazioni sull'uso della traduzione dei documenti e della raccolta client.