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

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

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

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

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

เพย์โหลด JSON ในการมอบหมาย ส่งข้อความและยกระดับข้อผิดพลาด

เมื่อตั้งค่าเพย์โหลด JSON โดยใช้นโยบาย Assign Message หรือ Raise Fault บางครั้งผู้ใช้ จำเป็นต้องใช้วิธีแก้ปัญหาชั่วคราวเพื่อให้แน่ใจว่าข้อความ JSON ได้รับการจัดรูปแบบอย่างถูกต้องขณะรันไทม์ เช่น การขึ้นต้นเพย์โหลดด้วยแบ็กสแลช "\" หรือระบุตัวแปรPrefix และVariableSuffix องค์ประกอบเพย์โหลด แม้ว่าจะไม่ได้ใช้ตัวแปรในข้อความก็ตาม

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

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

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

ดูส่วน<Set><Payload> ในนโยบายมอบหมายข้อความ และ นโยบาย Raise Fault เอกสารอ้างอิง (APIRT-1160)

การเพิ่มประสิทธิภาพนโยบาย XML เป็น JSON

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

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

สำหรับข้อมูลเพิ่มเติม โปรดดู XML กับนโยบาย JSON (APIRT-1144)

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

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

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

(MGMT-3273)

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

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

เวอร์ชัน JAR ข้อความไฮไลต์ของ Java กำลังตรวจสอบ

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

การตรวจสอบทรัพยากรพร็อกซี API

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

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

คุณสามารถกำหนดค่าพร็อกซี API ให้หมดเวลาหลังจากเวลาที่ระบุ (ด้วยระยะหมดเวลาของเกตเวย์ 504 สถานะ) กรณีการใช้งานหลักมีไว้สำหรับลูกค้า 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>

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

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

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

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

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

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

