Power Automate Hata Kodu Sözlüğü: En Önemli HTTP ve Bağlayıcı Hataları

Bir akış kırmızıya döner, çalıştırma geçmişinde 403 gibi bir hata kodu veya ActionFailed gibi dahili bir ad görünür ve hata mesajının kendisi aslında pek yardımcı olmaz. İşte tam bu noktada arama başlar: Bu bağlantıyla mı, giriş verileriyle mi yoksa hedef hizmetle mi ilgili bir sorun? Bir referans olmadan her arıza değerli zaman kaybettirir, çünkü önce kodun ne anlama geldiğini bulman gerekir.

Bu sözlük, en önemli HTTP durum kodlarını ve Power Automate'e özgü tipik hata adlarını, resmi bulut akışları için hata kodu referansında Microsoft tarafından belgelendiği şekilde bir araya getirir. Her hata için kısaca ne anlama geldiği, en sık rastlanan nedenleri ve önce nereye bakman gerektiği açıklanır. Çalıştırma geçmişinde şu anda karşına çıkan kodu aramanız yeterli.

HTTP durum kodlarına genel bakış

Power Automate'teki birçok bağlayıcı hatası aslında çağrılan API'nin döndürdüğü klasik HTTP durum kodlarıdır. Microsoft, bunların en yaygınlarını bağlayıcı bütünlüğü belgelerinde listeler:

• 400 Bad Request: Sunucu, giriş verileri hatalı olduğu için isteği işleyemiyor veya işlemek istemiyor.
• 401 Unauthorized: Kimlik doğrulama başarısız oldu, geçerli oturum açma bilgileri eksik.
• 403 Forbidden: API'nin istek sınırı aşıldı veya izin eksik.
• 404 Not Found: Çağrılan işlem artık mevcut değil veya kullanımdan kaldırılmış olarak işaretlenmiş.
• 409 Conflict: İstek, hedef kaynağın mevcut durumuyla çakışıyor; genellikle bir düzeltmenin ardından isteği yeniden göndererek çözülebilir.
• 415 Unsupported Media Type: İsteğin içerik türü sunucu tarafından desteklenmiyor.
• 429 Too Many Requests: API'nin istek sınırına ulaşıldı.
• 500 Internal Server Error: Sunucu tarafında beklenmeyen bir hata.
• 502 Bad Gateway: Barındırma web sunucusunda bir sorun, genellikle kapanmış bir bağlantı.
• 504 Gateway Timeout: Sunucu zamanında yanıt vermiyor.
• 522, 523, 524: Genellikle erişilemeyen veya aşırı yüklenmiş bir hedef hizmetten kaynaklanan bağlantı veya zaman aşımı hataları.

Bilmekte fayda var: 400'lü hatalar neredeyse her zaman isteğin kendisinden kaynaklanır, 500'lü hatalar ise çağrılan hizmet tarafında bir sorun olduğuna işaret eder ve genellikle yalnızca beklemek veya yeniden denemekle çözülür.

Bağlantı ve kimlik doğrulama hataları

Bu hata grubu, akış artık bağlı bir hizmette oturum açamadığında ortaya çıkar.

• InvalidConnection: Bağlantı referansı, silinmiş, süresi dolmuş veya kesilmiş bir bağlantıyı işaret ediyor. Akışı aç, etkilenen eylemi seç ve bağlantıyı yeniden oluştur.
• ConnectionNotConfigured: Bir eylem bağlantı gerektiriyor ama hiçbiri seçilmemiş, genellikle bir çözümden içe aktarma yapıldıktan sonra. Eylemde uygun bağlantıyı seç.
• ConnectionAuthorizationFailed: Bağlantı mevcut, ancak kayıtlı kimlik bilgileri artık geçerli değil; örneğin bir parola değiştirilmiş ya da bir OAuth belirtecinin süresi 90 gün hareketsizlikten sonra dolmuş olabilir. Bağlantılar bölümüne git, etkilenen bağlantıyı seç ve Bağlantıyı düzelt seçeneğini kullan.
• Unauthorized (401): Kimlik doğrulama belirteci geçersiz veya süresi dolmuş. Ayrıca koşullu erişim nedeniyle engellenip engellenmediğini görmek için Microsoft Entra ID'deki oturum açma günlüklerini kontrol et.
• Forbidden (403): Kullanıcının veya uygulamanın bu işlemi gerçekleştirme izni yok. En yaygın neden, ortamdaki bağlayıcıyı engelleyen bir DLP ilkesi veya hedef kaynakta eksik izinlerdir.

