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

ส่วนหัวการอนุญาตโทเค็นคู่ที่อนุญาตให้ปริมาณงานตรวจสอบแหล่งที่มาของคําขอ ให้บริบทของผู้ใช้ และเรียกบริการอื่น ๆ ส่วนหัวนี้มีรูปแบบต่อไปนี้: SubjectAndAppToken1.0 subjectToken="delegated token", appToken="S2S token"

เนื้อความของคำขอ

ชื่อ จำเป็น พิมพ์ คำอธิบาย
context True

EndpointResolutionContextProperty[]

อาร์เรย์ของคุณสมบัติบริบทสําหรับความละเอียดจุดสิ้นสุด

การตอบสนอง

ชื่อ พิมพ์ คำอธิบาย
200 OK

EndpointResolutionResponse

การตอบสนองความละเอียดของปลายทาง

Other Status Codes

ErrorResponse

สําหรับเงื่อนไขของข้อผิดพลาด ปริมาณงานควรส่งกลับรหัสสถานะข้อผิดพลาด 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
}

คำจำกัดความ

ชื่อ คำอธิบาย
EndpointResolutionContextProperty

กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric

EndpointResolutionContextPropertyName

ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด

EndpointResolutionRequest
EndpointResolutionResponse
ErrorExtendedInformation

ข้อมูลข้อผิดพลาดเพิ่มเติม

ErrorResponse

การตอบสนองข้อผิดพลาด

ErrorSource

แหล่งข้อมูลของข้อผิดพลาด

NameValuePair

คู่ชื่อ-ค่า

EndpointResolutionContextProperty

กําหนดคุณสมบัติบริบทที่ใช้ในความละเอียดปลายทาง ต้องระบุคุณสมบัตินี้ในรายการปริมาณงานเพื่อให้แน่ใจว่าการกําหนดจุดสิ้นสุดถูกต้องโดย Fabric

ชื่อ พิมพ์ คำอธิบาย
name

EndpointResolutionContextPropertyName

ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด

value

string

ค่าของคุณสมบัติบริบท

EndpointResolutionContextPropertyName

ชื่อของคุณสมบัติสําหรับบริบทการแก้ปัญหาจุดสิ้นสุด

ค่า คำอธิบาย
EndpointName

ชื่อปลายทาง

TenantRegion

ภูมิภาคผู้เช่า

WorkspaceRegion

ภูมิภาคพื้นที่ทํางาน

TenantId

ID ผู้เช่า

EndpointResolutionRequest

ชื่อ พิมพ์ คำอธิบาย
context

EndpointResolutionContextProperty[]

อาร์เรย์ของคุณสมบัติบริบทสําหรับความละเอียดจุดสิ้นสุด

EndpointResolutionResponse

ชื่อ พิมพ์ คำอธิบาย
ttlInMinutes

integer (int32)

ได้เวลาถ่ายทอดสดในไม่กี่นาทีสําหรับ URL ที่แก้ไขแล้ว

url

string

URL ที่แก้ไขแล้วของบริการ

ErrorExtendedInformation

ข้อมูลข้อผิดพลาดเพิ่มเติม

ชื่อ พิมพ์ คำอธิบาย
additionalParameters

NameValuePair[]

รายการพารามิเตอร์เพิ่มเติมเฉพาะสําหรับข้อผิดพลาด

errorCode

string

รหัสข้อผิดพลาด

message

string

ข้อความแสดงข้อผิดพลาด

messageParameters

string[]

รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น

ErrorResponse

การตอบสนองข้อผิดพลาด

ชื่อ พิมพ์ คำอธิบาย
errorCode

string

รหัสข้อผิดพลาด

isPermanent

boolean

ระบุว่าข้อผิดพลาดเป็นแบบถาวรหรือสามารถลองดําเนินการใหม่ได้

message

string

ข้อความแสดงข้อผิดพลาด

messageParameters

string[]

รายการพารามิเตอร์สําหรับการจัดรูปแบบข้อความที่มีการแปลเป็นภาษาท้องถิ่น

moreDetails

ErrorExtendedInformation[]

รายการรายละเอียดข้อผิดพลาดเพิ่มเติม

source

ErrorSource

แหล่งข้อมูลของข้อผิดพลาด

ErrorSource

แหล่งข้อมูลของข้อผิดพลาด

ค่า คำอธิบาย
System

ข้อผิดพลาดมาจากระบบ

User

ข้อผิดพลาดเกิดจากการป้อนข้อมูลของผู้ใช้

External

ข้อผิดพลาดมาจากแหล่งข้อมูลภายนอก

NameValuePair

คู่ชื่อ-ค่า

ชื่อ พิมพ์ คำอธิบาย
name

string

ชื่อ

value

string

ค่า