Endpoint Resolution - Resolve
แก้ไขจุดสิ้นสุดสําหรับบริการที่กําหนดซึ่งเรียกใช้โดย Microsoft Fabric
แก้ไขจุดสิ้นสุดสําหรับบริการที่กําหนดซึ่งเรียกใช้โดย Microsoft Fabric ตามภูมิภาคและภูมิภาคของพื้นที่ทํางานของผู้เช่า Fabric ให้ชุดของคุณสมบัติบริบทและส่งกลับ URL จุดสิ้นสุดบริการที่เหมาะสมและ time-to-live (TTL)
API ความละเอียดของจุดสิ้นสุดเป็นสิ่งสําคัญสําหรับบริการที่จําเป็นต้องมีการกําหนดจุดสิ้นสุดแบบไดนามิกตามบริบทการดําเนินงาน ซึ่งช่วยให้สามารถกําหนดเส้นทางและการปฏิบัติตามกฎระเบียบของภูมิภาคได้อย่างเหมาะสม
เมื่อต้องการแก้ไขจุดสิ้นสุด Fabric จะส่งคําขอ POST พร้อมกับคุณสมบัติบริบทที่จําเป็นในเนื้อความของคําขอ การตอบกลับจะประกอบด้วย URL ที่แก้ไขแล้วและ TTL ซึ่งระบุระยะเวลาที่ URL ถือว่าถูกต้อง
สําหรับตัวอย่างการใช้งานและตัวอย่างการใช้งาน โปรดดูที่ รหัสตัวอย่างการแก้ปัญหาจุดสิ้นสุด
POST https://workload.contoso.com/workload-api-path-placeholder/resolve-api-path-placeholder
ส่วนหัวของคำขอ
| ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|
| ActivityId | True |
string |
ID ที่ไม่ซ้ํากันสําหรับความสัมพันธ์ของคําขอกับระบบของคุณเมื่อผู้ใช้โต้ตอบกับปริมาณงานของคุณ |
| RequestId | True |
string |
ID ที่ไม่ซ้ํากันทั่วโลกที่ช่วยให้ Fabric สัมพันธ์กับคําขอของคุณกับบันทึกของเรา ระบุ ID นี้เมื่อรายงานปัญหา |
| Authorization | True |
string |
ส่วนหัวการอนุญาตโทเค็นคู่ที่อนุญาตให้ปริมาณงานตรวจสอบแหล่งที่มาของคําขอ ให้บริบทของผู้ใช้ และเรียกบริการอื่น ๆ ส่วนหัวนี้มีรูปแบบต่อไปนี้: |
เนื้อความของคำขอ
| ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|
| context | True |
อาร์เรย์ของคุณสมบัติบริบทสําหรับความละเอียดจุดสิ้นสุด |
การตอบสนอง
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| 200 OK |
การตอบสนองความละเอียดของจุดสิ้นสุด |
|
| Other Status Codes |
สําหรับเงื่อนไขของข้อผิดพลาด ปริมาณงานควรส่งกลับรหัสสถานะข้อผิดพลาด HTTP ที่เหมาะสม (4xx, 5xx) พร้อมข้อมูลข้อผิดพลาดโดยละเอียดในเนื้อความการตอบสนอง |
คำจำกัดความ
| ชื่อ | คำอธิบาย |
|---|---|
|
Endpoint |
กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric |
|
Endpoint |
ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด |
|
Endpoint |
|
|
Endpoint |
|
|
Error |
ข้อมูลข้อผิดพลาดเพิ่มเติม |
|
Error |
การตอบสนองข้อผิดพลาด |
|
Error |
แหล่งข้อมูลของข้อผิดพลาด |
|
Name |
คู่ชื่อ-ค่า |
EndpointResolutionContextProperty
กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| name |
ชื่อของคุณสมบัติบริบท |
|
| value |
string |
ค่าของคุณสมบัติบริบท |
EndpointResolutionContextPropertyName
ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด
| ค่า | คำอธิบาย |
|---|---|
| EndpointName | |
| TenantRegion | |
| WorkspaceRegion | |
| TenantId |
EndpointResolutionRequest
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| context |
อาร์เรย์ของคุณสมบัติบริบทสําหรับความละเอียดจุดสิ้นสุด |
EndpointResolutionResponse
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ttlInMinutes |
integer (int32) |
ได้เวลาถ่ายทอดสดในไม่กี่นาทีสําหรับ URL ที่แก้ไขแล้ว |
| url |
string |
URL ที่แก้ไขแล้วของบริการ |
ErrorExtendedInformation
ข้อมูลข้อผิดพลาดเพิ่มเติม
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| additionalParameters |
รายการพารามิเตอร์เพิ่มเติมเฉพาะสําหรับข้อผิดพลาด |
|
| errorCode |
string |
รหัสข้อผิดพลาด |
| message |
string |
ข้อความแสดงข้อผิดพลาด |
| messageParameters |
string[] |
รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น |
ErrorResponse
การตอบสนองข้อผิดพลาด
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| errorCode |
string |
รหัสข้อผิดพลาด |
| isPermanent |
boolean |
ระบุว่าข้อผิดพลาดเป็นแบบถาวรหรือสามารถลองดําเนินการใหม่ได้ |
| message |
string |
ข้อความแสดงข้อผิดพลาด |
| messageParameters |
string[] |
รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น |
| moreDetails |
รายการรายละเอียดข้อผิดพลาดเพิ่มเติม |
|
| source |
แหล่งข้อมูลข้อผิดพลาด |
ErrorSource
แหล่งข้อมูลของข้อผิดพลาด
| ค่า | คำอธิบาย |
|---|---|
| System | |
| User | |
| External |
NameValuePair
คู่ชื่อ-ค่า
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| name |
string |
ชื่อ |
| value |
string |
ค่า |