15.05.27 - บันทึกประจำรุ่นในระบบคลาวด์ของ Apigee Edge

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

เมื่อวันอังคารที่ 2 มิถุนายน 2015 เราได้เปิดตัว Apigee Edge เวอร์ชันใหม่ในระบบคลาวด์

หากมีคำถาม โปรดไปที่ทีมสนับสนุนลูกค้าของ Apigee

ดูรายการบันทึกประจำรุ่นทั้งหมดของ Apigee Edge ได้ที่บันทึกประจำรุ่นของ Apigee

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

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

ความพร้อมให้บริการของ SmartDocs สำหรับผู้ใช้ทั่วไป

SmartDocs กำลังจะออกจากเวอร์ชันเบต้าและพร้อมให้บริการแก่ผู้ใช้ทั่วไป การอัปเดตและฟีเจอร์ใหม่ๆ ประกอบด้วย

  • รองรับ Swagger 2.0 ซึ่งรวมถึงการนําเข้าด้วยไฟล์หรือ URL รวมถึงรองรับออบเจ็กต์ความปลอดภัยที่มีชื่อที่กำหนดเอง
  • การปรับปรุงการออกแบบภาพในเทมเพลตที่สร้าง SmartDocs
  • ความสามารถในการใช้งานและการเพิ่มประสิทธิภาพเวิร์กโฟลว์ในพอร์ทัลนักพัฒนาซอฟต์แวร์ ซึ่งเข้าถึงได้ผ่านเมนูเนื้อหา > SmartDocs ใน Drupal
  • การตรวจสอบสิทธิ์ที่เรียกว่า "โทเค็นที่กำหนดเอง" เปลี่ยนชื่อเป็น "คีย์ API" แล้ว
  • ออบเจ็กต์ "ความปลอดภัย" ของการตรวจสอบสิทธิ์ที่กําหนดไว้ที่ระดับการแก้ไข
  • การกําหนดค่าการตรวจสอบสิทธิ์ไคลเอ็นต์ที่ระดับเทมเพลต การแก้ไขใหม่จะไม่รีเซ็ตข้อมูลเข้าสู่ระบบไคลเอ็นต์ SmartDocs ที่กําหนดค่าไว้ล่วงหน้าอีกต่อไป

ดูคำอธิบายฟีเจอร์เพิ่มเติมได้ใน บล็อกโพสต์นี้

ดูเอกสารประกอบของ SmartDocs ได้ที่การใช้ SmartDocs เพื่อเขียนเอกสารประกอบ API

เครื่องมือแก้ไขพร็อกซี API เวอร์ชันเบต้าใหม่

เครื่องมือแก้ไขพร็อกซี API เวอร์ชันเบต้าใหม่พร้อมใช้งานแล้ว หากต้องการเข้าถึง ให้คลิกลิงก์ "เข้าถึงเวอร์ชันเบต้า" เมื่อแก้ไขพร็อกซี API ที่มีอยู่ คุณสลับระหว่างเครื่องมือแก้ไข "คลาสสิก" กับ "เบต้า" ได้

นโยบาย OAuthV2 ใหม่

นโยบาย DeleteOAuthV2Info ใหม่ช่วยให้คุณลบรหัสการให้สิทธิ์และโทเค็นการเข้าถึงได้ ดูข้อมูลเพิ่มเติมได้ที่นโยบายการลบข้อมูล OAuthV2

เอนทิตีใหม่ในนโยบายการเข้าถึงเอนทิตี

นโยบายเอนทิตีการเข้าถึงจะให้สิทธิ์เข้าถึงเอนทิตีใหม่ต่อไปนี้ consumerkey-scopes, authorizationcode, requesttoken และ verifier ดูข้อมูลเพิ่มเติมได้ที่นโยบาย Access Entity

แสดงใบรับรอง SSL ที่ใกล้หมดอายุ

