Obter fontes de armazenamento compatíveis
Referência
Serviço: Tradução de documentos da IA do Azure
Versão da API: v1.1
O método Obter fontes de armazenamento com suporte retorna uma lista de fontes ou opções de armazenamento compatíveis com serviço de tradução de documento.
URL da solicitação
Envie uma solicitação GET
para:
GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/storagesources
Saiba como localizar seu nome de domínio personalizado.
Importante
- Todas as solicitações de API ao serviço de Tradução de Documento exigem um ponto de extremidade de domínio personalizado.
- Não é possível usar o ponto de extremidade encontrado na página Chaves e ponto de extremidade de recursos do portal do Azure nem o ponto de extremidade do tradutor global (
api.cognitive.microsofttranslator.com
) para fazer solicitações HTTP para a Tradução de Documento.
Cabeçalhos da solicitação
Os cabeçalhos de solicitação são:
Cabeçalhos | Descrição |
---|---|
Ocp-Apim-Subscription-Key | Cabeçalho de solicitação necessário |
Códigos de status de resposta
Veja a seguir os possíveis códigos de status HTTP retornados por uma solicitação.
Código de status | Descrição |
---|---|
200 | OK. Solicitação bem-sucedida e retorna a lista de origens de armazenamento. |
500 | Erro Interno do Servidor. |
Outros códigos de status | • Excesso de pedidos • Servidor temporário indisponível |
Resposta de Obter fontes de armazenamento com suporte
Resposta bem-sucedida de Obter fontes de armazenamento com suporte
Tipo base do retorno de lista na API Obter fontes de armazenamento com suporte.
Nome | Tipo | Descrição |
---|---|---|
value | string [] | Lista de objetos. |
Resposta de erro
Nome | Tipo | Descrição |
---|---|---|
code | string | Enumerações contendo códigos de erro de alto nível. Valores possíveis: • InternalServerError • Argumento Inválido • Solicitação Inválida • RequestRateTooHigh • ResourceNotFound • ServiçoIndisponível •Desautorizado |
message | string | Obtém uma mensagem de erro de alto nível. |
innerError | InnerTranslationError | Novo formato de erro interno, em conformidade com as Diretrizes da API dos serviços de IA do Azure. Essa mensagem de erro contém as propriedades necessárias ErrorCode, mensagem e destino de propriedades opcionais, detalhes (par de valores de chave), erro interno (ele pode ser aninhado). |
innerError.code | string | Obtém a cadeia de caracteres de erro do código. |
innerError.message | string | Obtém uma mensagem de erro de alto nível. |
innerError.target | string | Obtém a fonte do erro. Por exemplo, seria documents ou document id se houvesse um documento inválido. |
Exemplos
Exemplo de resposta bem-sucedida
O objeto JSON a seguir é um exemplo de uma resposta bem-sucedida.
{
"value": [
"AzureBlob"
]
}
Exemplo de resposta com erro
O objeto JSON a seguir é um exemplo de uma resposta com erro. O esquema dos outros códigos de erro é o mesmo.
Código de status: 500
{
"error": {
"code": "InternalServerError",
"message": "Internal Server Error",
"innerError": {
"code": "InternalServerError",
"message": "Unexpected internal server error has occurred"
}
}
}
Próximas etapas
Siga nosso guia de início rápido para saber mais sobre como usar a Tradução de Documento e a biblioteca de clientes.