Deployment Pipelines - Get Deployment Pipeline Operation

บริการ:: Core

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

ส่งกลับรายละเอียดของการดําเนินการปรับใช้ที่ระบุที่ดําเนินการในไปป์ไลน์การปรับใช้งานที่ระบุ รวมถึงแผนการดําเนินการปรับใช้

การอนุญาต

ผู้เรียกต้องมีบทบาทไปป์ไลน์การปรับใช้ผู้ดูแลระบบ

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

Pipeline.Read.All หรือ Pipeline.ReadWrite.All

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

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

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

อินเตอร์เฟซ

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations/{operationId}

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

ชื่อ	ใน	จำเป็น	พิมพ์	คำอธิบาย
deploymentPipelineId	path	True	string (uuid)	ID ไปป์ไลน์การปรับใช้
operationId	path	True	string (uuid)	รหัสการดําเนินงาน

การตอบสนอง

ชื่อ	พิมพ์	คำอธิบาย
200 OK	DeploymentPipelineOperationExtendedInfo	คําขอเสร็จสมบูรณ์
Other Status Codes	ErrorResponse	รหัสข้อผิดพลาดทั่วไป: UnknownError - เกิดข้อผิดพลาด

ชื่อ

พิมพ์

คำอธิบาย

200 OK

DeploymentPipelineOperationExtendedInfo

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

Other Status Codes

ErrorResponse

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

UnknownError - เกิดข้อผิดพลาด

ตัวอย่าง

Get a deployment pipeline operation example

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

HTTP

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations/1065e6a3-a020-4c0c-ada7-92b5fe99eec5

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

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

{
  "id": "1065e6a3-a020-4c0c-ada7-92b5fe99eec5",
  "type": "Deploy",
  "status": "Succeeded",
  "lastUpdatedTime": "2020-12-13T09:26:43.153",
  "executionStartTime": "2020-12-13T09:25:43.153Z",
  "executionEndTime": "2020-12-13T09:26:43.153Z",
  "sourceStageId": "2e6f0272-e809-410a-be63-50e1d97ba75a",
  "targetStageId": "d2056166-041c-4a56-8d37-ea90038bc0d6",
  "executionPlan": {
    "steps": [
      {
        "index": 0,
        "description": "DataflowDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "29efcfb0-0063-44af-a4ed-6c0bee3417d3",
          "sourceItemDisplayName": "Source dataflow",
          "itemType": "Dataflow"
        }
      },
      {
        "index": 1,
        "description": "DatamartDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "645cd81f-1b21-4006-82b6-54cc7ec0352e",
          "sourceItemDisplayName": "Source datamart",
          "itemType": "Datamart"
        }
      },
      {
        "index": 2,
        "description": "DatasetDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "NoDifference",
        "sourceAndTarget": {
          "sourceItemId": "1a201f2a-d1d8-45c0-8c61-1676338517de",
          "sourceItemDisplayName": "Source dataset",
          "targetItemId": "dd3b6aa1-4d40-405c-a19b-48314a27e8ee",
          "targetItemDisplayName": "Target dataset",
          "itemType": "SemanticModel"
        }
      },
      {
        "index": 3,
        "description": "ReportDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "Different",
        "sourceAndTarget": {
          "sourceItemId": "2d225191-65f8-4ec3-b77d-06100602b1f7",
          "sourceItemDisplayName": "Source report",
          "targetItemId": "9d5c1f0f-f85c-48f4-8a8e-4c77547116b3",
          "targetItemDisplayName": "Target report",
          "itemType": "Report"
        }
      },
      {
        "index": 4,
        "description": "DashboardDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "9046e4cc-8aea-4a7a-a3b5-1a78b1447d82",
          "sourceItemDisplayName": "Source dashboard",
          "itemType": "Dashboard"
        }
      }
    ]
  },
  "note": {
    "content": "Sample note"
  },
  "preDeploymentDiffInformation": {
    "newItemsCount": 3,
    "differentItemsCount": 1,
    "noDifferenceItemsCount": 1
  },
  "performedBy": {
    "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
    "type": "User"
  }
}

คำจำกัดความ

