Ottenere le origini di archiviazione supportate
Servizio di riferimento
: Versione dell'API Traduzione
documenti di Azure per intelligenza artificiale: v1.1
Il metodo Get supported storage sources (Recupera origini di archiviazione supportate) restituisce un elenco di origini di archiviazione/opzioni supportate dal servizio traduzione documenti.
Richiesta URL
Inviare una richiesta GET
a:
GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources
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.
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 l'elenco delle origini di archiviazione. |
500 | Errore interno del server. |
Altri codici di stato | • Troppe richieste • Server temporaneo non disponibile |
Ottenere la risposta alle origini di archiviazione supportate
Risposta corretta per ottenere le origini di archiviazione supportate
Tipo di base per l'elenco restituito nell'API Get supported storage sources (Ottieni origini di archiviazione supportate).
Nome | Tipo | Descrizione |
---|---|---|
value | string [] | Elenco di oggetti. |
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. |
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 target, details(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 il documento non fosse valido. |
Esempi
Esempio di risposta riuscita
L'oggetto JSON seguente è un esempio di risposta riuscita.
{
"value": [
"AzureBlob"
]
}
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",
"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.