Belirli bir çeviri işinin durumunu alma

Başvuru
Özelliği: Azure AI Translator → Belge çeviriSI
API'si Sürümü: 2024-05-01
HTTP yöntemi: GET

• get translation status Belirli bir çeviri işinin durumunu istemek için yöntemini kullanın. Yanıt, genel iş durumunu ve bu işin bir parçası olarak çevrilen belgelerin durumunu içerir.

İstek URL’si

Önemli

Belge çevirisi özelliğine yönelik tüm API istekleri, Azure portalındaki kaynağınıza genel bakış sayfasında bulunan özel bir etki alanı uç noktası gerektirir.

curl -i -X GET "{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}"

İstek parametreleri

Sorgu dizesinde geçirilen istek parametreleri şunlardır:

Sorgu parametresi	Zorunlu	Açıklama
id	Doğru	İşlem kimliği.

Değeri bulma id

İşi id POST start-batch-translation yöntemi yanıt Üst Bilgi Operation-Location URL'si değerinde bulabilirsiniz. parametresini /document/ izleyen alfasayısal dize, işlemin işidir id:

Yanıt üst bilgisi	Yanıt URL'si
İşlem Konumu	{document-translation-endpoint}/translator/document/9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec?api-version=2024-05-01

• Çeviri işlerinin ve işlerinin listesini almak için get-translations-statusid

İstek üst bilgileri

İstek üst bilgileri şunlardır:

Üst Bilgiler	Açıklama	Koşul
Ocp-Apim-Subscription-Key	Azure portalından Translator hizmeti API anahtarınız.	Gerekli
Ocp-Apim-Subscription-Region	Kaynağınızın oluşturulduğu bölge.	& madde işareti.
İçerik Türü	Yükün içerik türü. Kabul edilen değer application/json veya charset=UTF-8'dir.	Gerekli

Yanıt durum kodları

Bir isteğin döndürdüğü olası HTTP durum kodları aşağıdadır.

Durum Kodu	Açıklama
200	Tamam. Başarılı istek ve toplu çeviri işleminin durumunu döndürür. HeadersRetry-After: integerETag: string
Kategori 401	Yetkisiz. Kimlik bilgilerinizi denetleyin.
404	Kaynak bulunamadı.
beş yüz	İç Sunucu Hatası.
Diğer Durum Kodları	• Çok fazla istek • Sunucu geçici olarak kullanılamıyor

Çeviri durumu yanıtı alma

Başarılı çeviri durumu yanıtı alma

Başarılı bir yanıtta aşağıdaki bilgiler döndürülür.

Adı	Tür	Açıklama
id	Dize	İşlemin kimliği.
createdDateTimeUtc	Dize	İşlem oluşturma tarihi saati.
lastActionDateTimeUtc	Dize	İşlemin durumunun güncelleştirildiği tarih saati.
durum	Dize	İş veya belge için olası durumların listesi: • İptal Edildi •Iptal •Başarısız • Başlamadı •Koşarak •Başarılı • ValidationFailed
Özet	Durum Özeti	Listelenen ayrıntıları içeren özet.
summary.total	tamsayı	Toplam sayı.
summary.failed	tamsayı	Başarısız sayı.
summary.success	tamsayı	Başarılı sayısı.
summary.inProgress	tamsayı	Devam eden sayısı.
summary.notYetStarted	tamsayı	Henüz başlatılmadı sayısı.
summary.cancelled	tamsayı	İptal edilenlerin sayısı.
summary.totalCharacterCharcharerChar	tamsayı	API tarafından ücretlendirilen toplam karakter sayısı.

Hata yanıtı

Adı	Tür	Açıklama
kod	Dize	Üst düzey hata kodları içeren sabit listeleri. Kabul edilen değerler: • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Yetkisiz
ileti	Dize	Üst düzey hata iletisi alır.
hedef	Dize	Hatanın kaynağını alır. Örneğin, geçersiz bir belge için veya documents olabilirdocument id.
iç hata	InnerTranslationError	Azure AI hizmetleri API Yönergelerine uygun yeni İç Hata biçimi. Bu hata iletisi gerekli ErrorCode, ileti ve isteğe bağlı özellik hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe olabilir) özelliklerini içerir.
innerError.code	Dize	Kod hata dizesini alır.
innerError.message	Dize	Üst düzey hata iletisi alır.
innerError.target	Dize	Hatanın kaynağını alır. Örneğin, veya documents geçersiz bir belge olabilirdocument id.

Örnekler

Örnek başarılı yanıt

Aşağıdaki JSON nesnesi başarılı bir yanıt örneğidir.

{
  "id": "727bf148-f327-47a0-9481-abae6362f11e",
  "createdDateTimeUtc": "2020-03-26T00:00:00Z",
  "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
  "status": "Succeeded",
  "summary": {
    "total": 10,
    "failed": 1,
    "success": 9,
    "inProgress": 0,
    "notYetStarted": 0,
    "cancelled": 0,
    "totalCharacterCharged": 0
  }
}

Örnek hata yanıtı

Aşağıdaki JSON nesnesi bir hata yanıtı örneğidir. Diğer hata kodlarının şeması aynıdır.

Durum kodu: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "User is not authorized",
    "target": "Document",
    "innerError": {
      "code": "Unauthorized",
      "message": "Operation is not authorized"
    }
  }
}

Sonraki adımlar

Belge çevirisi ve istemci kitaplığını kullanma hakkında daha fazla bilgi edinmek için hızlı başlangıcımızı izleyin.

Belge çevirisi ile çalışmaya başlama