Belirli bir belgenin durumunu alma
Başvuru
Özelliği: Azure AI Çeviri → Belge Çevirisi
API Sürümü: 2024-05-01
HTTP yöntemi: GET
Bu yöntem, ve documentId
sorgu parametreleri tarafından istekte belirtildiği gibi bir işteki belirli bir belgenin id
durumunu döndürür.
İ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}/documents/{documentId}?api-version={date}"
İstek parametreleri
Sorgu dizesinde geçirilen istek parametreleri şunlardır:
Sorgu parametresi | Zorunlu | Açıklama |
---|---|---|
documentId |
True | Belge kimliği. |
id |
True | Toplu iş kimliği. |
ve documentId
değerlerini bulma id
- İşi
id
POSTstart-batch-translation
yöntemi yanıt Üst BilgiOperation-Location
URL'si değerinde bulabilirsiniz. URL'nin son parametresi işlemin işidirid
:
Yanıt üst bilgisi | Sonuç URL'si |
---|---|
Operation-Location |
{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}/ 9dce0aa9-78dc-41ba-8cae-2e2f3c2ff8ec / |
Sorgu dizesinin iş
id
parametrelerini almak için GET çevirileri durum isteği de kullanabilirsiniz.parametresini
documentId
get-documents-status yöntemi yanıtında bulabilirsiniz.
İ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. Hizmet tarafından kabul edilen başarılı istek. İşlem ayrıntıları döndürülür. HeadersRetry-After: integerETag: string |
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 |
Belge durumu yanıtı alma
Başarılı belge durumu yanıtı alma
Adı | Tür | Açıklama |
---|---|---|
yol | Dize | Belgenin veya klasörün konumu. |
Sourcepath | Dize | Kaynak belgenin konumu. |
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 |
kullanıcısı | Dize | To Language için iki harfli dil kodu. Dil listesine bakın. |
ilerleme | Numara | Varsa çevirinin ilerleme durumu |
id |
Dize | Belge Kimliği. |
characterCharged | integer | API tarafından ücretlendirilen karakterler. |
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. |
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, geçersiz bir belge için veya document id olabilirdocuments . |
Örnekler
Örnek başarılı yanıt
Aşağıdaki JSON nesnesi başarılı bir yanıt örneğidir.
{
"path": "https://myblob.blob.core.windows.net/destinationContainer/fr/mydoc.txt",
"sourcePath": "https://myblob.blob.core.windows.net/sourceContainer/fr/mydoc.txt",
"createdDateTimeUtc": "2020-03-26T00:00:00Z",
"lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
"status": "Running",
"to": "fr",
"progress": 0.1,
"id": "273622bd-835c-4946-9798-fd8f19f6bbf2",
"characterCharged": 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.