Abrufen unterstützter Glossarformate

Artikel
09/01/2024

Referenzfeature: Azure AI Translator → Version der Dokumentübersetzungs-API
: 2024-05-01
HTTP-Methode: GET

Diese Methode gibt eine Liste von Glossarformaten zurück, die vom Feature "Dokumentübersetzung" unterstützt werden. Die Liste enthält die allgemeinen Dateierweiterungen.

Anforderungs-URL

Wichtig

Für alle API-Anforderungen an das Feature „Dokumentübersetzung“ ist ein benutzerdefinierter Domänenendpunkt erforderlich, der sich auf der Seite „Ressourcenübersicht“ im Azure-Portal befindet.

curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary"

Anforderungsheader

Anforderungsheader:

Header	Beschreibung	Bedingung
Ocp-Apim-Subscription-Key	Ihr Übersetzerdienst-API-Schlüssel aus dem Azure-Portal.	Erforderlich
Ocp-Apim-Subscription-Region	Die Region, in der Ihre Ressource erstellt wurde.	Erforderlich bei Verwendung einer regionalen (geografischen) Ressource wie West-USA. &aufzählungszeichen.
Content-Type	Der Inhaltstyp der Nutzdaten. Die akzeptierten Werte sind application/json oder charset=UTF-8.	Erforderlich

Antwortstatuscodes

Im Folgenden finden Sie die möglichen HTTP-Statuscodes, die eine Anforderung zurückgeben kann.

Statuscode	BESCHREIBUNG
200	OK. Gibt die Liste der unterstützten Glossarformate der Datei zurück.
500	Interner Serverfehler.
Andere Statuscodes	• Zu viele Anforderungen • Temporärer Server nicht verfügbar

Rufen Sie die unterstützte Glossarformat-Antwort ab

Basistyp für die Listenrückgabe in der API Unterstützte Glossarformate abrufen.

Abrufen der Antwort von Glossarformaten erfolgreich

Basistyp für die Listenrückgabe in der API Unterstützte Glossarformate abrufen.

Name	Typ	BESCHREIBUNG
value	FileFormat []	„FileFormat[]“ enthält die aufgeführten Details.
value.contentTypes	string []	Unterstützte Inhaltstypen für dieses Format.
value.defaultVersion	Zeichenfolge	Standardversion, wenn keine angegeben ist
value.fileExtensions	string []	Unterstützte Dateierweiterung für dieses Format.
value.format	Zeichenfolge	Der Name des Formats.
value.versions	string []	Unterstützte Version.

Fehlerantwort

Name	Typ	BESCHREIBUNG
code	Zeichenfolge	Enumerationen, die High-Level-Fehlercodes enthalten. Mögliche Werte: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Unbefugt
message	Zeichenfolge	Ruft High-Level-Fehlermeldung ab.
innerError	InnerTranslationError	Neues Format für innere Fehler, das den Richtlinien der Azure KI Services-API entspricht. Diese Fehlermeldung enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler (es kann geschachtelt werden).
innerError.code	Zeichenfolge	Ruft Code der Fehlerzeichenfolge ab.
innerError.message	Zeichenfolge	Ruft High-Level-Fehlermeldung ab.
innerError.target	Zeichenfolge	Ruft die Ursache des Fehlers ab. Würde im Fall eines ungültigen Dokuments z. B. `documents` oder `document id` lauten.

Beispiele

Beispiel für erfolgreiche Antwort

Das folgende JSON-Objekt ist ein Beispiel für eine erfolgreiche Antwort.

{
    "value": [
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "defaultVersion": "1.2",
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ]
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ]
        }
    ]
}

Beispiel für Fehlerantwort

Das folgende JSON-Objekt ist ein Beispiel für eine Fehlerantwort. Das Schema für andere Fehlercodes ist identisch.

Statuscode: 500

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

Nächste Schritte

Befolgen Sie unsere Schnellstartanleitung, um mehr über die Verwendung der Dokumentübersetzung und der Clientbibliothek zu erfahren.

Erste Schritte bei der Dokumentübersetzung

Freigeben über