Deployment Pipelines - List Deployment Pipeline Operations

Serviço:: Core

Versão da API:: v1

Retorna uma lista das operações de implantação up-to-20 mais recentes executadas no pipeline de implantação especificado.

Permissões

O chamador deve ter uma função de pipelines de implantação de administrador .

Escopos delegados necessários

Pipeline.Read.All ou Pipeline.ReadWrite.All

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade	Apoio
Utilizador	Yes
entidade de serviço e identidades gerenciadas	Yes

Interface

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
deploymentPipelineId	path	True	string (uuid)	A ID do pipeline de implantação.
continuationToken	query		string	Um token para recuperar a próxima página de resultados.

Respostas

Nome Tipo Description

200 OK

Nome	Tipo	Description
200 OK	DeploymentPipelineOperations	Solicitação concluída com êxito.
429 Too Many Requests	ErrorResponse	O limite de taxa de serviço foi excedido. O servidor retorna um `Retry-After` cabeçalho indicando, em segundos, quanto tempo o cliente deve aguardar antes de enviar solicitações adicionais. Cabeçalhos Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError – Ocorreu um erro

DeploymentPipelineOperations

Solicitação concluída com êxito.

429 Too Many Requests

ErrorResponse

O limite de taxa de serviço foi excedido. O servidor retorna um Retry-After cabeçalho indicando, em segundos, quanto tempo o cliente deve aguardar antes de enviar solicitações adicionais.

Cabeçalhos

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de erro comuns:

UnknownError – Ocorreu um erro

Exemplos

List deployment pipeline operations example

List deployment pipeline operations with continuation example

List deployment pipeline operations example

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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"
}

Definições

Nome	Description
DeploymentPipelineOperation	Uma operação de pipeline de implantação do Fabric.
DeploymentPipelineOperationNote	Uma nota que descreve a implantação.
DeploymentPipelineOperations	Uma coleção de operações de pipeline de implantação do Fabric.
DeploymentPipelineOperationStatus	O status da operação de pipeline de implantação. Status adicionais podem ser adicionados ao longo do tempo.
DeploymentPipelineOperationType	O tipo de operação. Tipos adicionais podem ser adicionados ao longo do tempo.
EntireTenantPrincipal	Representa uma entidade de segurança de locatário
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
GroupDetails	Detalhes específicos do grupo. Aplicável quando o tipo principal é `Group`.
GroupPrincipal	Representa um grupo de segurança.
GroupType	O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.
PreDeploymentDiffInformation	O número de itens novos, diferentes e idênticos implantados antes da implantação.
PrincipalType	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.
ServicePrincipalDetails	Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é `ServicePrincipal`.
ServicePrincipalPrincipal	Representa uma entidade de serviço do Microsoft Entra.
ServicePrincipalProfileDetails	Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Representa um perfil de entidade de serviço.
UserDetails	Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é `User`.
UserPrincipal	Representa uma entidade de usuário do Microsoft Entra.

DeploymentPipelineOperation

Objeto

Uma operação de pipeline de implantação do Fabric.

Nome	Tipo	Description
executionEndTime	string (date-time)	A data e a hora em que a operação terminou.
executionStartTime	string (date-time)	A data e a hora em que a operação foi iniciada.
id	string (uuid)	A ID da operação.
lastUpdatedTime	string (date-time)	A data e a hora em que a operação foi atualizada pela última vez.
note	DeploymentPipelineOperationNote	Uma nota que representa uma descrição da operação.
performedBy	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	A entidade de segurança que executou a operação de pipeline de implantação.
preDeploymentDiffInformation	PreDeploymentDiffInformation	O número de itens implantados no estágio de origem, que são novos, idênticos ou diferentes dos itens no estágio de destino, antes da implantação.
sourceStageId	string (uuid)	A ID de um estágio de pipeline de implantação de origem.
status	DeploymentPipelineOperationStatus	O status da operação do pipeline de implantação. Status adicionais podem ser adicionados ao longo do tempo.
targetStageId	string (uuid)	A ID de um estágio de pipeline de implantação de destino.
type	DeploymentPipelineOperationType	O tipo de operação. Tipos adicionais podem ser adicionados ao longo do tempo.

DeploymentPipelineOperationNote

Objeto

Uma nota que descreve a implantação.

Nome	Tipo	Description
content	string	Texto que descreve a implantação.
isTruncated	boolean	Indica se o conteúdo da anotação está truncado. True - o conteúdo da anotação é truncado, False - o conteúdo da anotação não é truncado. O valor padrão é falso.

DeploymentPipelineOperations

Objeto

Uma coleção de operações de pipeline de implantação do Fabric.

Nome	Tipo	Description
continuationToken	string	O token do próximo lote do conjunto de resultados. Se não houver mais registros, ele será removido da resposta.
continuationUri	string	O URI do próximo lote do conjunto de resultados. Se não houver mais registros, ele será removido da resposta.
value	DeploymentPipelineOperation[]	A coleção de operações de pipeline de implantação.