Microsoft belgelerine göre, üretim akışları için bir hizmet sorumlusu (service principal) bağlantısına geçmek avantajlıdır, çünkü bu bağlantı bir çalışan parolasını değiştirdiğinde veya şirketten ayrıldığında sona ermez.

Bağlayıcı ve API hataları

Bu hatalar, Power Automate'ten değil, doğrudan çağrılan hizmetin kendisinden kaynaklanır.

• ActionFailed: Bir eylemin başarısız olduğu anlamına gelen genel bir hata mesajı. Asıl neden eylemin çıktı metninde yer alır; bunun için başarısız çalıştırmayı aç ve Çıktılar bölümünü genişlet.
• BadRequest (400): Giriş verileri hatalı biçimlendirilmiş, örneğin bir sayı beklenen yerde bir metin dizisi var ya da istek gövdesinde zorunlu bir alan eksik.
• NotFound (404): Başvurulan kaynak, örneğin bir SharePoint listesi veya bir posta kutusu klasörü yeniden adlandırılmış, taşınmış veya silinmiş.

Her üç hatada da aynı ilk adım yardımcı olur: çalıştırma geçmişinde başarısız çalıştırmayı aç ve girişleri gerçekte beklenen biçimle karşılaştır.

Tasarım zamanı ve ifade hataları

Bu hatalar ya kaydetme sırasında ya da bir ifade değerlendirildiğinde yalnızca çalışma zamanında ortaya çıkar.

• InvalidTemplate: Bir ifadedeki sözdizimi hatası, çoğunlukla uyuşmayan parantezler veya yanlış bir eylem adı.
• FlowCheckerError: Akış denetleyicisi bir doğrulama sorunu buldu, genellikle boş bir zorunlu alan veya eksik bir bağlantı.
• DuplicateActionName: Aynı akıştaki iki eylem dahili olarak aynı ada sahip, genellikle yeniden adlandırma yapılmadan kopyala-yapıştır sonrasında.
• MissingRequiredProperty: Bir eylemde veya tetikleyicide zorunlu bir alan boş bırakılmış.
• ExpressionEvaluationFailed: Gerçek veriler ifadeyle eşleşmediği için bir ifade çalışma zamanında değerlendirilemiyor, örneğin boş bir nesnenin alanına erişim. Bir `coalesce()` koruması genellikle bu sorunu çözer.
• ContentConversionFailed: Akış, verileri bir türden diğerine dönüştüremedi, örneğin beklenmeyen bir biçimdeki bir tarih.

Zaman aşımı ve kısıtlama hataları

Bu grup, bir akış zaman veya hacim sınırlarını aştığında ortaya çıkar.

• ActionTimedOut: Tek bir eylem yapılandırılmış zaman sınırını aştı; bir HTTP eyleminin varsayılan zaman aşımı 100 saniyedir.
• OperationTimedOut: Bir onay veya bir web kancası (webhook) gibi uzun süren bir işlem, maksimum bekleme süresini aştı. Belgelere göre bulut akışları en fazla 30 gün çalışır.
• WorkflowRunActionRepetitionQuotaExceeded: "Her birine uygula" gibi bir döngü, maksimum yineleme sayısını aştı; genellikle önceden filtreleme yapılmadan iç içe geçmiş döngüler yüzünden.
• FlowRunQuotaExceeded: Lisans düzeyine bağlı olarak, kullanıcı veya akış için günlük eylem yürütme sınırına ulaşıldı.
• DirectApiAuthorizationRequired: Akış premium bir bağlayıcı kullanıyor, ancak tetikleyen kullanıcının uygun bir lisansı yok.

