Aracılığıyla paylaş

Belirli bir çeviri işinin durumunu alma

  • Makale

Başvuru
Özelliği: Azure AI Çeviri → Belge Çevirisi
API 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 True İş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

İstek üst bilgileri

İstek üst bilgileri şunlardır:

Üst Bilgiler Açıklama Koşul
Ocp-Apim-Subscription-Key Azure portalından Çeviri hizmet API anahtarınız. Zorunlu
Ocp-Apim-Subscription-Region Kaynağınızın oluşturulduğu bölge. • Batı ABD gibi bölgesel (coğrafi) bir kaynak kullanılırken gereklidir.
& 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ı.
500 İç 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 Veri Akışı Açıklaması
id Dize İşlemin kimliği.
createdDateTimeUtc Dize İşlem oluşturma tarihi saati.
lastActionDateTimeUtc Dize İşlemin durumunun güncelleştirildiği tarih saati.
durum String İş veya belge için olası durumların listesi:
• İptal Edildi
•Iptal
•Başarısız
• Başlamadı
•Çalışan
•Başarılı
• ValidationFailed
Özet StatusSummary Listelenen ayrıntıları içeren özet.
summary.total integer Toplam sayı.
summary.failed integer Başarısız sayı.
summary.success integer Başarılı sayısı.
summary.inProgress integer Devam eden sayısı.
summary.notYetStarted integer Henüz başlatılmadı sayısı.
summary.cancelled integer İptal edilenlerin sayısı.
summary.totalCharacterCharcharerChar integer 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. Olası değerler:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Yetki -siz
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 document id olabilirdocuments.
innerError 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 document id geçersiz bir belge olabilirdocuments.

Ö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