DeploymentPipelineOperationStatus

Enumeração

O status da operação de pipeline de implantação. Status adicionais podem ser adicionados ao longo do tempo.

Valor	Description
NotStarted	A operação de pipeline de implantação não foi iniciada.
Running	A operação de pipeline de implantação está em execução.
Succeeded	A operação de pipeline de implantação foi bem-sucedida.
Failed	Falha na operação de pipeline de implantação.

DeploymentPipelineOperationType

Enumeração

O tipo de operação. Tipos adicionais podem ser adicionados ao longo do tempo.

Valor	Description
Deploy	Implantar conteúdo entre estágios.

EntireTenantPrincipal

Objeto

Representa uma entidade de segurança de locatário

Nome	Tipo	Description
displayName	string	O nome de exibição da entidade de segurança.
id	string (uuid)	A ID da entidade de segurança.
type	string: EntireTenant	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

Nome	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo do recurso envolvido no erro.

ErrorResponse

Objeto

A resposta de erro.

Nome	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
isRetriable	boolean	Quando true, a solicitação pode ser repetida. Use o `Retry-After` cabeçalho de resposta para determinar o atraso, se disponível.
message	string	Uma representação legível humana do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionado ao erro.
requestId	string (uuid)	ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

Nome	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível humana do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionado ao erro.

GroupDetails

Objeto

Detalhes específicos do grupo. Aplicável quando o tipo principal é Group.

Nome	Tipo	Description
groupType	GroupType	O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.

GroupPrincipal

Objeto

Representa um grupo de segurança.

Nome	Tipo	Description
displayName	string	O nome de exibição da entidade de segurança.
groupDetails	GroupDetails	Detalhes específicos do grupo. Aplicável quando o tipo principal é `Group`.
id	string (uuid)	A ID da entidade de segurança.
type	string: Group	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

GroupType

Enumeração

O tipo do grupo. Tipos de grupo adicionais podem ser adicionados ao longo do tempo.

Valor	Description
Unknown	O tipo de grupo principal é desconhecido.
SecurityGroup	A entidade de segurança é um grupo de segurança.
DistributionList	Principal é uma lista de distribuição.

PreDeploymentDiffInformation

Objeto

O número de itens novos, diferentes e idênticos implantados antes da implantação.

Nome	Tipo	Description
differentItemsCount	integer	O número de itens implantados com diferenças entre os estágios de origem e de destino, antes da implantação.
newItemsCount	integer	O número de novos itens implantados no estágio de destino.
noDifferenceItemsCount	integer	O número de itens implantados idênticos nos estágios de origem e destino, antes da implantação.

PrincipalType

Enumeração

O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

Valor	Description
User	Principal é uma entidade de usuário do Microsoft Entra.
ServicePrincipal	A entidade de segurança é uma entidade de serviço do Microsoft Entra.
Group	A entidade de segurança é um grupo de segurança.
ServicePrincipalProfile	Principal é um perfil de entidade de serviço.
EntireTenant	A entidade de segurança representa todos os usuários do locatário.

ServicePrincipalDetails

Objeto

Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipal.

Nome	Tipo	Description
aadAppId	string (uuid)	O Microsoft Entra AppId da entidade de serviço.

ServicePrincipalPrincipal

Objeto

Representa uma entidade de serviço do Microsoft Entra.

Nome	Tipo	Description
displayName	string	O nome de exibição da entidade de segurança.
id	string (uuid)	A ID da entidade de segurança.
servicePrincipalDetails	ServicePrincipalDetails	Detalhes específicos da entidade de serviço. Aplicável quando o tipo principal é `ServicePrincipal`.
type	string: ServicePrincipal	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

ServicePrincipalProfileDetails

Objeto

Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é ServicePrincipalProfile.

Nome	Tipo	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	A entidade pai do perfil da entidade de serviço.

ServicePrincipalProfilePrincipal

Objeto

Representa um perfil de entidade de serviço.

Nome	Tipo	Description
displayName	string	O nome de exibição da entidade de segurança.
id	string (uuid)	A ID da entidade de segurança.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detalhes do perfil da entidade de serviço. Aplicável quando o tipo principal é `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.

UserDetails

Objeto

Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é User.

Nome	Tipo	Description
userPrincipalName	string	O nome da entidade de segurança do usuário.

UserPrincipal

Objeto

Representa uma entidade de usuário do Microsoft Entra.

Nome	Tipo	Description
displayName	string	O nome de exibição da entidade de segurança.
id	string (uuid)	A ID da entidade de segurança.
type	string: User	O tipo da entidade de segurança. Tipos de entidades de segurança adicionais podem ser adicionados ao longo do tempo.
userDetails	UserDetails	Detalhes específicos da entidade de usuário. Aplicável quando o tipo principal é `User`.