Deployment Pipelines - List Deployment Pipeline Operations

Servicio:: Core

Versión de la API:: v1

Devuelve una lista de las operaciones de implementación de up-to-20 más recientes realizadas en la canalización de implementación especificada.

Permisos

El autor de la llamada debe tener un rol de canalizaciones de implementación de administrador .

Ámbitos delegados necesarios

Pipeline.Read.All o 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

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

Con parámetros opcionales:

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations?continuationToken={continuationToken}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
deploymentPipelineId	path	True	string (uuid)	Identificador de canalización de implementación.
continuationToken	query		string	Token para recuperar la siguiente página de resultados.

Respuestas

Nombre Tipo Description

200 OK

Nombre	Tipo	Description
200 OK	DeploymentPipelineOperations	Solicitud completada correctamente.
429 Too Many Requests	ErrorResponse	Se superó el límite de frecuencia de servicio. El servidor devuelve un `Retry-After` encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales. Encabezados Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: UnknownError: se produjo un error

DeploymentPipelineOperations

Solicitud completada correctamente.

429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de error comunes:

UnknownError: se produjo un error

Ejemplos

List deployment pipeline operations example

List deployment pipeline operations with continuation example

List deployment pipeline operations example

Solicitud de ejemplo

HTTP

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "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",
      "note": {
        "content": "Sample note"
      },
      "preDeploymentDiffInformation": {
        "newItemsCount": 0,
        "differentItemsCount": 0,
        "noDifferenceItemsCount": 1
      },
      "performedBy": {
        "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
        "type": "User"
      }
    },
    {
      "id": "7e113010-3264-41e4-93c1-1dfb34a93d06",
      "type": "Deploy",
      "status": "Failed",
      "lastUpdatedTime": "2020-12-14T09:26:43.153",
      "executionStartTime": "2020-12-14T09:25:43.153Z",
      "executionEndTime": "2020-12-13T09:26:43.153Z",
      "sourceStageId": "2e6f0272-e809-410a-be63-50e1d97ba75a",
      "targetStageId": "d2056166-041c-4a56-8d37-ea90038bc0d6",
      "note": {
        "content": "Lorem ipsum odor amet, consectetuer adipiscing elit. Himenaeos litora volutpat sem eget ipsum sollicitudin ad porta ligula tristique sapien suscipit magnis pulvinar placerat in vulputate aliquam mauris aptent velit phasellus netus fringilla ad taciti in himenaeos eu vitae feugiat et auctor class maximus urna integer erat amet efficitur ex tellus conubia lorem nam viverra cras magnis potenti pharetra natoque suscipit scelerisque eros adipiscing mollis sagittis habitasse ligula nullam rhoncus at scelerisque justo dolor pretium libero urna massa tristique diam viverra aenean mauris malesuada mus sed ultrices consectetur tristique pretium imperdiet vulputate ligula senectus pretium aenean inceptos id cras magna ut nisl etiam eget magna nibh feugiat duis imperdiet ut ornare arcu primis curae taciti purus quisque turpis lacus auctor ligula tristique placerat consectetur mus vitae penatibus varius proin ligula viverra diam neque at tortor porttitor urna ullamcorper ut nec lobortis porta urna egestas eu cursus ante ",
        "isTruncated": true
      },
      "preDeploymentDiffInformation": {
        "newItemsCount": 1,
        "differentItemsCount": 0,
        "noDifferenceItemsCount": 0
      },
      "performedBy": {
        "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
        "type": "User"
      }
    }
  ]
}

List deployment pipeline operations with continuation example

Solicitud de ejemplo

