Items - Create Notebook

บริการ:: Notebook

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

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

เมื่อต้องการสร้างสมุดบันทึกด้วยข้อกําหนด ให้ดูบทความข้อกําหนด สมุดบันทึก

สิทธิ์

ผู้เรียกต้องมีบทบาทพื้นที่ทํางานผู้สนับสนุน

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

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

ขีด จำกัด

เมื่อต้องการสร้างสมุดบันทึก พื้นที่ทํางานต้องอยู่บนความจุ Fabric ที่ได้รับการสนับสนุน สําหรับข้อมูลเพิ่มเติม โปรดดูที่: สิทธิ์การใช้งาน Microsoft Fabric ประเภท

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

API นี้สนับสนุน Microsoft identitiesที่ระบุในส่วนนี้

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

อิน เทอร์ เฟซ

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
workspaceId	path	True	string (uuid)	ID พื้นที่ทํางาน

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

ชื่อ	จำเป็น	พิมพ์	คำอธิบาย
displayName	True	string	ชื่อที่แสดงของสมุดบันทึก ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
definition		NotebookDefinition	ข้อกําหนดสาธารณะของสมุดบันทึก
description		string	คําอธิบายของสมุดบันทึก ความยาวสูงสุดคือ 256 อักขระ
folderId		string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null สมุดบันทึกจะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์
sensitivityLabelSettings		SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับสําหรับสมุดบันทึก

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	Notebook	สร้างเสร็จเรียบร้อยแล้ว
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	รหัสข้อผิดพลาดทั่วไป: InvalidItemType - ชนิดรายการไม่ถูกต้อง ItemDisplayNameAlreadyInUse - ชื่อที่ใช้แสดงรายการถูกใช้แล้ว CorruptedPayload - ส่วนข้อมูลที่ให้มาเสียหาย WorkspaceItemsLimitExceeded - เกินขีดจํากัดของรายการพื้นที่ทํางาน

ตัวอย่าง

Create a notebook example

Create a notebook with public definition in fabricGitSource format example

Create a notebook with public definition in ipynb format example

Create a notebook example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/notebooks

{
  "displayName": "Notebook 1",
  "description": "A notebook description."
}

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

รหัสสถานะ:: 201