ชื่อ	คำอธิบาย
DeploymentExecutionPlan	แผนการดําเนินการปรับใช้
DeploymentExecutionStep	ขั้นตอนการดําเนินการปรับใช้
DeploymentPipelineOperationExtendedInfo	การดําเนินการไปป์ไลน์การปรับใช้ Fabric
DeploymentPipelineOperationNote	หมายเหตุที่อธิบายการปรับใช้
DeploymentPipelineOperationStatus	สถานะการดําเนินการของไปป์ไลน์การปรับใช้ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป
DeploymentPipelineOperationType	ชนิดการดําเนินการ คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป
DeploymentSourceAndTarget	รายการต้นทางและเป้าหมาย
ErrorRelatedResource	ออบเจ็กต์รายละเอียดทรัพยากรที่เกี่ยวข้องกับข้อผิดพลาด
ErrorResponse	การตอบสนองข้อผิดพลาด
ErrorResponseDetails	รายละเอียดการตอบสนองข้อผิดพลาด
GroupDetails	รายละเอียดเฉพาะของกลุ่ม ใช้ได้เมื่อชนิดหลัก `Group`
GroupType	ชนิดของกลุ่ม คุณสามารถเพิ่มชนิดกลุ่มเพิ่มเติมเมื่อเวลาผ่านไป
ItemPreDeploymentDiffState	ระบุว่ารายการเป็นรายการใหม่ แตกต่าง หรือเหมือนกับรายการในขั้นตอนเป้าหมายก่อนการปรับใช้หรือไม่ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป
ItemType	ชนิดของสินค้า คุณสามารถเพิ่มชนิดหน่วยข้อมูลเพิ่มเติมเมื่อเวลาผ่านไป
PreDeploymentDiffInformation	จํานวนรายการใหม่ ที่แตกต่างกัน และเหมือนกันที่มีการปรับใช้ก่อนการปรับใช้
Principal	แสดงข้อมูลประจําตัวหรือกลุ่ม Microsoft Entra
PrincipalType	ชนิดของรายการหลัก คุณสามารถเพิ่มชนิดหลักเพิ่มเติมเมื่อเวลาผ่านไป
ServicePrincipalDetails	รายละเอียดเฉพาะของบริการหลัก ใช้ได้เมื่อชนิดหลัก `ServicePrincipal`
ServicePrincipalProfileDetails	รายละเอียดโปรไฟล์โครงร่างสําคัญของบริการ ใช้ได้เมื่อชนิดหลัก `ServicePrincipalProfile`
UserDetails	รายละเอียดเฉพาะของผู้ใช้หลัก ใช้ได้เมื่อชนิดหลัก `User`

DeploymentExecutionPlan

วัตถุ

แผนการดําเนินการปรับใช้

ชื่อ	พิมพ์	คำอธิบาย
steps	DeploymentExecutionStep[]	คอลเลกชันของขั้นตอนแผนการดําเนินการ

DeploymentExecutionStep

วัตถุ

ขั้นตอนการดําเนินการปรับใช้

ชื่อ	พิมพ์	คำอธิบาย
description	string	คําอธิบายขั้นตอนการปรับใช้
error	ErrorResponse	รายละเอียดข้อผิดพลาด ใช้ได้เฉพาะเมื่อการดําเนินการไปป์ไลน์การปรับใช้ล้มเหลว
index	integer	ดัชนีขั้นตอน
preDeploymentDiffState	ItemPreDeploymentDiffState	เป็นรายการใหม่ แตกต่าง หรือเหมือนกับรายการในขั้นตอนเป้าหมายก่อนการปรับใช้
sourceAndTarget	DeploymentSourceAndTarget	รายการต้นทางและเป้าหมายของขั้นตอน
status	DeploymentPipelineOperationStatus	สถานะของการดําเนินการไปป์ไลน์การปรับใช้ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป

DeploymentPipelineOperationExtendedInfo

วัตถุ

การดําเนินการไปป์ไลน์การปรับใช้ Fabric

ชื่อ	พิมพ์	คำอธิบาย
executionEndTime	string (date-time)	วันที่และเวลาที่การดําเนินงานสิ้นสุด
executionPlan	DeploymentExecutionPlan	แผนการดําเนินการปรับใช้
executionStartTime	string (date-time)	วันที่และเวลาที่การดําเนินงานเริ่มต้น
id	string (uuid)	รหัสการดําเนินงาน
lastUpdatedTime	string (date-time)	วันที่และเวลาที่อัพเดตการดําเนินงานครั้งล่าสุด
note	DeploymentPipelineOperationNote	หมายเหตุที่แสดงคําอธิบายของการดําเนินการ
performedBy	Principal	หลักที่ทําการดําเนินการไปป์ไลน์การปรับใช้
preDeploymentDiffInformation	PreDeploymentDiffInformation	จํานวนของรายการที่ปรับใช้ในขั้นตอนต้นทางซึ่งเป็นรายการใหม่ เหมือนกัน หรือแตกต่างกับรายการในขั้นตอนเป้าหมายก่อนการปรับใช้
sourceStageId	string (uuid)	ID ของขั้นตอนไปป์ไลน์การปรับใช้ต้นทาง
status	DeploymentPipelineOperationStatus	สถานะการดําเนินการของไปป์ไลน์การปรับใช้ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป
targetStageId	string (uuid)	ID ของขั้นตอนไปป์ไลน์การปรับใช้งานเป้าหมาย
type	DeploymentPipelineOperationType	ชนิดการดําเนินการ คุณสามารถเพิ่มชนิดเพิ่มเติมเมื่อเวลาผ่านไป

DeploymentPipelineOperationNote

วัตถุ

หมายเหตุที่อธิบายการปรับใช้

