Çeviriyi iptal et

Makale
02/23/2024

Başvuru
Hizmeti: Azure AI Belge Çevirisi
API Sürümü: v1.1

Geçerli bir işlemeyi veya kuyruğa alınmış işlemi iptal etme. İşlem tamamlanırsa, başarısız olursa veya iptal edilirse iptal edilmez. Hatalı bir istek döndürülür. Tamamlanan çeviriler iptal edilmez ve ücretlendirilir. Bekleyen tüm çeviriler mümkünse iptal edilir.

İstek URL’si

Şuraya bir DELETE isteği gönderin:

https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/batches/{id}

Özel etki alanı adınızı bulmayı öğrenin.

Önemli

Belge Çevirisi hizmetine yönelik tüm API istekleri için özel bir etki alanı uç noktası gerekir.
Belge Çevirisi'ne HTTP isteklerinde bulunmak için Azure portalı kaynak Anahtarlar ve Uç Nokta sayfanızda bulunan uç noktayı veya genel çeviri uç noktasınıapi.cognitive.microsofttranslator.com kullanamazsınız.

İstek parametreleri

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

Sorgu parametresi	Zorunlu	Açıklama
`id`	True	İşlem kimliği.

İ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ı •Çalışan •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 •Yetki -siz
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, `documentsdocument 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

Share via