Document Translation - Get Supported Glossary Formats

서비스:: Azure AI Services

API 버전:: v1.0

지원되는 용어집 형식 목록을 반환합니다.
문서 번역 서비스에서 지원하는 지원되는 용어집 형식 목록입니다. 목록에는 사용되는 일반적인 파일 확장명입니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
endpoint	path	True	string	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

요청 헤더

Name	필수	형식	Description
Ocp-Apim-Subscription-Key	True	string	여기에서 Cognitive Services 구독 키를 제공합니다.

응답

Name	형식	Description
200 OK	SupportedFileFormats	지원되는 용어집 파일 형식 목록을 반환합니다. 헤더 Retry-After: integer
429 Too Many Requests	TranslationErrorResponse	요청이 너무 많습니다.
500 Internal Server Error	TranslationErrorResponse	내부 서버 오류
Other Status Codes	TranslationErrorResponse	서버를 임시로 사용할 수 없음

보안

Ocp-Apim-Subscription-Key

여기에서 Cognitive Services 구독 키를 제공합니다.

형식: apiKey
In(다음 안에): header

예제

Get Glossary Formats

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 429

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

상태 코드:: 500

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

상태 코드:: 503

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

상태 코드:: 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"
      ]
    }
  ]
}

정의

Name	Description
FileFormat
InnerTranslationError	https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 ErrorCode, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.
SupportedFileFormats	API의 목록 반환에 대한 기본 형식
TranslationError	여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 외부 오류가 포함됩니다.
TranslationErrorCode	높은 수준의 오류 코드를 포함하는 열거형입니다.
TranslationErrorResponse	모든 Cognitive Service에서 HTTP 응답에 사용되는 통합 오류 정보를 포함합니다. 인스턴스는 Microsoft.CloudAI.Containers.HttpStatusExceptionV2를 통해 만들거나 컨트롤러에서 직접 반환하여 만들 수 있습니다.

FileFormat

Object

Name	형식	Description
contentTypes	string[]	이 형식에 대해 지원되는 콘텐츠 형식
defaultVersion	string	기본 버전이 지정되지 않은 경우
fileExtensions	string[]	이 형식에 대해 지원되는 파일 확장명입니다.
format	string	형식의 이름
versions	string[]	지원되는 버전

InnerTranslationError

Object

https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 ErrorCode, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.

Name	형식	Description
code	string	코드 오류 문자열을 가져옵니다.
innerError	InnerTranslationError	https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 ErrorCode, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	높은 수준의 오류 메시지를 가져옵니다.
target	string	오류의 원인을 가져옵니다. 예를 들어 잘못된 문서의 경우 "문서" 또는 "문서 ID"가 됩니다.

SupportedFileFormats

Object

API의 목록 반환에 대한 기본 형식

Name	형식	Description
value	FileFormat[]	개체 목록

TranslationError

Object

여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 외부 오류가 포함됩니다.

Name	형식	Description
code	TranslationErrorCode	높은 수준의 오류 코드를 포함하는 열거형입니다.
innerError	InnerTranslationError	https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow사용할 수 있는 Cognitive Services API 지침을 준수하는 새로운 내부 오류 형식입니다. 여기에는 ErrorCode, 메시지 및 선택적 속성 대상, details(키 값 쌍), 내부 오류(중첩될 수 있음)가 포함됩니다.
message	string	높은 수준의 오류 메시지를 가져옵니다.
target	string	오류의 원인을 가져옵니다. 예를 들어 잘못된 문서의 경우 "문서" 또는 "문서 ID"가 됩니다.

TranslationErrorCode

열거형

높은 수준의 오류 코드를 포함하는 열거형입니다.

값	Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Object

모든 Cognitive Service에서 HTTP 응답에 사용되는 통합 오류 정보를 포함합니다. 인스턴스는 Microsoft.CloudAI.Containers.HttpStatusExceptionV2를 통해 만들거나 컨트롤러에서 직접 반환하여 만들 수 있습니다.

Name	형식	Description
error	TranslationError	여기에는 오류 코드, 메시지, 세부 정보, 대상 및 보다 설명적인 세부 정보가 포함된 내부 오류가 포함된 외부 오류가 포함됩니다.

다음을 통해 공유

Document Translation - Get Supported Glossary Formats

URI 매개 변수

요청 헤더

응답

보안

Ocp-Apim-Subscription-Key

예제

Get Glossary Formats

샘플 요청

샘플 응답

정의

FileFormat

InnerTranslationError

SupportedFileFormats

TranslationError

TranslationErrorCode

TranslationErrorResponse