Deployment Pipelines - Assign Workspace To Stage

服务:

Core

API 版本:

v1

将指定的工作区分配给指定的部署管道阶段。
如果存在活动部署作，此作将失败。

权限

调用方必须具有 管理员 部署管道角色。 调用方必须具有 管理员 工作区角色。

所需的委派范围

Pipeline.ReadWrite.All 和 Workspace.ReadWrite.All

局限性

• 指定的部署管道阶段不得分配给任何其他工作区。
• 只有工作区管理员可以将其分配到部署管道阶段。
• 指定的工作区未分配给任何其他部署管道阶段。

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

身份	支持
用户	是的
服务主体 和 托管标识	是的

接口

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/stages/{stageId}/assignWorkspace

URI 参数

名称	在	必需	类型	说明
deploymentPipelineId	path	True	string (uuid)	部署管道 ID。
stageId	path	True	string (uuid)	部署管道阶段 ID。

请求正文

名称	必需	类型	说明
workspaceId	True	string (uuid)	工作区 ID。

响应

名称	类型	说明
200 OK		请求成功完成。
Other Status Codes	ErrorResponse	常见错误代码： UnknownError - 发生错误

示例

Assign a workspace to a deployment pipeline example

示例请求

HTTP

POST https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/stages/db1577e0-0132-4d6d-92b9-952c359988f2/assignWorkspace

{
  "workspaceId": "4de5bcc4-2c88-4efe-b827-4ee7b289b496"
}

示例响应

状态代码:

200

定义

名称	说明
DeploymentPipelineAssignWorkspaceRequest	向部署管道阶段分配工作区的请求。
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。

DeploymentPipelineAssignWorkspaceRequest

Object

向部署管道阶段分配工作区的请求。

名称	类型	说明
workspaceId	string (uuid)	工作区 ID。

ErrorRelatedResource

Object

与错误相关的资源详细信息对象。

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

Object

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string	与错误关联的请求的 ID。

ErrorResponseDetails

Object

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。