รหัสปัญหา คำอธิบาย
SECENG-609 การเรียกใช้รันไทม์ไม่ล้มเหลวระหว่างการลบ Truststore ที่เชื่อมโยงหรือ เมื่อมีการลบใบรับรองที่ถูกต้องใน Truststore
MGMT-3404 การดู/เรียกบันทึก Node.js และการทำให้พร็อกซีใช้งานได้นั้น ช้า
MGMT-3400 การเรียกไปยัง /userroles management API ล้มเหลวหากผู้ใช้ที่เรียกมี "+" ลงชื่อเข้าใช้ด้วยชื่อ
MGMT-3368 java.lang.ArrayIndexOutOfBoundsException: 1 เมื่อนำเข้าแพ็กเกจพร็อกซี API ที่มีไดเรกทอรีทรัพยากร/โหนด/ทรัพยากร
MGMT-3364 OAuthV2: ตรวจสอบ redirect_uri
MGMT-3319 แสดงรายการในห้องนิรภัยที่มีค่าว่างในรายการหนึ่งไม่ทำงาน สำหรับองค์กร (CPS และไม่ใช่ CPS)
MGMT-3226 การค้นหาที่ระดับองค์กร/สภาพแวดล้อมไม่ควรดึงข้อมูลทั้งหมดที่ทำให้เกิด API ไม่ผ่าน
Release_160302 มีข้อบกพร่องที่ทำให้แสดงรายการทรัพยากรในระดับองค์กร/สภาพแวดล้อม ล้มเหลวหากขนาดสะสมของทรัพยากรมากกว่า 16 MB การแก้ไขนี้ช่วยแก้ไขปัญหา ได้
AXAPP-2429 Analytics API ที่ใช้ response_status_code จะส่งคืนการเข้าถึงข้อมูล "แย่จัง!"
AXAPP-2386 แก้ไขเนื้อหาของรายงานที่ว่างเปล่าในรายงานทางอีเมลรายวันของ Analytics
AXAPP-2347 ไม่ได้รับอีเมลสรุปรายวันเกี่ยวกับข้อมูลวิเคราะห์
APIRT-3141 การเรียก Java ล้มเหลวเมื่อเรียก ExecutionResult() ใหม่ เนื่องจากตัวสร้าง ได้ถูกทำให้เป็นแบบส่วนตัว
APIRT-3140 นโยบาย Serviceข้อความไฮไลต์ไม่ทำงานในการเรียก HEAD api
APIRT-3131 createdBy แสดงสำหรับพร็อกซี API ไม่ถูกต้องเมื่อใช้การสร้างรายได้ด้วย ผู้ให้บริการตรวจสอบสิทธิ์ภายนอก
APIRT-3121 การเปลี่ยนแปลงไฟล์ทรัพยากรขององค์กรไม่มีประสิทธิภาพ 100%
APIRT-3117 MP มีการใช้งาน CPU ถึง 100% และหยุดแสดงการรับส่งข้อมูล
APIRT-3016 เราเตอร์ "หมดเวลาการโทร" ข้อผิดพลาดเกี่ยวกับการทำให้ใช้งานได้
APIRT-2975 อัปโหลดแพ็กเกจใบรับรองไม่สำเร็จ
APIRT-2955 ไม่สามารถมาสก์แอตทริบิวต์บางอย่างของข้อมูลการตอบกลับ JSON สำหรับ FHIR-complaint ส่วนหัว Content-Type "application/json+fhir"
APIRT-2946 OAuthV2-RefreshToken Policy ไม่ซ่อนแอตทริบิวต์แม้ว่าจะตั้งค่าการแสดงผลเป็น เท็จ
APIRT-2908 ต้องบังคับใช้ TLS1.2 สำหรับการเรียก API ภายในหลังการอัปเดต TLS1.2 โฮสต์เสมือน
APIRT-2901 ระบบจะบีบอัดการตอบกลับโดยใช้ GIF ที่ส่งกลับจากแคช 2 ครั้ง
APIRT-2873 MP มีการส่ง NullPointerException ที่เกี่ยวข้องกับ VerifyAPIKey หลังจากการลบ products/developers/proxies
APIRT-2871 นโยบาย IOIntensive ปรากฏใน Trace 2 ครั้ง
APIRT-2825 ข้อผิดพลาดทางไวยากรณ์ในการตอบกลับข้อผิดพลาดของโทเค็นเข้าถึง
APIRT-2750 การรับส่งข้อมูลล้มเหลวระดับสูงในองค์กรที่เฉพาะเจาะจง
APIRT-2685 การรับส่งข้อมูลไม่สามารถไหลได้เนื่องจากเกิดข้อผิดพลาดที่ไม่รู้จัก
APIRT-2647 "สตรีมอินพุตเบื้องหลังแสดงผลเป็น 0 ไบต์" เกิดข้อผิดพลาดกับ nonprod/dev
APIRT-2630 ปัญหาที่เกิดเป็นระยะๆ เมื่อพยายามอ่านค่าจากแคช
APIRT-2620 แยก Thread Pool สำหรับขั้นตอนการบล็อกบางขั้นตอน
APIRT-2610 java.lang.ClassCastException ที่มีนโยบายแคชการตอบกลับ
APIRT-2608 ข้อผิดพลาดในการแยกวิเคราะห์ส่วนหัวที่แก้ไขล่าสุดในนโยบายแคชการตอบกลับ
APIRT-2605 "องค์กร" และ "สภาพแวดล้อม" ไม่ควรอนุญาตให้เขียนทับตัวแปร ผ่านนโยบาย
APIRT-2566 นโยบาย OAuthV2 แสดงผลส่วนหัว WWW-Authenticate ที่มีรูปแบบไม่ถูกต้อง
APIRT-2491 การอัปเดต TargetServer ล้มเหลวเนื่องจาก RPC หมดเวลาระหว่างการจัดการกับ ม./วิ
APIRT-2386 ระบบจะสร้างขอบเขตสตริงที่ว่างเปล่าในผลิตภัณฑ์ API ที่มี OAuth ที่อนุญาตซึ่งว่างเปล่า ขอบเขต
APIRT-2383 ดูเหมือนว่านโยบายการเปลี่ยนรูปแบบ XSL ไม่ได้บันทึกข้อมูลใดๆ กับ "แย่จัง!"
APIRT-2364 ตัวแปรโฟลว์ข้อผิดพลาดของ OAuth ไม่ได้รับการอัปเดตเมื่อมีข้อผิดพลาด
APIRT-2216 เซิร์ฟเวอร์ส่งเหตุการณ์ - สตรีมเหตุการณ์มีปัญหาใน Prod
APIRT-2079 การเรียกใช้ cURL ของ DEBUG ไม่หยุดหลังจากหมดเวลาของการเรียกใช้ เซสชัน
APIRT-1495 XML Threat Protection ตรวจจับประเภทเนื้อหาไม่ได้
APIRT-347 นโยบาย XSL ไม่ได้รับการตรวจสอบอย่างถูกต้องเมื่อนำเข้า (ไม่ได้กำหนดผลลัพธ์ เพื่อเอาต์พุตตัวแปรตามที่บันทึกไว้)