Compartir a través de

Deployment Pipelines - Create Deployment Pipeline

Servicio:
Core
Versión de la API:
v1

Crea una nueva canalización de implementación.

Permisos

El administrador de Fabric debe tener permiso concedido a las entidades de servicio. Para obtener más información, consulte: Las entidades de servicio pueden crear áreas de trabajo, conexiones e canalizaciones de implementación.

Ámbitos delegados necesarios

Pipeline.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad Apoyo
Usuario Sí
de entidad de servicio y identidades administradas Sí

Interfaz

POST https://api.fabric.microsoft.com/v1/deploymentPipelines

Cuerpo de la solicitud

Nombre Requerido Tipo Description
displayName True

string

maxLength: 256

Nombre para mostrar de la canalización de implementación.
El nombre para mostrar no puede contener más de 256 caracteres.
stages True

DeploymentPipelineStageRequest[]

Colección de fases de canalización de implementación.
description

string

maxLength: 1024

Descripción de la canalización de implementación.
La descripción no puede contener más de 1024 caracteres.

Respuestas

Nombre Tipo Description
201 Created

DeploymentPipelineExtendedInfo

Se ha creado correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • UnknownError: se produjo un error

Ejemplos

Create a deployment pipeline example

Solicitud de ejemplo

POST https://api.fabric.microsoft.com/v1/deploymentPipelines

{
  "displayName": "My Deployment Pipeline Name",
  "description": "My deployment pipeline description",
  "stages": [
    {
      "displayName": "Development",
      "description": "Development stage description",
      "isPublic": false
    },
    {
      "displayName": "Test",
      "description": "Test stage description",
      "isPublic": false
    },
    {
      "displayName": "Production",
      "description": "Production stage description",
      "isPublic": true
    }
  ]
}

Respuesta de muestra

status code:
201 
{
  "id": "a5ded933-57b7-41f4-b072-ed4c1f9d5824",
  "displayName": "My Deployment Pipeline Name",
  "description": "My deployment pipeline description",
  "stages": [
    {
      "id": "2e6f0272-e809-410a-be63-50e1d97ba75a",
      "order": 0,
      "displayName": "Development",
      "description": "Development stage description",
      "isPublic": false
    },
    {
      "id": "d2056166-041c-4a56-8d37-ea90038bc0d6",
      "order": 1,
      "displayName": "Test",
      "description": "Test stage description",
      "isPublic": false
    },
    {
      "id": "4c3eb03b-fbbb-4605-9b1a-6fba1003679e",
      "order": 2,
      "displayName": "Production",
      "description": "Production stage description",
      "isPublic": true
    }
  ]
}

Definiciones

Nombre Description
CreateDeploymentPipelineRequest

Solicitud para crear una nueva canalización de implementación.
DeploymentPipelineExtendedInfo

Una canalización de implementación de Fabric.
DeploymentPipelineStage

Una fase de canalización de implementación de Fabric.
DeploymentPipelineStageRequest

Una fase de canalización de implementación de Fabric.
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.

CreateDeploymentPipelineRequest

Object

Solicitud para crear una nueva canalización de implementación.

Nombre Tipo Description
description

string

maxLength: 1024

Descripción de la canalización de implementación.
La descripción no puede contener más de 1024 caracteres.
displayName

string

maxLength: 256

Nombre para mostrar de la canalización de implementación.
El nombre para mostrar no puede contener más de 256 caracteres.
stages

DeploymentPipelineStageRequest[]

Colección de fases de canalización de implementación.

DeploymentPipelineExtendedInfo

Object

Una canalización de implementación de Fabric.

Nombre Tipo Description
description

string

Descripción de la canalización de implementación.
displayName

string

Nombre para mostrar de la canalización de implementación.
id

string (uuid)

Identificador de canalización de implementación.
stages

DeploymentPipelineStage[]

Colección de fases de canalización de implementación.

DeploymentPipelineStage

Object

Una fase de canalización de implementación de Fabric.

Nombre Tipo Description
description

string

Descripción de la fase de canalización de implementación.
displayName

string

Nombre para mostrar de la fase de canalización de implementación.
id

string (uuid)

Identificador de la fase de canalización de implementación.
isPublic

boolean

Indica si la fase de canalización de implementación es pública. True: la fase es pública, False: la fase no es pública.
order

integer

El orden de fase, empezando por cero.
workspaceId

string (uuid)

Identificador del área de trabajo asignada. Solo es aplicable cuando hay un área de trabajo asignada.
workspaceName

string

Nombre del área de trabajo asignada. Solo es aplicable cuando hay un área de trabajo asignada y el usuario tiene acceso al área de trabajo.

DeploymentPipelineStageRequest

Object

Una fase de canalización de implementación de Fabric.

Nombre Tipo Description
description

string

maxLength: 1024

Descripción de la fase de canalización de implementación.
La descripción no puede contener más de 1024 caracteres.
displayName

string

maxLength: 256

Nombre para mostrar de la fase de canalización de implementación.
El nombre para mostrar no puede contener más de 256 caracteres.
isPublic

boolean

Si la fase de canalización de implementación es pública.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.