İsteklerin yinelenebilirliği

Şunlar için geçerlidir: ACS Email (Email API Gönder), ACS Odaları

POST API'leri tanım gereği bir kez etkili değildir. Bunların bir kez etkili bir şekilde davranmalarını sağlamak için , OASIS Repeatable Requests Sürüm 1.0 belirtimine göre yinelenebilir istekleri destekliyoruz. Bunu desteklemek için müşterilerin POST isteğinde iki zorunlu üst bilgi belirtmesi gerekir:

  • Repeatability-Request-Id
  • Tekrarlanabilirlik-İlk Gönderilen

Repeatability-Request-Id üst bilgisi

Bu üst bilginin değeri, isteği guid ile benzersiz olarak tanımlar.

Repeatability-First-Sent üst bilgisi

Bu üst bilginin değeri, özgün isteğin ilk gönderildiği zaman damgasını temsil eder. Değerin UTC olarak IMF-fixdate biçiminde belirtilmesi gerekir. Yalnızca belirtilen süre için istekleri izliyoruz (şu anda izlenen süre 5 dakikadır). Öncesinde ilk gönderilen değere sahip tüm istekler yeniden yürütülemez olarak kabul edilir ve 412 (Ön koşul başarısız oldu) hatası döndürür.

ACS SDK'larında tekrarlanabilirlik

AcS SDK kitaplıklarımızdan herhangi biri kullanılırken yinelenebilirlik üst bilgileri otomatik olarak oluşturulur, eklenir ve API'ye gönderilir.

Yinelenebilir istek yanıt kodları

Tekrarlanabilir istekler için çeşitli durum kodları hakkında ayrıntılı bilgiler aşağıdaki tabloda yer almaktadır.

Repeatability-Request-ID Tekrarlanabilirlik-İlk Gönderilen Yinelenebilirlik Sonucu Yanıt Durum Kodu
Geçerli GUID Geçersiz biçim Reddedildi 400
Geçersiz biçim Geçerli Tarih Reddedildi 400
Geçersiz biçim Geçersiz biçim Reddedildi 400
Geçerli Dış izleme süresi Reddedildi 412 (Önkoşul başarısız oldu)
Geçerli yeni/yanıtsız istek İzleme süresi içinde Kabul edildi Normal yürütmeden alınan durum kodu
Geçerli yinelenen istek İzleme süresi içinde, ancak önceki istekle eşleşmiyor Reddedildi 400
Geçerli yinelenen istek İzleme süresi içinde, önceki istekle eşleşir Kabul edildi Email Gönderme API'sinde:
- Özgün istek hala devam ediyorsa: 409
- Özgün isteğin durum kodu 2xx veya 4xx ise bu durum kodunu döndürebilirsiniz.
- Özgün isteğin durum kodu 5xx ise, isteğin yeniden yürütülmesinden sonra durum kodunu döndür.

Sorun giderme

son 5 dakika içinde gönderilen ilk zaman damgasına sahip bir istek gönderdiyseniz ancak yine de "İlk gönderilen üst bilgi 5 dakika içinde yinelenebilirlik gönderilmedi" iletisiyle 412 (Önkoşul başarısız oldu) hatası alıyorsanız, istemci bilgisayarınızın saatinin zaman sunucusuyla eşitlendiğinden emin olun.

Ayrıca Bkz.

Azure İletişim Hizmetleri hakkında ek bilgi için diğer belge kaynaklarımızı da gözden geçirebilirsiniz: