Çeviriyi iptal et

  • Makale

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

  • Bu yöntem, sorgu parametresi tarafından id istekte belirtildiği gibi şu anda işlenen veya kuyruğa alınmış (beklemede) bir çeviri işini iptal eder.
  • İşlem zaten tamamlandıysa, başarısız olduysa veya yine de iptal edildiyse iptal edilmez. Bu örneklerde hatalı bir istek döndürülür.
  • Tamamlanan çeviriler iptal edilemez ve ücretlendirilir.

İ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  DELETE "{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
Ocp-Apim-Subscription-Key Gerekli istek üst bilgisi

Yanıt durum kodları

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

Durum Kodu Açıklama
200 Tamam. gönderilen isteği iptal et
Kategori 401 Yetkisiz. Kimlik bilgilerinizi denetleyin.
404 Bulunamadı. Kaynak bulunamadı.
500 İç Sunucu Hatası.
Diğer Durum Kodları • Çok fazla istek
• Sunucu geçici olarak kullanılamıyor

Çeviri yanıtlarını iptal etme

Başarılı yanıt

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ı
•Koşarak
•Başarılı
• ValidationFailed
Özet StatusSummary Ayrıntıların listesini içeren özet.
summary.total integer Toplam belge sayısı.
summary.failed integer Başarısız olan belge sayısı.
summary.success integer Başarıyla çevrilen belgelerin sayısı.
summary.inProgress integer Devam eden belge sayısı.
summary.notYetStarted integer Henüz işlenmeyen belgelerin 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
•Yetkisiz
ileti Dize Üst düzey hata iletisi alır.
hedef Dize Hatanın kaynağını alır. Örneğin, "belgeler" veya document id geçersiz bir belge olabilir.
innerError InnerTranslationError Azure AI hizmetleri API Yönergelerine uygun yeni İç Hata biçimi. Bu hata iletisi gerekli ErrorCode, ileti ve isteğe bağlı özellikler hedefi, ayrıntılar (anahtar değer çifti), iç hata (iç içe yerleştirilmiş 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, documents document id veya geçersiz bir belge varsa olabilir.

Örnekler

Örnek başarılı yanıt

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

Durum kodu: 200

{
  "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: 500

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

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