ชื่อ	พิมพ์	คำอธิบาย
content	string	ข้อความที่อธิบายการปรับใช้
isTruncated	boolean	ระบุว่าเนื้อหาบันทึกย่อถูกตัดทอนหรือไม่ True - เนื้อหาหมายเหตุจะถูกตัดทอน เท็จ - เนื้อหาหมายเหตุจะไม่ถูกตัดทอน ค่าเริ่มต้นเป็นเท็จ

DeploymentPipelineOperationStatus

การแจงนับ

สถานะการดําเนินการของไปป์ไลน์การปรับใช้ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
NotStarted	ไม่ได้เริ่มต้นการดําเนินงาน
Running	การดําเนินการที่กําลังทํางานอยู่
Succeeded	การดําเนินการสําเร็จ
Failed	การดําเนินการล้มเหลว

DeploymentPipelineOperationType

การแจงนับ

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

ค่า	คำอธิบาย
Deploy	ปรับใช้เนื้อหาระหว่างขั้นตอน

DeploymentSourceAndTarget

วัตถุ

รายการต้นทางและเป้าหมาย

ชื่อ	พิมพ์	คำอธิบาย
itemType	ItemType	ชนิดของรายการ Fabric ที่จะถูกเขียนทับในขั้นตอนเป้าหมาย ใช้ได้เฉพาะเมื่อเขียนทับรายการ Fabric เท่านั้น
sourceItemDisplayName	string	ชื่อที่แสดงของรายการ Fabric ที่ปรับใช้จากขั้นตอนต้นทาง
sourceItemId	string (uuid)	ID ของรายการ Fabric ที่ถูกปรับใช้จากขั้นตอนต้นทาง
targetItemDisplayName	string	ชื่อของรายการ Fabric ที่จะถูกเขียนทับในขั้นตอนเป้าหมาย ใช้ได้เฉพาะเมื่อเขียนทับรายการ Fabric เท่านั้น
targetItemId	string (uuid)	ID ของรายการ Fabric ที่จะถูกเขียนทับในขั้นตอนเป้าหมาย ใช้ได้เฉพาะเมื่อเขียนทับรายการ Fabric เท่านั้น

ErrorRelatedResource

วัตถุ

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

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

ErrorResponse

วัตถุ

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

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

ErrorResponseDetails

วัตถุ

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

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

GroupDetails

วัตถุ

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

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

GroupType

การแจงนับ

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

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

ItemPreDeploymentDiffState

การแจงนับ

ระบุว่ารายการเป็นรายการใหม่ แตกต่าง หรือเหมือนกับรายการในขั้นตอนเป้าหมายก่อนการปรับใช้หรือไม่ อาจมีการเพิ่มสถานะเพิ่มเติมเมื่อเวลาผ่านไป

ค่า	คำอธิบาย
New	รายการที่ถูกปรับใช้ใหม่ที่ไม่มีอยู่ในขั้นตอนเป้าหมาย
Different	ก่อนการปรับใช้ รายการในขั้นตอนต้นทางไม่เหมือนกับรายการในขั้นตอนเป้าหมาย
NoDifference	ก่อนการปรับใช้ รายการในขั้นตอนต้นทางจะเหมือนกับรายการในขั้นตอนเป้าหมาย

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

PreDeploymentDiffInformation

วัตถุ

จํานวนรายการใหม่ ที่แตกต่างกัน และเหมือนกันที่มีการปรับใช้ก่อนการปรับใช้

ชื่อ	พิมพ์	คำอธิบาย
differentItemsCount	integer	จํานวนของรายการที่ปรับใช้ที่มีความแตกต่างระหว่างขั้นตอนต้นทางและเป้าหมายก่อนการปรับใช้
newItemsCount	integer	จํานวนของรายการใหม่ที่ปรับใช้กับขั้นตอนเป้าหมาย
noDifferenceItemsCount	integer	จํานวนของรายการที่ปรับใช้เหมือนกันในขั้นตอนต้นทางและเป้าหมายก่อนการปรับใช้

Principal

วัตถุ

แสดงข้อมูลประจําตัวหรือกลุ่ม Microsoft Entra

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

PrincipalType

การแจงนับ

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

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

ServicePrincipalDetails

วัตถุ

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

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

ServicePrincipalProfileDetails

วัตถุ

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

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

UserDetails

วัตถุ

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

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

แชร์ผ่าน

Deployment Pipelines - Get Deployment Pipeline Operation

การอนุญาต

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

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

อินเตอร์เฟซ

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

การตอบสนอง

ตัวอย่าง

Get a deployment pipeline operation example

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

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

คำจำกัดความ

DeploymentExecutionPlan

DeploymentExecutionStep

DeploymentPipelineOperationExtendedInfo

DeploymentPipelineOperationNote

DeploymentPipelineOperationStatus

DeploymentPipelineOperationType

DeploymentSourceAndTarget

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GroupDetails

GroupType

ItemPreDeploymentDiffState

ItemType

PreDeploymentDiffInformation

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails