Jaa

Tilakoodin käsittely :n kanssa Web.Contents

  • Artikkeli

Funktiolla Web.Contents on joitakin valmiita toimintoja tiettyjen HTTP-tilakoodien käsittelemiseen. Oletustoiminta voidaan ohittaa laajennuksessa käyttämällä ManualStatusHandling asetustietueen kenttää.

Automaattinen uudelleenyritysten toiminto

Web.Contents yrittää automaattisesti uudelleen pyyntöjä, jotka epäonnistuvat jollakin seuraavista tilakoodeista:

Koodi Tila
408 Pyynnön aikakatkaisu
429 Liian monta pyyntöä
503 Palvelu ei ole käytettävissä
504 Yhdyskäytävän aikakatkaisu
509 Kaistanleveyden raja ylitetty

Pyyntöjä yritetään uudelleen enintään kolme kertaa ennen epäonnistumista. Moduuli määrittää eksponentiaalisen tausta-algoritmin avulla, kuinka kauan odotetaan seuraavaan uudelleenyrityksen ajankohtaan, ellei vastaus sisällä otsikkoa Retry-after . Kun otsikko löytyy, moduuli odottaa määritetyn sekuntien määrän ennen seuraavaa uudelleenyritysten aikaa. Pienin tuettu odotusaika on 0,5 sekuntia ja suurin arvo on 120 sekuntia.

Muistiinpano

Arvon Retry-after on oltava muodossa delta-seconds . Muotoa HTTP-date ei tällä hetkellä tueta.

Todentamisen poikkeukset

Seuraavat tilakoodit aiheuttavat tunnistetietojen poikkeuksen, mikä aiheuttaa todennuskehotteen, jossa käyttäjää pyydetään antamaan tunnistetiedot (tai kirjautumaan uudelleen sisään, jos kyseessä on vanhentunut OAuth-tunnus).

Koodi Tila
401 Valtuuttamaton
403 Kielletty

Muistiinpano

Laajennukset voivat käyttää - ManualStatusHandling asetusta tilakoodeilla 401 ja 403, mikä ei ole mahdollista kutsuissa Web.Contents , jotka tehdään mukautetun tietoliittimen ulkopuolella (eli suoraan Power Querysta).

Uudelleenohjaus

Seuraavat tilakoodit aiheuttavat automaattisen uudelleenohjauksen otsikossa määritettyyn URI:hen Location . Puuttuva Location otsikko aiheuttaa virheen.

Koodi Tila
300 Useita vaihtoehtoja
301 Siirretty pysyvästi
302 Löytyi
303 Katso muut
307 Väliaikainen uudelleenohjaus

Muistiinpano

Vain tilakoodi 307 säilyttää pyyntömenetelmän POST . Kaikki muut uudelleenohjauksen tilakoodit saavat aikaan vaihdon kohteeseen GET.