แชร์ผ่าน

Items - Update Semantic Model Definition

บริการ:
SemanticModel
เวอร์ชัน API:
v1

แทนที่ข้อกําหนดสําหรับแบบจําลองความหมายที่ระบุ
API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

การอัปเดตข้อกําหนดของแบบจําลองความหมายไม่ส่งผลกระทบต่อป้ายชื่อระดับความลับ

สิทธิ์

ผู้เรียกต้องมีสิทธิ์ ในการอ่านและเขียน สําหรับแบบจําลองความหมาย

จําเป็นต้องมีขอบเขตที่ได้รับมอบสิทธิ์

SemanticModel.ReadWrite.All หรือ Item.ReadWrite.All

ข้อมูลประจําตัวที่สนับสนุนของ Microsoft Entra

API นี้สนับสนุนข้อมูลประจําตัวของ Microsoft แสดงรายการในส่วนนี้

เอกลักษณ์ สนับสนุน
ผู้ใช้ ใช่
บริการหลักและข้อมูลประจําตัว ที่มีการจัดการ ใช่

อิน เทอร์ เฟซ

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/updateDefinition
ด้วยพารามิเตอร์ที่เลือกได้: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/updateDefinition?updateMetadata={updateMetadata}

พารามิเตอร์ URI

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

string (uuid)

ID แบบจําลองความหมาย
workspaceId
 path True

string (uuid)

ID พื้นที่ทํางาน
updateMetadata
 query

boolean

เมื่อตั้งค่าเป็น true และไฟล์ .platform เป็นส่วนหนึ่งของข้อกําหนด เมตาดาต้าของรายการจะได้รับการอัปเดตโดยใช้เมตาดาต้าในไฟล์ .platform

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

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

SemanticModelDefinition

ข้อกําหนดสาธารณะของแบบจําลองความหมาย วัตถุ

การตอบสนอง

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

คําขอเสร็จสมบูรณ์
202 Accepted

คําขอได้รับการยอมรับ กําลังดําเนินการข้อกําหนดการอัปเดต

ส่วนหัว

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

รหัสข้อผิดพลาดทั่วไป:

  • OperationNotSupportedForItem - การดําเนินการไม่ได้รับการสนับสนุนสําหรับรายการที่ร้องขอ

  • CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย

ตัวอย่าง

Update a semantic model definition example

คำขอตัวอย่าง

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "model.bim",
        "payload": "ewogICJjb21wYXRpYmlsaXR5TGV2ZW..GVzIjogWyBdDQogIH0NCn0",
        "payloadType": "InlineBase64"
      },
      {
        "path": "definition.pbism",
        "payload": "ewogICJ2ZXJzaW9uIjogIjQuMC..HRpbmdzIjoge30KfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

คำตอบตัวอย่าง

รหัสสถานะ:
200
รหัสสถานะ:
202 
Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

คำจำกัดความ

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

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse

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

รายละเอียดการตอบสนองข้อผิดพลาด
PayloadType

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
SemanticModelDefinition

ข้อกําหนดสาธารณะของแบบจําลองความหมาย วัตถุ
SemanticModelDefinitionPart

ออบเจ็กต์ส่วนของข้อกําหนดแบบจําลองเชิงความหมาย
UpdateSemanticModelDefinitionRequest

อัปเดตข้อกําหนดสาธารณะของแบบจําลองความหมายคําขอส่วนข้อมูลสาธารณะ

ErrorRelatedResource

ออบเจ็กต์

ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

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

string

ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType

string

ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails

ErrorResponseDetails[]

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

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId

string

รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

ออบเจ็กต์

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

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

string

ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message

string

การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource

ErrorRelatedResource

รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

PayloadType

การแจงนับ

ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

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

ฐานแบบอินไลน์ 64

SemanticModelDefinition

ออบเจ็กต์

ข้อกําหนดสาธารณะของแบบจําลองความหมาย วัตถุ

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

string

รูปแบบของข้อกําหนดหน่วยข้อมูล
parts

SemanticModelDefinitionPart[]

รายการของส่วนข้อกําหนด

SemanticModelDefinitionPart

ออบเจ็กต์

ออบเจ็กต์ส่วนของข้อกําหนดแบบจําลองเชิงความหมาย

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

string

เส้นทางส่วนของแบบจําลองความหมาย
payload

string

ส่วนแบบจําลองความหมายส่วน
payloadType

PayloadType

ชนิดของส่วนข้อมูล

UpdateSemanticModelDefinitionRequest

ออบเจ็กต์

อัปเดตข้อกําหนดสาธารณะของแบบจําลองความหมายคําขอส่วนข้อมูลสาธารณะ

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

SemanticModelDefinition

ข้อกําหนดสาธารณะของแบบจําลองความหมาย วัตถุ