{
  "displayName": "Notebook 1",
  "description": "A notebook description.",
  "type": "Notebook",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

รหัสสถานะ:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a notebook with public definition in fabricGitSource format example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/notebooks

{
  "displayName": "Notebook 1",
  "description": "A notebook description",
  "definition": {
    "format": "fabricGitSource",
    "parts": [
      {
        "path": "notebook-content.py",
        "payload": "eyJuYmZvcm1hdCI6N..5ndWUiOiJweXRob24ifX19",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:: 201

{
  "displayName": "Notebook 1",
  "description": "A notebook description",
  "type": "Notebook",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

รหัสสถานะ:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a notebook with public definition in ipynb format example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/notebooks

{
  "displayName": "Notebook 1",
  "description": "A notebook description",
  "definition": {
    "format": "ipynb",
    "parts": [
      {
        "path": "notebook-content.ipynb",
        "payload": "eyJuYmZvcm1hdCI6N..5ndWUiOiJweXRob24ifX19",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

รหัสสถานะ:: 201

{
  "displayName": "Notebook 1",
  "description": "A notebook description",
  "type": "Notebook",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

รหัสสถานะ:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

คำจำกัดความ

ชื่อ	คำอธิบาย
CreateNotebookRequest	สร้างส่วนข้อมูลการร้องขอของสมุดบันทึก
EntireTenantPrincipal	แสดงองค์ประกอบหลักของผู้เช่า
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก `Group`
GroupPrincipal	แสดงกลุ่มความปลอดภัย
GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป
ItemTag	แสดงแท็กที่ใช้กับรายการ
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
Notebook	วัตถุสมุดบันทึก
NotebookDefinition	วัตถุนิยามสาธารณะของสมุดบันทึก โปรดดู บทความนี้ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างของข้อกําหนดของสมุดบันทึก
NotebookDefinitionPart	วัตถุข้อกําหนดของสมุดบันทึก
PayloadType	ชนิดของส่วนข้อกําหนดส่วนข้อมูล อาจมีการเพิ่มชนิดของส่วนข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
PrincipalType	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
SensitivityLabel	แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ
SensitivityLabelApplyStrategy	กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป
SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับ
ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก `ServicePrincipal`
ServicePrincipalPrincipal	แสดง Microsoft Entra บริการหลัก
ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก `ServicePrincipalProfile`
ServicePrincipalProfilePrincipal	แสดงโปรไฟล์บริการหลัก
UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก `User`
UserPrincipal	แสดง Microsoft Entra หลักของผู้ใช้

CreateNotebookRequest

วัตถุ

สร้างส่วนข้อมูลการร้องขอของสมุดบันทึก

ชื่อ	พิมพ์	คำอธิบาย
definition	NotebookDefinition	ข้อกําหนดสาธารณะของสมุดบันทึก
description	string	คําอธิบายของสมุดบันทึก ความยาวสูงสุดคือ 256 อักขระ
displayName	string	ชื่อที่แสดงของสมุดบันทึก ชื่อที่แสดงต้องเป็นไปตามกฎการตั้งชื่อตามชนิดหน่วยข้อมูล
folderId	string (uuid)	ID โฟลเดอร์ ถ้าไม่ได้ระบุหรือเป็น null สมุดบันทึกจะถูกสร้างขึ้นด้วยพื้นที่ทํางานเป็นโฟลเดอร์
sensitivityLabelSettings	SensitivityLabelSettings	การตั้งค่าป้ายชื่อระดับความลับสําหรับสมุดบันทึก

EntireTenantPrincipal

วัตถุ

แสดงองค์ประกอบหลักของผู้เช่า

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: EntireTenant	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

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	รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด

GroupDetails

วัตถุ

รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก Group

ชื่อ	พิมพ์	คำอธิบาย
groupType	GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป

GroupPrincipal

วัตถุ

แสดงกลุ่มความปลอดภัย

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
groupDetails	GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก `Group`
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: Group	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

GroupType

การแจงนับ

ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Unknown	ไม่รู้จักชนิดกลุ่มหลัก
SecurityGroup	หลักคือกลุ่มความปลอดภัย
DistributionList	หลักคือรายการการแจกจ่าย

ItemTag

วัตถุ

แสดงแท็กที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อของแท็ก
id	string (uuid)	ID แท็ก

ItemType

การแจงนับ

ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
Dashboard	แดชบอร์ด PowerBI
Report	รายงาน PowerBI
SemanticModel	แบบจําลองความหมายของ PowerBI
PaginatedReport	รายงานที่มีการแบ่งหน้าของ PowerBI
Datamart	Datamart ของ PowerBI
Lakehouse	เลคเฮ้าส์
Eventhouse	อาคารจัดงาน
Environment	สภาพแวดล้อม
KQLDatabase	ฐานข้อมูล KQL
KQLQueryset	ชุดคิวรี KQL
KQLDashboard	แดชบอร์ด KQL
DataPipeline	ไปป์ไลน์ข้อมูล
Notebook	โน๊ตบุ๊ค
SparkJobDefinition	ข้อกําหนดงานแบบประกายไฟ
MLExperiment	การทดลองการเรียนรู้ของเครื่อง
MLModel	แบบจําลองการเรียนรู้ของเครื่อง
Warehouse	คลังสินค้า
Eventstream	เหตุการณ์กระแสข้อมูล
SQLEndpoint	จุดสิ้นสุด SQL
MirroredWarehouse	คลังสินค้าที่มิเรอร์
MirroredDatabase	ฐานข้อมูลที่มิเรอร์
Reflex	รีเฟล็กซ์
GraphQLApi	API สําหรับรายการ GraphQL
MountedDataFactory	เมาท์ DataFactory
SQLDatabase	SQLDatabase
CopyJob	งานคัดลอก
VariableLibrary	VariableLibrary
Dataflow	กระแสข้อมูล
ApacheAirflowJob	ApacheAirflowJob
WarehouseSnapshot	สแนปช็อตของคลังสินค้า
DigitalTwinBuilder	DigitalTwinBuilder
DigitalTwinBuilderFlow	โฟลว์ Digital Twin Builder
MirroredAzureDatabricksCatalog	แค็ตตาล็อก azure databricks ที่มิเรอร์
Map	แผนที่.
AnomalyDetector	การตรวจหาความผิดปกติ
UserDataFunction	ฟังก์ชันข้อมูลผู้ใช้
GraphModel	GraphModel
GraphQuerySet	ชุดคิวรีกราฟ
SnowflakeDatabase	ฐานข้อมูล Snowflake เพื่อจัดเก็บตาราง Iceberg ที่สร้างขึ้นจากบัญชี Snowflake
OperationsAgent	OperationsAgent
CosmosDBDatabase	ฐานข้อมูล Cosmos DB
Ontology	โทโพโลยี
EventSchemaSet	EventSchemaSet
DataAgent	DataAgent

Notebook

วัตถุ

วัตถุสมุดบันทึก

ชื่อ	พิมพ์	คำอธิบาย
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	ข้อมูลประจําตัวเริ่มต้นของรายการ
description	string	คําอธิบายสินค้า
displayName	string	ชื่อที่แสดงของรายการ
folderId	string (uuid)	ID โฟลเดอร์
id	string (uuid)	รหัสสินค้า
sensitivityLabel	SensitivityLabel	ป้ายชื่อระดับความลับของหน่วยข้อมูล
tags	ItemTag[]	รายการของแท็กที่ใช้
type	ItemType	ชนิดหน่วยข้อมูล
workspaceId	string (uuid)	ID พื้นที่ทํางาน

NotebookDefinition

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
format	string	รูปแบบของข้อกําหนดของสมุดบันทึก รูปแบบที่ได้รับการสนับสนุน: `ipynb` และ`fabricGitSource` ถ้าไม่ได้ระบุ `fabricGitSource` รูปแบบ ไว้ จะถูกใช้
parts	NotebookDefinitionPart[]	รายการของส่วนข้อกําหนด

NotebookDefinitionPart

วัตถุ

วัตถุข้อกําหนดของสมุดบันทึก

ชื่อ	พิมพ์	คำอธิบาย
path	string	เส้นทางของสมุดบันทึก ส่วนขยายเนื้อหาของสมุดบันทึกที่ได้รับการสนับสนุน: สําหรับรูปแบบ, , `.ipynbipynb`, `.py` สําหรับ`.scala`รูปแบบ `.r.sqlfabricGitSource`
payload	string	ส่วนข้อมูลของสมุดบันทึก
payloadType	PayloadType	ชนิดของส่วนข้อมูล

PayloadType

การแจงนับ

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

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

PrincipalType

การแจงนับ

ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
User	หลักเป็น Microsoft Entra หลักของผู้ใช้
ServicePrincipal	หลักเป็น Microsoft Entra บริการหลัก
Group	หลักคือกลุ่มความปลอดภัย
ServicePrincipalProfile	หลักคือ โปรไฟล์โครงร่างสําคัญของบริการ
EntireTenant	หลักแสดงผู้ใช้ที่เป็นผู้เช่าทั้งหมด

SensitivityLabel

วัตถุ

แสดงป้ายชื่อระดับความลับที่ใช้กับรายการ

ชื่อ	พิมพ์	คำอธิบาย
id	string (uuid)	รหัสป้ายชื่อระดับความลับ

SensitivityLabelApplyStrategy

การแจงนับ

กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ ค่าเริ่มต้นคือ ApplyOrFail คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
ApplyOrFail	ใช้ป้ายชื่อระดับความลับหรือล้มเหลวของการดําเนินการถ้าไม่สามารถนําไปใช้ได้
Ignore	ละเว้นป้ายชื่อระดับความลับหากไม่สามารถใช้และดําเนินการต่อด้วยการดําเนินการโดยไม่ต้องใช้ป้ายชื่อ

SensitivityLabelSettings

วัตถุ

การตั้งค่าป้ายชื่อระดับความลับ

ชื่อ	พิมพ์	คำอธิบาย
labelId	string (uuid)	รหัสป้ายชื่อระดับความลับ
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	กลยุทธ์สําหรับการใช้ป้ายชื่อระดับความลับ

ServicePrincipalDetails

วัตถุ

รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก ServicePrincipal

ชื่อ	พิมพ์	คำอธิบาย
aadAppId	string (uuid)	AppId Microsoft Entra ของโครงร่างสําคัญของบริการ

ServicePrincipalPrincipal

วัตถุ

แสดง Microsoft Entra บริการหลัก

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
servicePrincipalDetails	ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก `ServicePrincipal`
type	string: ServicePrincipal	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

ServicePrincipalProfileDetails

วัตถุ

รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก ServicePrincipalProfile

ชื่อ	พิมพ์	คำอธิบาย
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	โครงร่างสําคัญของโปรไฟล์บริการหลัก

ServicePrincipalProfilePrincipal

วัตถุ

แสดงโปรไฟล์บริการหลัก

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก `ServicePrincipalProfile`
type	string: ServicePrincipalProfile	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป

UserDetails

วัตถุ

รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก User

ชื่อ	พิมพ์	คำอธิบาย
userPrincipalName	string	ชื่อหลักของผู้ใช้

UserPrincipal

วัตถุ

แสดง Microsoft Entra หลักของผู้ใช้

ชื่อ	พิมพ์	คำอธิบาย
displayName	string	ชื่อที่แสดงขององค์ประกอบหลัก
id	string (uuid)	ID ของโครงร่างสําคัญ
type	string: User	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
userDetails	UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก `User`