16.08.17 - บันทึกประจำรุ่น Apigee Edge สำหรับระบบคลาวด์สาธารณะ

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X info

เมื่อวันอังคารที่ 30 สิงหาคม 2016 เราได้เปิดตัว Apigee Edge สำหรับ Public Cloud เวอร์ชันใหม่

ฟีเจอร์และการอัปเดตใหม่ๆ

ฟีเจอร์ใหม่และการอัปเดตในรุ่นนี้มีดังนี้

เพย์โหลด JSON ใน Assign Message และ Raise Fault

การปรับปรุงนี้ช่วยให้ไม่ต้องใช้การแก้ปัญหาเฉพาะหน้าเพื่อให้มั่นใจว่าข้อความ JSON มีการจัดรูปแบบที่เหมาะสม และสามารถระบุตัวแปรโดยใช้เครื่องหมายปีกกาได้โดยไม่ต้องสร้าง JSON ที่ไม่ถูกต้อง ตัวอย่างเช่น คำสั่งต่อไปนี้จะแทรกค่าของ message.content ในข้อความ JSON

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

หากคุณใช้วิธีแก้ปัญหา โค้ดจะยังคงทำงานได้ตามเดิม นอกจากนี้ คุณยังใช้ variablePrefix และ variableSuffix แทนเครื่องหมายปีกกาเพื่อระบุตัวแปรได้ด้วย

ดูองค์ประกอบ <Set><Payload> ในเอกสารอ้างอิงนโยบาย Assign Message และ นโยบาย Raise Fault (APIRT-1160)

การปรับปรุงนโยบาย XML เป็น JSON

เราได้ปรับปรุงนโยบาย XML เป็น JSON ด้วยความสามารถต่อไปนี้ คุณสามารถกำหนดค่านโยบายให้ทำสิ่งต่อไปนี้ได้

• ถือว่าองค์ประกอบ XML บางอย่างเป็นอาร์เรย์ระหว่างการแปลง ซึ่งจะใส่ค่าในวงเล็บเหลี่ยม "[ ]" ในเอกสาร JSON
• ลบระดับของลำดับชั้นเอกสาร XML ในเอกสาร JSON สุดท้าย

ดูข้อมูลเพิ่มเติมได้ที่นโยบาย XML เป็น JSON (APIRT-1144)

ไวลด์การ์ดหลายรายการในเส้นทางทรัพยากรผลิตภัณฑ์ API