HTTP

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "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",
      "note": {
        "content": "Sample note"
      },
      "preDeploymentDiffInformation": {
        "newItemsCount": 0,
        "differentItemsCount": 0,
        "noDifferenceItemsCount": 1
      },
      "performedBy": {
        "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
        "type": "User"
      }
    },
    {
      "id": "7e113010-3264-41e4-93c1-1dfb34a93d06",
      "type": "Deploy",
      "status": "Failed",
      "lastUpdatedTime": "2020-12-14T09:26:43.153",
      "executionStartTime": "2020-12-14T09:25:43.153Z",
      "executionEndTime": "2020-12-13T09:26:43.153Z",
      "sourceStageId": "2e6f0272-e809-410a-be63-50e1d97ba75a",
      "targetStageId": "d2056166-041c-4a56-8d37-ea90038bc0d6",
      "note": {
        "content": "Lorem ipsum odor amet, consectetuer adipiscing elit. Himenaeos litora volutpat sem eget ipsum sollicitudin ad porta ligula tristique sapien suscipit magnis pulvinar placerat in vulputate aliquam mauris aptent velit phasellus netus fringilla ad taciti in himenaeos eu vitae feugiat et auctor class maximus urna integer erat amet efficitur ex tellus conubia lorem nam viverra cras magnis potenti pharetra natoque suscipit scelerisque eros adipiscing mollis sagittis habitasse ligula nullam rhoncus at scelerisque justo dolor pretium libero urna massa tristique diam viverra aenean mauris malesuada mus sed ultrices consectetur tristique pretium imperdiet vulputate ligula senectus pretium aenean inceptos id cras magna ut nisl etiam eget magna nibh feugiat duis imperdiet ut ornare arcu primis curae taciti purus quisque turpis lacus auctor ligula tristique placerat consectetur mus vitae penatibus varius proin ligula viverra diam neque at tortor porttitor urna ullamcorper ut nec lobortis porta urna egestas eu cursus ante ",
        "isTruncated": true
      },
      "preDeploymentDiffInformation": {
        "newItemsCount": 1,
        "differentItemsCount": 0,
        "noDifferenceItemsCount": 0
      },
      "performedBy": {
        "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
        "type": "User"
      }
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Definiciones

Nombre	Description
DeploymentPipelineOperation	Una operación de canalización de implementación de Fabric.
DeploymentPipelineOperationNote	Nota que describe la implementación.
DeploymentPipelineOperations	Colección de operaciones de canalización de implementación de Fabric.
DeploymentPipelineOperationStatus	Estado de la operación de canalización de implementación. Se pueden agregar estados adicionales a lo largo del tiempo.
DeploymentPipelineOperationType	Tipo de operación. Se pueden agregar tipos adicionales a lo largo del tiempo.
EntireTenantPrincipal	Representa una entidad de seguridad de inquilino
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
GroupDetails	Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es `Group`.
GroupPrincipal	Representa un grupo de seguridad.
GroupType	Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.
PreDeploymentDiffInformation	Número de elementos nuevos, diferentes e idénticos implementados antes de la implementación.
PrincipalType	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.
ServicePrincipalDetails	Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es `ServicePrincipal`.
ServicePrincipalPrincipal	Representa una entidad de servicio de Microsoft Entra.
ServicePrincipalProfileDetails	Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Representa un perfil de entidad de servicio.
UserDetails	Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es `User`.
UserPrincipal	Representa una entidad de seguridad de usuario de Microsoft Entra.

DeploymentPipelineOperation

Objeto

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

Nombre	Tipo	Description
executionEndTime	string (date-time)	Fecha y hora en que finalizó la operación.
executionStartTime	string (date-time)	Fecha y hora en que se inició la operación.
id	string (uuid)	Identificador de la operación.
lastUpdatedTime	string (date-time)	Fecha y hora en que se actualizó la operación por última vez.
note	DeploymentPipelineOperationNote	Nota que representa una descripción de la operación.
performedBy	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Entidad de seguridad que realizó la operación de canalización de implementación.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Número de elementos implementados en la fase de origen, que son nuevos, idénticos o diferentes a los elementos de la fase de destino, antes de la implementación.
sourceStageId	string (uuid)	Identificador de una fase de canalización de implementación de origen.
status	DeploymentPipelineOperationStatus	Estado de la operación de canalización de implementación. Se pueden agregar estados adicionales a lo largo del tiempo.
targetStageId	string (uuid)	Identificador de una fase de canalización de implementación de destino.
type	DeploymentPipelineOperationType	Tipo de operación. Se pueden agregar tipos adicionales a lo largo del tiempo.

DeploymentPipelineOperationNote

Objeto

Nota que describe la implementación.

Nombre	Tipo	Description
content	string	Texto que describe la implementación.
isTruncated	boolean	Indica si el contenido de la nota está truncado. True: el contenido de la nota se trunca, False: el contenido de la nota no se trunca. El valor predeterminado es false.

DeploymentPipelineOperations

Objeto

Colección de operaciones de canalización de implementación de Fabric.

Nombre	Tipo	Description
continuationToken	string	Token del siguiente lote del conjunto de resultados. Si no hay más registros, se quita de la respuesta.
continuationUri	string	Identificador URI del siguiente lote del conjunto de resultados. Si no hay más registros, se quita de la respuesta.
value	DeploymentPipelineOperation[]	Colección de operaciones de canalización de implementación.

DeploymentPipelineOperationStatus

Enumeración

Estado de la operación de canalización de implementación. Se pueden agregar estados adicionales a lo largo del tiempo.

Valor	Description
NotStarted	La operación de canalización de implementación no se inició.
Running	La operación de canalización de implementación se está ejecutando.
Succeeded	La operación de canalización de implementación se realizó correctamente.
Failed	Error en la operación de canalización de implementación.

DeploymentPipelineOperationType

Enumeración

Tipo de operación. Se pueden agregar tipos adicionales a lo largo del tiempo.

Valor	Description
Deploy	Implementar contenido entre fases.

EntireTenantPrincipal

Objeto

Representa una entidad de seguridad de inquilino

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad.
id	string (uuid)	Identificador de la entidad de seguridad.
type	string: EntireTenant	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

ErrorRelatedResource

Objeto

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

Objeto

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 (uuid)	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

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.

GroupDetails

Objeto

Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es Group.

Nombre	Tipo	Description
groupType	GroupType	Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.

GroupPrincipal

Objeto

Representa un grupo de seguridad.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad.
groupDetails	GroupDetails	Detalles específicos del grupo. Aplicable cuando el tipo de entidad de seguridad es `Group`.
id	string (uuid)	Identificador de la entidad de seguridad.
type	string: Group	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

GroupType

Enumeración

Tipo del grupo. Se pueden agregar tipos de grupo adicionales a lo largo del tiempo.

Valor	Description
Unknown	El tipo de grupo principal es desconocido.
SecurityGroup	La entidad de seguridad es un grupo de seguridad.
DistributionList	La entidad de seguridad es una lista de distribución.

PreDeploymentDiffInformation

Objeto

Número de elementos nuevos, diferentes e idénticos implementados antes de la implementación.

Nombre	Tipo	Description
differentItemsCount	integer	Número de elementos implementados con diferencias entre las fases de origen y destino, antes de la implementación.
newItemsCount	integer	Número de elementos nuevos implementados en la fase de destino.
noDifferenceItemsCount	integer	Número de elementos implementados idénticos en las fases de origen y destino, antes de la implementación.

PrincipalType

Enumeración

Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

Valor	Description
User	La entidad de seguridad es una entidad de seguridad de usuario de Microsoft Entra.
ServicePrincipal	La entidad de seguridad es una entidad de servicio de Microsoft Entra.
Group	La entidad de seguridad es un grupo de seguridad.
ServicePrincipalProfile	La entidad de servicio es un perfil de entidad de servicio.
EntireTenant	La entidad de seguridad representa todos los usuarios de inquilinos.

ServicePrincipalDetails

Objeto

Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipal.

Nombre	Tipo	Description
aadAppId	string (uuid)	Microsoft Entra AppId de la entidad de servicio.

ServicePrincipalPrincipal

Objeto

Representa una entidad de servicio de Microsoft Entra.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad.
id	string (uuid)	Identificador de la entidad de seguridad.
servicePrincipalDetails	ServicePrincipalDetails	Detalles específicos de la entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es `ServicePrincipal`.
type	string: ServicePrincipal	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

ServicePrincipalProfileDetails

Objeto

Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es ServicePrincipalProfile.

Nombre	Tipo	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	La entidad de seguridad principal del perfil de la entidad de servicio.

ServicePrincipalProfilePrincipal

Objeto

Representa un perfil de entidad de servicio.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad.
id	string (uuid)	Identificador de la entidad de seguridad.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detalles del perfil de entidad de servicio. Aplicable cuando el tipo de entidad de seguridad es `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.

UserDetails

Objeto

Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es User.

Nombre	Tipo	Description
userPrincipalName	string	El nombre principal del usuario.

UserPrincipal

Objeto

Representa una entidad de seguridad de usuario de Microsoft Entra.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar de la entidad de seguridad.
id	string (uuid)	Identificador de la entidad de seguridad.
type	string: User	Tipo de la entidad de seguridad. Se pueden agregar tipos de entidad de seguridad adicionales a lo largo del tiempo.
userDetails	UserDetails	Detalles específicos de la entidad de seguridad de usuario. Aplicable cuando el tipo de entidad de seguridad es `User`.