Endpoint Resolution - Resolve
แก้ไขจุดสิ้นสุดสําหรับบริการที่กําหนดซึ่งถูกเรียกโดย Microsoft Fabric
แก้ไขจุดสิ้นสุดสําหรับบริการที่กําหนดซึ่งเรียกใช้โดย Microsoft Fabric ตามภูมิภาคและภูมิภาคของพื้นที่ทํางานของผู้เช่า Fabric ให้ชุดของคุณสมบัติบริบทและส่งกลับ URL จุดสิ้นสุดบริการที่เหมาะสมและ time-to-live (TTL)
API ความละเอียดของจุดสิ้นสุดเป็นสิ่งสําคัญสําหรับบริการที่จําเป็นต้องมีการกําหนดจุดสิ้นสุดแบบไดนามิกตามบริบทการดําเนินงาน ซึ่งช่วยให้สามารถกําหนดเส้นทางและการปฏิบัติตามกฎระเบียบของภูมิภาคได้อย่างเหมาะสม
เมื่อต้องการแก้ไขจุดสิ้นสุด Fabric จะส่งคําขอ POST พร้อมกับคุณสมบัติบริบทที่จําเป็นในเนื้อความของคําขอ การตอบกลับจะประกอบด้วย URL ที่แก้ไขแล้วและ TTL ซึ่งระบุระยะเวลาที่ URL ถือว่าถูกต้อง
สําหรับตัวอย่างการใช้งานและตัวอย่างการใช้งาน โปรดดูที่ รหัสตัวอย่างการแก้ปัญหาจุดสิ้นสุด
POST https://be.myWorkload.contoso.com/workload-api-path-placeholder/resolve-api-path-placeholder
ส่วนหัวของคำขอ
| ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|
| ActivityId | True |
string (uuid) |
ID ที่ไม่ซ้ํากันสําหรับความสัมพันธ์ของคําขอกับระบบของคุณเมื่อผู้ใช้โต้ตอบกับปริมาณงานของคุณ |
| RequestId | True |
string (uuid) |
ID ที่ไม่ซ้ํากันทั่วโลกที่ช่วยให้ Fabric สัมพันธ์กับคําขอของคุณกับบันทึกของเรา ระบุ ID นี้เมื่อรายงานปัญหา |
| Authorization | True |
string |
ส่วนหัวการอนุญาตโทเค็นคู่ที่อนุญาตให้ปริมาณงานตรวจสอบแหล่งที่มาของคําขอ ให้บริบทของผู้ใช้ และเรียกบริการอื่น ๆ ส่วนหัวนี้มีรูปแบบต่อไปนี้: |
เนื้อความของคำขอ
| ชื่อ | จำเป็น | พิมพ์ | คำอธิบาย |
|---|---|---|---|
| context | True |
อาร์เรย์ของคุณสมบัติบริบทสําหรับความละเอียดจุดสิ้นสุด |
การตอบสนอง
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| 200 OK |
การตอบสนองความละเอียดของปลายทาง |
|
| Other Status Codes |
สําหรับเงื่อนไขของข้อผิดพลาด ปริมาณงานควรส่งกลับรหัสสถานะข้อผิดพลาด HTTP ที่เหมาะสม (4xx, 5xx) พร้อมข้อมูลข้อผิดพลาดโดยละเอียดในเนื้อความการตอบสนอง |
ตัวอย่าง
Resolve endpoint example
คำขอตัวอย่าง
POST https://be.myWorkload.contoso.com/workload-api-path-placeholder/resolve-api-path-placeholder
{
"context": [
{
"name": "EndpointName",
"value": "Workload"
},
{
"name": "TenantRegion",
"value": "West Central US"
},
{
"name": "WorkspaceRegion",
"value": "West Central US"
}
]
}
คำตอบตัวอย่าง
{
"url": "https://my-service-name-resolved.example.com",
"ttlInMinutes": 60
}
คำจำกัดความ
| ชื่อ | คำอธิบาย |
|---|---|
|
Endpoint |
กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric |
|
Endpoint |
ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด |
|
Endpoint |
|
|
Endpoint |
|
|
Error |
ข้อมูลข้อผิดพลาดเพิ่มเติม |
|
Error |
การตอบสนองข้อผิดพลาด |
|
Error |
แหล่งข้อมูลของข้อผิดพลาด |
|
Name |
คู่ชื่อ-ค่า |
EndpointResolutionContextProperty
กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| name |
ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด |
|
| value |
string |
ค่าของคุณสมบัติบริบท |
EndpointResolutionContextPropertyName
ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด
| ค่า | คำอธิบาย |
|---|---|
| EndpointName |
ชื่อปลายทาง |
| TenantRegion |
ภูมิภาคผู้เช่า |
| WorkspaceRegion |
ภูมิภาคพื้นที่ทํางาน |
| TenantId |
ID ผู้เช่า |
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 |
ค่า |