Items - Create Deployment Plan

บริการ:: DeploymentPlan

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

สร้างแผนการปรับใช้ในพื้นที่ทํางานที่ระบุ

Note

รายการแผนการปรับใช้อยู่ในตัวอย่างในขณะนี้ (เรียนรู้เพิ่มเติม)

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

หากต้องการสร้างแผนการปรับใช้ที่มีข้อกําหนด โปรดดูที่บทความ แผนการปรับใช้

Permissions

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

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

Item.ReadWrite.All

Limitations

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

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

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

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

อินเทอร์เฟซ

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

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

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

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

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

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
201 Created	DeploymentPlan	สร้างเสร็จเรียบร้อยแล้ว
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 deployment plan example

Create a deployment plan with definition example

Create a deployment plan example

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

HTTP

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

{
  "displayName": "DeploymentPlan 1",
  "description": "A deployment plan description."
}

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

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

{
  "displayName": "DeploymentPlan 1",
  "description": "A deployment plan description.",
  "type": "DeploymentPlan",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

รหัสสถานะ:: 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 deployment plan with definition example

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

HTTP

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

{
  "displayName": "DeploymentPlan 1",
  "description": "A deployment plan description.",
  "definition": {
    "format": "DeploymentPlanFormat",
    "parts": [
      {
        "path": "plan.yml",
        "payload": "eyJleGVjdXRhYmxlRm9ybWF0IjoiRGVwbG95bWVudFBsYW5WMSIsImlkIjoiOWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

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

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

{
  "displayName": "DeploymentPlan 1",
  "description": "A deployment plan description.",
  "type": "DeploymentPlan",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

รหัสสถานะ:: 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

คำจำกัดความ

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

CreateDeploymentPlanRequest

วัตถุ

คําขอส่วนข้อมูลสําหรับการสร้างแผนการปรับใช้

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

DeploymentPlan

วัตถุ

ออบเจ็กต์แผนการปรับใช้

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

DeploymentPlanDefinitionFormat

การแจงนับ

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

ค่า	คำอธิบาย
DeploymentPlanFormat	รูปแบบสําหรับข้อกําหนดแผนการปรับใช้ที่ออกแบบมาเพื่อสนับสนุนสถานการณ์ CI/CD ใน Fabric ดู แผนการปรับใช้ - ข้อกําหนด DeploymentPlanV1 สําหรับรายละเอียดเพิ่มเติม

DeploymentPlanPublicDefinition

วัตถุ

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

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

DeploymentPlanPublicDefinitionPart

วัตถุ

ออบเจ็กต์ส่วนของข้อกําหนดแผนการปรับใช้

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

EntireTenantPrincipal

วัตถุ

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

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

ErrorParameter

วัตถุ

พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด

ชื่อ	พิมพ์	คำอธิบาย
message	string	คําอธิบายที่มนุษย์สามารถอ่านได้ของความหมายของพารามิเตอร์
name	string	ตัวระบุพารามิเตอร์
value	string	ค่าพารามิเตอร์

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

ชื่อ	พิมพ์	คำอธิบาย
errorCode	string	ตัวระบุเฉพาะที่ให้ข้อมูลเกี่ยวกับเงื่อนไขข้อผิดพลาด ทําให้สามารถสื่อสารได้มาตรฐานระหว่างบริการของเรากับผู้ใช้
message	string	การแสดงข้อผิดพลาดที่มนุษย์สามารถอ่านได้
parameters	ErrorParameter[]	พารามิเตอร์ที่มีโครงสร้างให้บริบทที่สามารถอ่านได้ด้วยเครื่องเพิ่มเติมเกี่ยวกับข้อผิดพลาด
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
MirroredCatalog	มิเรอร์ดคาตาล็อก
PolicySet	ชุดนโยบาย
AppBackend	AppBackend
OrgApp	แอปองค์กร
OrgAppAudience	ผู้ชมแอปองค์กร
DataBuildToolJob	DataBuildToolJob
AzureDatabricksStorage	รายการพื้นที่จัดเก็บข้อมูลที่สํารองข้อมูลโดย OneLake สําหรับ Azure Databricks
Plan	แผนน่ะ
Monitoring	รายการการตรวจสอบ
DeploymentPlan	แผนการปรับใช้งาน

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`