เมื่อกำหนดเส้นทางทรัพยากรใน API Product คุณสามารถใส่ไวลด์การ์ดในหลายตำแหน่งในเส้นทางทรัพยากรได้ เช่น /team/*/invoices/** อนุญาตการเรียก API ที่มีค่าใดก็ได้ หลังจาก /team และเส้นทางทรัพยากรใดก็ได้ หลังจาก invoices/ URI ที่อนุญาตในการเรียก API จะเป็น proxyBasePath/team/finance/invoices/company/a

หากหลังจากรุ่นนี้ เส้นทางทรัพยากรผลิตภัณฑ์ API ที่มีอยู่หยุดทำงานตามที่คาดไว้ ให้ตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ในองค์กรเพื่อกลับไปใช้ลักษณะการทำงานก่อนหน้าfeatures.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

ฟังก์ชัน Crypto ใน JavaScript

ชุดฟังก์ชัน JavaScript crypto ประสิทธิภาพสูงชุดใหม่พร้อมให้ใช้งานแล้ว สำหรับการสร้าง รับ และอัปเดตออบเจ็กต์แฮชต่อไปนี้ MD5, SHA-1, SHA256, SHA512 ออบเจ็กต์ crypto ยังช่วยให้คุณรับวันที่ในรูปแบบต่างๆ ได้ด้วย ดูข้อมูลเพิ่มเติมได้ที่โมเดลออบเจ็กต์ JavaScript (APIRT-2886)

การตรวจสอบเวอร์ชัน JAR ของ Java Callout

เมื่ออัปโหลดทรัพยากร Java JAR ไปยังพร็อกซี API ระบบจะแสดงรหัสสถานะ HTTP 400 (แทนที่จะเป็น 500) หากเวอร์ชันของทรัพยากร Java ไม่เข้ากันกับเวอร์ชัน Java ที่ Edge รองรับ ซึ่งระบุไว้ในซอฟต์แวร์ที่รองรับและ เวอร์ชันที่รองรับ (MGMT-3420)

การตรวจสอบความถูกต้องของทรัพยากรพร็อกซี API

เมื่อคุณมีไฟล์ทรัพยากรพร็อกซี API (เช่น JavaScript หรือ JAR ของ Java) ที่จัดเก็บไว้ในขอบเขตสภาพแวดล้อมหรือองค์กร เฟรมเวิร์กการตรวจสอบจะไม่กำหนดให้คุณต้องรวมทรัพยากรเหล่านั้นที่ระดับพร็อกซี API ในชุดพร็อกซีสำหรับการนำเข้าเพื่อผ่านการตรวจสอบอีกต่อไป ตอนนี้การตรวจสอบความถูกต้องของทรัพยากรจะเกิดขึ้นในเวลาที่ทำการติดตั้งใช้งาน ไม่ใช่เวลาที่นำเข้า (MGMT-1430)

กำหนดค่าการหมดเวลา สำหรับพร็อกซี API แต่ละรายการ

คุณกำหนดค่าพร็อกซี API ให้หมดเวลาหลังจากเวลาที่ระบุได้ (มีสถานะ 504 Gateway Timeout ) กรณีการใช้งานหลักคือสำหรับลูกค้า Private Cloud ที่มีพร็อกซี API ซึ่งใช้เวลานานกว่าในการดำเนินการ เช่น สมมติว่าคุณต้องการให้พร็อกซีบางรายการหมดเวลาที่ 3 นาที คุณสามารถ ใช้พร็อพเพอร์ตี้ api.timeout ใหม่ในการกำหนดค่าสำหรับพร็อกซี API โดยทำดังนี้ ตัวอย่าง 3 นาที

1. ก่อนอื่น ให้กำหนดค่าตัวจัดสรรภาระงาน เราเตอร์ และตัวประมวลผลข้อความให้หมดเวลา หลังจากผ่านไป 3 นาที
2. จากนั้นกำหนดค่าพร็อกซีที่เกี่ยวข้องให้หมดเวลาที่ 3 นาที ระบุค่าเป็นมิลลิวินาที เช่น

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. อย่างไรก็ตาม โปรดทราบว่าการเพิ่มระยะหมดเวลาของระบบอาจส่งผลให้เกิดปัญหาด้านประสิทธิภาพ เนื่องจาก พร็อกซีทั้งหมดที่ไม่มีการตั้งค่า api.timeout จะใช้ระยะหมดเวลาใหม่ที่สูงขึ้นของตัวจัดสรรภาระงาน เราเตอร์ และ ตัวประมวลผลข้อความ ดังนั้น ให้กำหนดค่าพร็อกซี API อื่นๆ ที่ไม่จำเป็นต้องมีระยะหมดเวลาที่นานขึ้น ให้ใช้ระยะหมดเวลาที่สั้นลง เช่น ชุดคำสั่งต่อไปนี้จะตั้งค่าพร็อกซี API ให้หมดเวลาหลังจากผ่านไป 1 นาที
   <Property name="api.timeout">60000</Property>

ลูกค้าแบบคลาวด์ที่ไม่สามารถแก้ไขระยะหมดเวลาของ Edge ยังกำหนดค่าระยะหมดเวลาของพร็อกซี API ได้ด้วย ตราบใดที่ระยะหมดเวลานั้นสั้นกว่าระยะหมดเวลาของตัวประมวลผลข้อความ Edge มาตรฐานที่ 57 วินาที

คุณไม่สามารถป้อนค่าด้วยตัวแปรได้ พร็อพเพอร์ตี้นี้ครอบคลุมอยู่ในการอ้างอิงพร็อพเพอร์ตี้ของปลายทาง (APIRT-1778)

นโยบาย TLS/SSL สำหรับการบันทึกข้อความ

<KeyStore> และ <TrustStore> สามารถตั้งค่าได้ใน การกำหนดค่า SSLInfo ในนโยบายการบันทึกข้อความ ซึ่งอนุญาตให้ใช้ TLS/SSL แบบทางเดียวและสองทางกับบริการบันทึก คุณกำหนดค่า SSLInfo ในนโยบายการบันทึกข้อความในลักษณะเดียวกับที่ทำใน TargetEndpoint ของพร็อกซี อย่างไรก็ตาม TLS/SSL การบันทึกข้อความรองรับเฉพาะโปรโตคอล TCP (APIRT-1858)

แก้ไขข้อบกพร่องแล้ว

เราได้แก้ไขข้อบกพร่องต่อไปนี้ในรุ่นนี้ โดยหลักแล้ว รายการนี้มีไว้สำหรับผู้ใช้ที่ต้องการตรวจสอบว่า คำขอรับการสนับสนุนได้รับการแก้ไขแล้วหรือไม่ แต่ไม่ได้ออกแบบมาเพื่อให้ข้อมูลโดยละเอียดแก่ผู้ใช้ทุกคน