Tilakoodin käsittely :n kanssa Web.Contents
Funktiolla Web.Contents
on joitakin valmiita toimintoja tiettyjen HTTP-tilakoodien käsittelemiseen. Oletustoiminta voidaan ohittaa laajennuksessa käyttämällä ManualStatusHandling
asetustietueen kenttää.
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.
Huomautus
Arvon Retry-after
on oltava muodossa delta-seconds
. Muotoa HTTP-date
ei tällä hetkellä tueta.
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 |
Huomautus
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).
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 |
Huomautus
Vain tilakoodi 307 säilyttää pyyntömenetelmän POST
. Kaikki muut uudelleenohjauksen tilakoodit saavat aikaan vaihdon kohteeseen GET
.