Freigeben über

Document Translation - Get Supported Glossary Formats

Dienst:
Azure AI Services
API-Version:
v1.0

Gibt die Liste der unterstützten Glossarformate zurück
Die Liste der unterstützten Glossarformate, die vom Dokumentübersetzungsdienst unterstützt werden. Die Liste enthält die verwendete gemeinsame Dateierweiterung.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
endpoint
 path True

string

Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://westus.api.cognitive.microsoft.com).

Anforderungsheader

Name Erforderlich Typ Beschreibung
Ocp-Apim-Subscription-Key True

string

Stellen Sie hier Ihren Abonnementschlüssel für kognitive Dienste bereit.

Antworten

Name Typ Beschreibung
200 OK

SupportedFileFormats

Gibt die Liste der unterstützten Glossardateiformate zurück

Header

Retry-After: integer
429 Too Many Requests

TranslationErrorResponse

Zu viele Anforderungen
500 Internal Server Error

TranslationErrorResponse

Interner Serverfehler
Other Status Codes

TranslationErrorResponse

Temporärer Server nicht verfügbar

Sicherheit

Ocp-Apim-Subscription-Key

Stellen Sie hier Ihren Abonnementschlüssel für kognitive Dienste bereit.

Typ: apiKey
In: header

Beispiele

Get Glossary Formats

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
429 
{
  "error": {
    "code": "RequestRateTooHigh",
    "message": "User's request rate is too high",
    "innerError": {
      "code": "RateTooHigh",
      "message": "Request rate is too high"
    }
  }
}
Statuscode:
500 
{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}
Statuscode:
503 
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}
Statuscode:
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"
      ]
    }
  ]
}

Definitionen

Name Beschreibung
FileFormat
InnerTranslationError

Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
SupportedFileFormats

Basistyp für die Listenrückgabe in unserer API
TranslationError

Dies enthält einen äußeren Fehler mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit ausführlicheren Details.
TranslationErrorCode

Enumerationen, die Fehlercodes auf hoher Ebene enthalten.
TranslationErrorResponse

Enthält einheitliche Fehlerinformationen, die für HTTP-Antworten in jedem cognitive Service verwendet werden. Instanzen können entweder über Microsoft.CloudAI.Containers.HttpStatusExceptionV2 oder durch direkte Rückgabe von einem Controller erstellt werden.

FileFormat

Objekt
Name Typ Beschreibung
contentTypes

string[]

Unterstützte Inhaltstypen für dieses Format
defaultVersion

string

Standardversion, wenn keine angegeben ist
fileExtensions

string[]

Unterstützte Dateierweiterung für dieses Format
format

string

Name des Formats
versions

string[]

Unterstützte Version

InnerTranslationError

Objekt

Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).

Name Typ Beschreibung
code

string

Ruft Codefehlerzeichenfolge ab.
innerError

InnerTranslationError

Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message

string

Ruft eine Fehlermeldung auf hoher Ebene ab.
target

string

Ruft die Quelle des Fehlers ab. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

SupportedFileFormats

Objekt

Basistyp für die Listenrückgabe in unserer API

Name Typ Beschreibung
value

FileFormat[]

Liste der Objekte

TranslationError

Objekt

Dies enthält einen äußeren Fehler mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit ausführlicheren Details.

Name Typ Beschreibung
code

TranslationErrorCode

Enumerationen, die Fehlercodes auf hoher Ebene enthalten.
innerError

InnerTranslationError

Neues inneres Fehlerformat, das den Cognitive Services-API-Richtlinien entspricht, die unter https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8owverfügbar sind. Dies enthält die erforderlichen Eigenschaften ErrorCode, Meldung und optionale Eigenschaftenziel, Details(Schlüsselwertpaar), inneren Fehler(dies kann geschachtelt werden).
message

string

Ruft eine Fehlermeldung auf hoher Ebene ab.
target

string

Ruft die Quelle des Fehlers ab. Bei ungültigen Dokumenten wäre es z. B. "Dokumente" oder "Dokument-ID".

TranslationErrorCode

Enumeration

Enumerationen, die Fehlercodes auf hoher Ebene enthalten.

Wert Beschreibung
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Objekt

Enthält einheitliche Fehlerinformationen, die für HTTP-Antworten in jedem cognitive Service verwendet werden. Instanzen können entweder über Microsoft.CloudAI.Containers.HttpStatusExceptionV2 oder durch direkte Rückgabe von einem Controller erstellt werden.

Name Typ Beschreibung
error

TranslationError

Dies enthält einen äußeren Fehler mit Fehlercode, Meldung, Details, Ziel und einem inneren Fehler mit ausführlicheren Details.