การจัดการรหัสสถานะด้วย Web.Contents

ฟังก์ชัน Web.Contents นี้มีฟังก์ชันบางอย่างที่มีอยู่ภายในสําหรับการจัดการกับรหัสสถานะ HTTP บางตัว ลักษณะการทํางานเริ่มต้นสามารถถูกแทนที่ในส่วนขยายของคุณโดยใช้ ManualStatusHandling เขตข้อมูลใน เรกคอร์ดตัวเลือก

ลองใหม่โดยอัตโนมัติ

Web.Contents จะลองร้องขออีกครั้งโดยอัตโนมัติซึ่งล้มเหลวด้วยหนึ่งในรหัสสถานะต่อไปนี้:

รหัส	สถานะ
408	คําขอหมดเวลา
429	คําขอมากเกินไป
503	บริการไม่พร้อมใช้งาน
504	หมดเวลาเกตเวย์
509	เกินขีดจํากัดแบนด์วิดท์

คําขอจะถูกลองใหม่สามครั้งก่อนที่จะล้มเหลว กลไกจัดการใช้อัลกอริทึม back-off แบบเอ็กซ์โพเนนเชียลเพื่อกําหนดระยะเวลาที่จะรอจนกว่าจะลองใหม่ครั้งถัดไป เว้นแต่ว่าการตอบสนองมี Retry-after ส่วนหัว เมื่อพบส่วนหัว กลไกจัดการจะรอจํานวนวินาทีที่ระบุก่อนลองใหม่ครั้งถัดไป เวลารอต่ําสุดที่ได้รับการสนับสนุนคือ 0.5 วินาที และค่าสูงสุดคือ 120 วินาที

หมายเหตุ

ค่า Retry-after ต้องอยู่ใน delta-seconds รูปแบบ รูปแบบ HTTP-date ไม่ได้รับการสนับสนุนในขณะนี้

ข้อยกเว้นการรับรองความถูกต้อง

รหัสสถานะต่อไปนี้จะทําให้เกิดข้อยกเว้นข้อมูลประจําตัว ทําให้เกิดพร้อมท์การรับรองความถูกต้องที่ขอให้ผู้ใช้ใส่ข้อมูลประจําตัว (หรือลงชื่อเข้าใช้อีกครั้งในกรณีของโทเค็น OAuth ที่หมดอายุแล้ว)

รหัส	สถานะ
401	ไม่ได้รับอนุญาต
403	ไม่อนุญาต

หมายเหตุ

ส่วนขยายสามารถใช้ ManualStatusHandling ตัวเลือกที่มีรหัสสถานะ 401 และ 403 ซึ่งไม่ใช่สิ่งที่สามารถทําได้ในการ Web.Contents เรียกใช้ภายนอกตัวเชื่อมต่อข้อมูลแบบกําหนดเอง (นั่นคือโดยตรงจาก Power Query)

การเปลี่ยนเส้นทาง

รหัสสถานะต่อไปนี้จะส่งผลให้เกิดการเปลี่ยนเส้นทางอัตโนมัติไปยัง URI ที่ระบุใน Location ส่วนหัว ส่วนหัวที่หายไป Location จะส่งผลให้เกิดข้อผิดพลาด

รหัส	สถานะ
300	หลายตัวเลือก
301	ย้ายอย่างถาวร
302	พบ
303	ดูรายการอื่น ๆ
307	การเปลี่ยนเส้นทางชั่วคราว

หมายเหตุ

เฉพาะรหัสสถานะ 307 เท่านั้นที่จะเก็บ POST วิธีการร้องขอ รหัสสถานะการเปลี่ยนเส้นทางอื่น ๆ ทั้งหมดจะส่งผลให้เกิดการสลับเป็นGET