Document Translation - Get Supported Glossary Formats

Servicio:: Azure AI Services

Versión de la API:: v1.0

Devuelve la lista de formatos de glosario admitidos
La lista de formatos de glosario admitidos por el servicio traducción de documentos. La lista incluye la extensión de archivo común usada.

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string	Proporcione la clave de suscripción de Cognitive Services aquí.

Respuestas

Nombre	Tipo	Description
200 OK	SupportedFileFormats	Devuelve la lista de formatos de archivo de glosario admitidos Encabezados Retry-After: integer
429 Too Many Requests	TranslationErrorResponse	Demasiadas solicitudes
500 Internal Server Error	TranslationErrorResponse	Error interno del servidor
Other Status Codes	TranslationErrorResponse	Servidor temporal no disponible

Seguridad

Ocp-Apim-Subscription-Key

Proporcione la clave de suscripción de Cognitive Services aquí.

Tipo: apiKey
En: header

Ejemplos

Get Glossary Formats

Solicitud de ejemplo

HTTP

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

Respuesta de muestra

status code:: 429

{
  "error": {
    "code": "RequestRateTooHigh",
    "message": "User's request rate is too high",
    "innerError": {
      "code": "RateTooHigh",
      "message": "Request rate is too high"
    }
  }
}

status code:: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

status code:: 503

{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}

status code:: 200

retry-after: 30
ETag: 686897696a7c876b7e

{
  "value": [
    {
      "format": "XLIFF",
      "fileExtensions": [
        ".xlf"
      ],
      "contentTypes": [
        "application/xliff+xml"
      ],
      "defaultVersion": "1.2",
      "versions": [
        "1.0",
        "1.1",
        "1.2"
      ]
    },
    {
      "format": "TMX",
      "fileExtensions": [
        ".tmx"
      ],
      "contentTypes": [],
      "versions": [
        "1.0",
        "1.1",
        "1.2",
        "1.3",
        "1.4"
      ]
    }
  ]
}

Definiciones

Nombre	Description
FileFormat
InnerTranslationError	Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
SupportedFileFormats	Tipo base para la devolución de lista en nuestra API
TranslationError	Contiene un error externo con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.
TranslationErrorCode	Enumeraciones que contienen códigos de error de alto nivel.
TranslationErrorResponse	Contiene información de error unificada que se usa para las respuestas HTTP en cualquier servicio cognitivo. Las instancias se pueden crear a través de Microsoft.CloudAI.Containers.HttpStatusExceptionV2 o devolviéndolo directamente desde un controlador.

FileFormat

Object

Nombre	Tipo	Description
contentTypes	string[]	Tipos de contenido admitidos para este formato
defaultVersion	string	Versión predeterminada si no se especifica ninguna
fileExtensions	string[]	Extensión de archivo compatible para este formato
format	string	Nombre del formato
versions	string[]	Versión admitida

InnerTranslationError

Object

Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).

Nombre	Tipo	Description
code	string	Obtiene la cadena de error de código.
innerError	InnerTranslationError	Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message	string	Obtiene un mensaje de error de alto nivel.
target	string	Obtiene el origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.

SupportedFileFormats

Object

Tipo base para la devolución de lista en nuestra API

Nombre	Tipo	Description
value	FileFormat[]	lista de objetos

TranslationError

Object

Contiene un error externo con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.

Nombre	Tipo	Description
code	TranslationErrorCode	Enumeraciones que contienen códigos de error de alto nivel.
innerError	InnerTranslationError	Nuevo formato de error interno que se ajusta a las directrices de Cognitive Services API que están disponibles en https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Contiene las propiedades necesarias ErrorCode, message y propiedades opcionales de destino, details(key value pair), inner error(this can be nested).
message	string	Obtiene un mensaje de error de alto nivel.
target	string	Obtiene el origen del error. Por ejemplo, sería "documentos" o "id. de documento" en caso de documento no válido.

TranslationErrorCode

Enumeración

Enumeraciones que contienen códigos de error de alto nivel.

Valor	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Object

Contiene información de error unificada que se usa para las respuestas HTTP en cualquier servicio cognitivo. Las instancias se pueden crear a través de Microsoft.CloudAI.Containers.HttpStatusExceptionV2 o devolviéndolo directamente desde un controlador.

Nombre	Tipo	Description
error	TranslationError	Contiene un error externo con código de error, mensaje, detalles, destino y un error interno con detalles más descriptivos.

Compartir a través de

Document Translation - Get Supported Glossary Formats

Parámetros de identificador URI

Encabezado de la solicitud

Respuestas

Seguridad

Ocp-Apim-Subscription-Key

Ejemplos

Get Glossary Formats

Solicitud de ejemplo

Respuesta de muestra

Definiciones

FileFormat

InnerTranslationError

SupportedFileFormats

TranslationError

TranslationErrorCode

TranslationErrorResponse