Sistematik olarak nasıl ilerlersin

Her hatayı tek tek Google'da aramak yerine, Microsoft'un da bulut akışı hatalarını giderme kılavuzunda anlattığı sabit bir sıra izlemek yardımcı olur:

• Çalıştırma geçmişinde başarısız çalıştırmayı aç ve kırmızıyla işaretlenmiş eylemi belirle.
• Eylemin Girişler ve Çıktılar bölümlerini genişleterek tam durum kodunu ve hata mesajını gör.
• Kodu bu sözlükteki uygun kategoriyle eşleştir: bağlantı, istek, ifade veya zaman aşımı.
• Hata metnini bu genel bakışta bulamıyorsan, onu birebir kopyala ve Power Automate Topluluk Forumları'nda ara; orada neredeyse tüm özel durumlar zaten bir kez tartışılmıştır.

Bir akış şirketinizde düzenli olarak aynı hata kodlarında takılıp kalıyorsa veya bu referansa rağmen nedenini belirleyemiyorsanız, Power Automate danışmanlığımız kapsamında bunu birlikte seve seve inceleriz. Dijital çalışanlar olarak bağlantıları, hata işlemeyi ve yeniden deneme mantığını bir kez düzgünce kurar ve bundan sonra akışlarınız üzerindeki kontrolü elinizde tutmanız için bunları belgeleriz.

Sık sorulan sorular

Bir HTTP durum kodu ile ActionFailed gibi bir hata arasındaki fark nedir?

401 veya 404 gibi HTTP durum kodları doğrudan çağrılan hizmetten gelir ve belirli isteğin neden başarısız olduğunu açıklar. ActionFailed gibi hatalar ise Power Automate'in genel bir sarmalayıcısıdır ve bunun arkasında neredeyse her zaman bu HTTP kodlarından biri gizlidir. Arkasındaki gerçek durum kodunu bulmak için başarısız eylemin çıktılarını aç.

Kimlik bilgilerim doğru olduğu halde neden 403 hatası alıyorum?

403 hatası mutlaka yanlış kimlik bilgileri anlamına gelmez, daha çok belirli işlem için eksik izin anlamına gelir. En yaygın nedenler; ortamınızdaki bağlayıcıyı engelleyen bir veri kaybını önleme (DLP) ilkesi, hedef kaynağa eksik yazma erişimi veya aşılmış bir API istek sınırıdır. Önce hedef kaynaktaki izinleri, ardından ortamınızdaki DLP ilkelerini kontrol edin.

Hangi eylemin bir hataya neden olduğunu nasıl öğrenirim?

Etkilenen akışı aç, son çalıştırmalar listesinden başarısız çalıştırmayı seç ve kırmızı uyarı simgesini ara. Etkilenen eylem genişletilebilir; burada Girişler ve Çıktılar bölümleri tam durum kodunu ve çağrılan hizmetin orijinal hata mesajını gösterir.

Her hatayı hemen kendin düzeltmeye değer mi?

429 veya 502 gibi tek seferlik HTTP hataları için genellikle yeniden denemek yeterlidir, çünkü neden dış hizmet tarafındadır ve geçicidir. Ancak aynı hata tekrar tekrar oluşuyorsa, her seferinde manuel olarak yeniden başlatmak yerine akışta yeniden deneme ilkeleri ve tanımlı bir yedek (fallback) eylemi gibi yapılandırılmış bir hata işleme kurmaya değer.

Bu hata kodları masaüstü akışları için de geçerli mi?

Burada açıklanan kodlar bulut akışlarıyla ilgilidir. Bilgisayarında çalışan masaüstü akışları için Microsoft, kullanıcı arayüzü öğeleri veya yerel uygulamalar gibi farklı hata kaynaklarının rol oynadığı Masaüstü Akışı Hatalarını Ele Alma başlıklı ayrı bir referans sunar.