หน้าใบรับรอง SSL ใน UI การจัดการ (ผู้ดูแลระบบ > ใบรับรอง SSL) จะระบุเวลาที่ใบรับรอง SSL จะหมดอายุภายใน 10, 15, 30 หรือ 90 วัน ทั้งนี้ขึ้นอยู่กับการเลือกของคุณในช่องเมนูแบบเลื่อนลงวันหมดอายุใหม่

ชื่อแอปของนักพัฒนาแอปที่แสดงใน UI การจัดการ

แอปของนักพัฒนาแอปใน Edge มีทั้งชื่อภายในที่ไม่เปลี่ยนแปลงและชื่อที่แสดงซึ่งคุณเปลี่ยนแปลงได้ ในหน้าแอปของนักพัฒนาแอปใน UI การจัดการ (เผยแพร่ > แอปของนักพัฒนาแอป > ชื่อแอป) "ชื่อ" ภายในแอปจะแสดงพร้อมกับ "ชื่อที่แสดง" ซึ่งช่วยให้คุณระบุแอปด้วยชื่อภายในได้ง่ายๆ เพื่อแก้ปัญหาและจัดการ API

นํารายงานที่กําหนดเองเวอร์ชันคลาสสิกออกจาก UI การจัดการ

รายงานข้อมูลวิเคราะห์ที่กําหนดเองเวอร์ชันคลาสสิกซึ่งไม่บังคับจะใช้งานใน UI การจัดการไม่ได้อีกต่อไป


กระบวนการอัปเกรด SmartDocs

หากคุณใช้ SmartDocs อยู่แล้วในช่วงเบต้า คุณจะต้องอัปเกรด SmartDocs ในพอร์ทัลนักพัฒนาซอฟต์แวร์เพื่อใช้ฟีเจอร์และความสามารถใหม่ๆ ในเวอร์ชันที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป

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

โปรดทราบว่าแม้ว่าคุณจะแสดงผลและเผยแพร่ SmartDocs ภายในพอร์ทัลนักพัฒนาแอปได้ แต่ SmartDocs จะสร้างขึ้นจากโมเดล API ที่อยู่ในบริการการจัดการ Edge API ของ Apigee การเปลี่ยนแปลงใดๆ ที่คุณทำกับโมเดล API ใน Edge จะเหมือนกันในทุกสภาพแวดล้อมของ Pantheon (คล้ายกับวิธีที่นักพัฒนาซอฟต์แวร์ทำงานในสภาพแวดล้อมต่างๆ ของ Pantheon)

วิธีอัปเกรดจาก SmartDocs รุ่นเบต้าเป็นเวอร์ชันที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป

  1. อัปเดตและทดสอบรุ่น 15.05.27 ในสภาพแวดล้อม dev หรือ test ใน Pantheon
  2. สร้างโมเดลใหม่เพื่อแทนที่โมเดล API ที่มีอยู่ซึ่งคุณใช้อยู่
    • หากคุณนําเข้าเอกสาร Swagger หรือ WADL ให้นําเข้าอีกครั้งในฉบับใหม่
    • หากคุณดูแลรักษาโมเดล API ผ่านโมดูล SmartDocs ให้ส่งออกเป็น SmartDocs JSON และนําเข้าไปยังโมเดลใหม่โดยใช้ไฟล์แนบ
  3. ตั้งค่าพร็อพเพอร์ตี้ความปลอดภัยของเวอร์ชันแก้ไขของโมเดล ในหน้าเนื้อหา > SmartDocs > โมเดล ให้เลือกการตั้งค่าความปลอดภัย
  4. ตรวจสอบการตรวจสอบสิทธิ์ที่กำหนดค่าไว้ล่วงหน้าในหน้าการตั้งค่ารูปแบบ (เนื้อหา > SmartDocs) โดยคลิกการตั้งค่าในคอลัมน์การดำเนินการ
  5. อัปเดตเทมเพลตที่กําหนดเองให้ใช้ชิ้นงาน CSS และ JS เวอร์ชัน 6 และทําการเปลี่ยนแปลงให้สอดคล้องกับชื่อออบเจ็กต์ใหม่ เช่น authSchemes และ apiSchema ดูข้อมูลเกี่ยวกับการอัปเดตเทมเพลต SmartDocs ได้ที่การใช้ SmartDocs เพื่อเขียนเอกสารประกอบ API
  6. แสดงผลและเผยแพร่การแก้ไขโมเดลอีกครั้ง
  7. หลังจากตรวจสอบเอกสารประกอบใหม่แล้ว ให้อัปเดตพอร์ทัลเวอร์ชันที่ใช้งานจริงเป็นรุ่น 15.05.27

