แชร์ผ่าน

Deployment Pipelines - Add Deployment Pipeline Role Assignment

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

เพิ่มการกําหนดบทบาทไปป์ไลน์การปรับใช้

การอนุญาต

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

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

Pipeline.ReadWrite.All

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

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

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

อินเตอร์เฟซ

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/roleAssignments

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

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

string (uuid)

ID ไปป์ไลน์การปรับใช้

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

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

Principal

ครูใหญ่
role True

DeploymentPipelineRole

บทบาทไปป์ไลน์การปรับใช้ขององค์ประกอบหลักของ

การตอบสนอง

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

DeploymentPipelineRoleAssignment

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

ErrorResponse

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

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

ตัวอย่าง

Add a group role assignment to a deployment pipeline example
Add a service principal role assignment to a deployment pipeline example
Add a user role assignment to a deployment pipeline example

Add a group role assignment to a deployment pipeline example

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

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/roleAssignments

{
  "principal": {
    "id": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
    "type": "Group"
  },
  "role": "Admin"
}

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

รหัสสถานะ:
200 
{
  "id": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
  "principal": {
    "id": "154aef10-47b8-48c4-ab97-f0bf9d5f8fcf",
    "type": "Group"
  },
  "role": "Admin"
}

Add a service principal role assignment to a deployment pipeline example

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

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/roleAssignments

{
  "principal": {
    "id": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
    "type": "ServicePrincipal"
  },
  "role": "Admin"
}

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

รหัสสถานะ:
200 
{
  "id": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
  "principal": {
    "id": "a35d842b-90d5-59a1-c56a-5f8fcff0bf9d",
    "type": "ServicePrincipal"
  },
  "role": "Admin"
}

Add a user role assignment to a deployment pipeline example

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

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/8ce96c50-85a0-4db3-85c6-7ccc3ed46523/roleAssignments

{
  "principal": {
    "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
    "type": "User"
  },
  "role": "Admin"
}

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

รหัสสถานะ:
200 
{
  "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
  "principal": {
    "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
    "type": "User"
  },
  "role": "Admin"
}

คำจำกัดความ

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

เพิ่มส่วนข้อมูลคําขอการกําหนดบทบาทไปป์ไลน์การปรับใช้
DeploymentPipelineRole

บทบาทไปป์ไลน์การปรับใช้ อาจมีการเพิ่มบทบาทไปป์ไลน์การปรับใช้เพิ่มเติมเมื่อเวลาผ่านไป
DeploymentPipelineRoleAssignment

การกําหนดบทบาทหลัก Fabric สําหรับไปป์ไลน์การปรับใช้
ErrorRelatedResource

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

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

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

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

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

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

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

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

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

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

AddDeploymentPipelineRoleAssignmentRequest

ออบเจ็กต์

เพิ่มส่วนข้อมูลคําขอการกําหนดบทบาทไปป์ไลน์การปรับใช้

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

Principal

ครูใหญ่
role

DeploymentPipelineRole

บทบาทไปป์ไลน์การปรับใช้ขององค์ประกอบหลักของ

DeploymentPipelineRole

การแจงนับ

บทบาทไปป์ไลน์การปรับใช้ อาจมีการเพิ่มบทบาทไปป์ไลน์การปรับใช้เพิ่มเติมเมื่อเวลาผ่านไป

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

เปิดใช้งานการเข้าถึงระดับผู้ดูแลไปยังไปป์ไลน์การปรับใช้

DeploymentPipelineRoleAssignment

ออบเจ็กต์

การกําหนดบทบาทหลัก Fabric สําหรับไปป์ไลน์การปรับใช้

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

string (uuid)

รหัสการกําหนดบทบาทไปป์ไลน์การปรับใช้
principal

Principal

ครูใหญ่
role

DeploymentPipelineRole

บทบาทไปป์ไลน์การปรับใช้ขององค์ประกอบหลักของ

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

หลักคือรายการการแจกจ่าย

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

ชื่อหลักของผู้ใช้