Items - Update Graph Model Definition

บริการ:: GraphModel

เวอร์ชัน API:: v1

แทนที่ข้อกําหนดสําหรับ GraphModel ที่ระบุ

Note

รายการ GraphModel อยู่ในการแสดงตัวอย่าง (เรียนรู้เพิ่มเติม)

API นี้สนับสนุน การดําเนินการที่ใช้เวลานาน (LRO)

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

การอนุญาต

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

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

Item.ReadWrite.All

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

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

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

อินเตอร์เฟซ

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/GraphModels/{GraphModelId}/updateDefinition

ด้วยพารามิเตอร์ที่เลือกได้:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/GraphModels/{GraphModelId}/updateDefinition?updateMetadata={updateMetadata}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
GraphModelId	path	True	string (uuid)	ID ของ GraphModel
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน
updateMetadata	query		boolean	เมื่อตั้งค่าเป็น true และไฟล์ .platform เป็นส่วนหนึ่งของข้อกําหนด เมตาดาต้าของรายการจะได้รับการอัปเดตโดยใช้เมตาดาต้าในไฟล์ .platform

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

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
definition	True	GraphModelPublicDefinition	ออบเจ็กต์ข้อกําหนดสาธารณะของ GraphModel โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างคําจํากัดความสาธารณะของ GraphModel

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK		คําขอเสร็จสมบูรณ์
202 Accepted		คําขอได้รับการยอมรับ กําลังดําเนินการข้อกําหนดการอัปเดต ส่วนหัว Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	เกินขีดจํากัดอัตราการบริการ เซิร์ฟเวอร์จะส่งกลับ `Retry-After` ส่วนหัวที่ระบุ ภายในไม่กี่วินาที ระยะเวลาที่ไคลเอ็นต์ต้องรอก่อนที่จะส่งคําขอเพิ่มเติม ส่วนหัว Retry-After: integer
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: OperationNotSupportedForItem - การดําเนินการไม่ได้รับการสนับสนุนสําหรับรายการที่ร้องขอ CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย

ตัวอย่าง

Update a GraphModel public definition example

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

HTTP

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

{
  "definition": {
    "format": "json",
    "parts": [
      {
        "path": "graphType.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "graphDefinition.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "dataSources.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "stylingConfiguration.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "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	รายละเอียดการตอบสนองข้อผิดพลาด
GraphModelDefinitionFormat	รูปแบบของข้อกําหนดหน่วยข้อมูล ประเภท `format` เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
GraphModelPublicDefinition	ออบเจ็กต์ข้อกําหนดสาธารณะของ GraphModel โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างคําจํากัดความสาธารณะของ GraphModel
GraphModelPublicDefinitionPart	ออบเจ็กต์ส่วนของข้อกําหนด GraphModel
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
UpdateGraphModelDefinitionRequest	อัปเดตส่วนข้อมูลการร้องขอข้อกําหนดสาธารณะของ GraphModel

ErrorRelatedResource

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
resourceId	string	ID ทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
resourceType	string	ชนิดของทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponse

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
moreDetails	ErrorResponseDetails[]	รายการรายละเอียดข้อผิดพลาดเพิ่มเติม
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
requestId	string (uuid)	รหัสของคําขอที่เกี่ยวข้องกับข้อผิดพลาด

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
relatedResource	ErrorRelatedResource	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GraphModelDefinitionFormat

การแจงนับ

รูปแบบของข้อกําหนดหน่วยข้อมูล ประเภท format เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
json	รูปแบบ JSON สําหรับข้อกําหนดสาธารณะของ GraphModel ซึ่งออกแบบมาโดยเฉพาะเพื่อสนับสนุนสถานการณ์ CI/CD ใน Fabric

GraphModelPublicDefinition

วัตถุ

ออบเจ็กต์ข้อกําหนดสาธารณะของ GraphModel โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างคําจํากัดความสาธารณะของ GraphModel

ชื่อ	พิมพ์	คำอธิบาย
format	GraphModelDefinitionFormat	รูปแบบของข้อกําหนดหน่วยข้อมูล ประเภท `format` เพิ่มเติมอาจเพิ่มเมื่อเวลาผ่านไป
parts	GraphModelPublicDefinitionPart[]	รายการของส่วนข้อกําหนด

GraphModelPublicDefinitionPart

วัตถุ

ออบเจ็กต์ส่วนของข้อกําหนด GraphModel

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางส่วนข้อกําหนดสาธารณะของ GraphModel
payload	string	ส่วนข้อกําหนดสาธารณะของ GraphModel
payloadType	PayloadType	ชนิดของส่วนข้อมูล

PayloadType

การแจงนับ

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

ค่า	คำอธิบาย
InlineBase64	ฐานแบบอินไลน์ 64

UpdateGraphModelDefinitionRequest

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
definition	GraphModelPublicDefinition	ออบเจ็กต์ข้อกําหนดสาธารณะของ GraphModel โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการสร้างคําจํากัดความสาธารณะของ GraphModel

แชร์ผ่าน

Items - Update Graph Model Definition

การอนุญาต

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

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

อินเตอร์เฟซ

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

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

การตอบสนอง

ตัวอย่าง

Update a GraphModel public definition example

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

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

คำจำกัดความ

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GraphModelDefinitionFormat

GraphModelPublicDefinition

GraphModelPublicDefinitionPart

PayloadType

UpdateGraphModelDefinitionRequest