หากคุณเป็นลูกค้า Edge Enterprise และมีคำถามหรือข้อกังวลเกี่ยวกับกระบวนการอัปเกรด โปรดส่งอีเมลไปที่ marsh@apigee.com และ cnovak@apigee.com หรือใช้ชุมชน Apigee เพื่อรับคำตอบที่ดีที่สุด

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

ข้อบกพร่องต่อไปนี้ได้รับการแก้ไขในรุ่นนี้

รหัสปัญหา คำอธิบาย
TBD-72 ปัญหาเกี่ยวกับนโยบายการบันทึกข้อความ
MGMT-2124 ระบบจะรีเซ็ตสิทธิ์ของบทบาทลูกค้าเมื่อบันทึกสิทธิ์ใน UI
MGMT-2048 ผู้ใช้ที่มีบทบาทที่กำหนดเองซึ่งจํากัดสิทธิ์ในการติดตั้งใช้งานไว้ที่ 1 สภาพแวดล้อมจะติดตั้งใช้งานในสภาพแวดล้อมอื่นๆ ได้
MGMT-2041 นําองค์ประกอบ FaultRules ออกจากเทมเพลตไฟล์แนบเริ่มต้น
ระบบจะไม่เพิ่มองค์ประกอบ FaultRules ซึ่งไม่ได้ใช้ในนโยบายหรือขั้นตอนของพร็อกซี API โดยอัตโนมัติอีกต่อไปเมื่อคุณสร้างพร็อกซี API หรือเพิ่มนโยบาย
MGMT-2034 การดึงข้อมูล WSDL แสดงผลไม่สำเร็จ: "ข้อผิดพลาดในการดึงข้อมูล WSDL: ข้อผิดพลาดในการประมวลผล WSDL"
MGMT-1812 เพิ่มการตรวจสอบ TargetEndpoint ระหว่างการนําเข้า
TargetEndpoint จะได้รับการตรวจสอบสคีมาและนิพจน์ที่เหมาะสมซึ่งใช้ในเงื่อนไขระหว่างการนําเข้าพร็อกซี API เช่นเดียวกับ ProxyEndpoint
MGMT-1345 การนําเข้า WSDL ที่มีเนมสเปซหลายรายการทําให้ขั้นตอนการสร้าง SOAP ไม่ถูกต้อง
MGMT-800 การสร้างทรัพยากรที่มีชื่อ "default" จะทำให้ UI ใช้งานไม่ได้
MGMT-602 มุมมองการพัฒนาพร็อกซี API: เพิ่มนโยบายแคชคำตอบเมื่อปลายทางไม่มี ขั้นตอนก่อน/ขั้นตอนหลังทําให้เกิดข้อผิดพลาด
MGMT-460 การเปลี่ยนชื่อนโยบายส่งผลให้เกิดข้อบกพร่อง นโยบายซ้ำกันซึ่งนำออกไม่ได้
DEVRT-1565 ช่วงเวลา 15 นาทีสําหรับการเรียกเก็บเงิน
AXAPP-1728 ละเว้นตัวแปรการสร้างรายได้ในข้อมูลวิเคราะห์
AXAPP-1690 "ข้อผิดพลาด API ไม่ถูกต้อง" ในรายงานที่กําหนดเอง
AXAPP-1533 แผนภูมิภูมิศาสตร์ของ Analytics แสดงข้อผิดพลาด "การเรียก API ไม่ถูกต้อง"
APIRT-52 รายงานที่กําหนดเอง: รหัสสถานะการตอบกลับสําหรับ API จํานวนมากเป็นค่าว่าง