Deployment Pipelines - List Deployment Pipeline Operations

Service:: Core

Version d'API:: v1

Retourne la liste des opérations de déploiement up-to-20 les plus récentes effectuées sur le pipeline de déploiement spécifié.

Autorisations

L’appelant doit avoir un rôle de pipelines de déploiement d’administrateur .

Étendues déléguées requises

Pipeline.Read.All ou Pipeline.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Soutien
Utilisateur	Oui
principal de service et identités managées	Oui

Interface

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

Avec des paramètres facultatifs:

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
deploymentPipelineId	path	True	string (uuid)	ID du pipeline de déploiement.
continuationToken	query		string	Jeton permettant de récupérer la page suivante des résultats.

Réponses

Nom Type Description

200 OK

Nom	Type	Description
200 OK	DeploymentPipelineOperations	La demande s’est terminée avec succès.
429 Too Many Requests	ErrorResponse	La limite de débit de service a été dépassée. Le serveur retourne un `Retry-After` en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires. En-têtes Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : UnknownError - Une erreur s’est produite

DeploymentPipelineOperations

La demande s’est terminée avec succès.

429 Too Many Requests

ErrorResponse

La limite de débit de service a été dépassée. Le serveur retourne un Retry-After en-tête indiquant, en secondes, combien de temps le client doit attendre avant d’envoyer des demandes supplémentaires.

En-têtes

Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

UnknownError - Une erreur s’est produite

Exemples

List deployment pipeline operations example

List deployment pipeline operations with continuation example

List deployment pipeline operations example

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:: 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"
}

Définitions

Nom	Description
DeploymentPipelineOperation	Opération de pipeline de déploiement Fabric.
DeploymentPipelineOperationNote	Remarque décrivant le déploiement.
DeploymentPipelineOperations	Collection d’opérations de pipeline de déploiement Fabric.
DeploymentPipelineOperationStatus	État de l’opération de pipeline de déploiement. Des états supplémentaires peuvent être ajoutés au fil du temps.
DeploymentPipelineOperationType	Type d’opération. Des types supplémentaires peuvent être ajoutés au fil du temps.
EntireTenantPrincipal	Représente un principal de locataire
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
GroupDetails	Détails spécifiques du groupe. Applicable lorsque le type principal est `Group`.
GroupPrincipal	Représente un groupe de sécurité.
GroupType	Type du groupe. Des types de groupes supplémentaires peuvent être ajoutés au fil du temps.
PreDeploymentDiffInformation	Nombre d’éléments nouveaux, différents et identiques déployés avant le déploiement.
PrincipalType	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.
ServicePrincipalDetails	Détails spécifiques au principal de service. Applicable lorsque le type principal est `ServicePrincipal`.
ServicePrincipalPrincipal	Représente un principal de service Microsoft Entra.
ServicePrincipalProfileDetails	Détails du profil du principal de service. Applicable lorsque le type principal est `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Représente un profil de principal de service.
UserDetails	Détails spécifiques au principal de l’utilisateur. Applicable lorsque le type principal est `User`.
UserPrincipal	Représente un principal d’utilisateur Microsoft Entra.

DeploymentPipelineOperation

Objet

Opération de pipeline de déploiement Fabric.

Nom	Type	Description
executionEndTime	string (date-time)	Date et heure de fin de l’opération.
executionStartTime	string (date-time)	Date et heure de démarrage de l’opération.
id	string (uuid)	ID d’opération.
lastUpdatedTime	string (date-time)	Date et heure de la dernière mise à jour de l’opération.
note	DeploymentPipelineOperationNote	Note représentant une description de l’opération.
performedBy	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Principal qui a effectué l’opération de pipeline de déploiement.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Nombre d’éléments déployés dans l’étape source, qui sont nouveaux, identiques ou différents des éléments de l’étape cible, avant le déploiement.
sourceStageId	string (uuid)	ID d’une phase de pipeline de déploiement source.
status	DeploymentPipelineOperationStatus	État de l’opération de pipeline de déploiement. Des états supplémentaires peuvent être ajoutés au fil du temps.
targetStageId	string (uuid)	ID d’une phase de pipeline de déploiement cible.
type	DeploymentPipelineOperationType	Type d’opération. Des types supplémentaires peuvent être ajoutés au fil du temps.

DeploymentPipelineOperationNote

Objet

Remarque décrivant le déploiement.

Nom	Type	Description
content	string	Texte décrivant le déploiement.
isTruncated	boolean	Indique si le contenu de la note est tronqué. True : le contenu de la note est tronqué, False : le contenu de la note n’est pas tronqué. La valeur par défaut est False.

DeploymentPipelineOperations

Objet

Collection d’opérations de pipeline de déploiement Fabric.

Nom	Type	Description
continuationToken	string	Jeton du lot du jeu de résultats suivant. S’il n’y a plus d’enregistrements, il est supprimé de la réponse.
continuationUri	string	URI du lot du jeu de résultats suivant. S’il n’y a plus d’enregistrements, il est supprimé de la réponse.
value	DeploymentPipelineOperation[]	Collection d’opérations de pipeline de déploiement.

DeploymentPipelineOperationStatus

Énumération

État de l’opération de pipeline de déploiement. Des états supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
NotStarted	L’opération de pipeline de déploiement n’a pas démarré.
Running	L’opération de pipeline de déploiement est en cours d’exécution.
Succeeded	L’opération de pipeline de déploiement a réussi.
Failed	L’opération de pipeline de déploiement a échoué.

DeploymentPipelineOperationType

Énumération

Type d’opération. Des types supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
Deploy	Déployez du contenu entre les phases.

EntireTenantPrincipal

Objet

Représente un principal de locataire

Nom	Type	Description
displayName	string	Nom complet du principal.
id	string (uuid)	ID du principal.
type	string: EntireTenant	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.

ErrorRelatedResource

Objet

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
isRetriable	boolean	Lorsque la valeur est true, la requête peut être retentée. Utilisez l’en-tête `Retry-After` de réponse pour déterminer le délai, le cas échéant.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string (uuid)	ID de la demande associée à l’erreur.

ErrorResponseDetails

Objet

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

GroupDetails

Objet

Détails spécifiques du groupe. Applicable lorsque le type principal est Group.

Nom	Type	Description
groupType	GroupType	Type du groupe. Des types de groupes supplémentaires peuvent être ajoutés au fil du temps.

GroupPrincipal

Objet

Représente un groupe de sécurité.

Nom	Type	Description
displayName	string	Nom complet du principal.
groupDetails	GroupDetails	Détails spécifiques du groupe. Applicable lorsque le type principal est `Group`.
id	string (uuid)	ID du principal.
type	string: Group	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.

GroupType

Énumération

Type du groupe. Des types de groupes supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
Unknown	Le type de groupe principal est inconnu.
SecurityGroup	Principal est un groupe de sécurité.
DistributionList	Principal est une liste de distribution.

PreDeploymentDiffInformation

Objet

Nombre d’éléments nouveaux, différents et identiques déployés avant le déploiement.

Nom	Type	Description
differentItemsCount	integer	Nombre d’éléments déployés présentant des différences entre les phases source et cible, avant le déploiement.
newItemsCount	integer	Nombre de nouveaux éléments déployés à l’étape cible.
noDifferenceItemsCount	integer	Nombre d’éléments déployés identiques dans les phases source et cible, avant le déploiement.

PrincipalType

Énumération

Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
User	Principal est un principal d’utilisateur Microsoft Entra.
ServicePrincipal	Principal est un principal de service Microsoft Entra.
Group	Principal est un groupe de sécurité.
ServicePrincipalProfile	Le principal est un profil de principal de service.
EntireTenant	Le principal représente tous les utilisateurs du locataire.

ServicePrincipalDetails

Objet

Détails spécifiques au principal de service. Applicable lorsque le type principal est ServicePrincipal.

Nom	Type	Description
aadAppId	string (uuid)	Microsoft EntraId du principal de service.

ServicePrincipalPrincipal

Objet

Représente un principal de service Microsoft Entra.

Nom	Type	Description
displayName	string	Nom complet du principal.
id	string (uuid)	ID du principal.
servicePrincipalDetails	ServicePrincipalDetails	Détails spécifiques au principal de service. Applicable lorsque le type principal est `ServicePrincipal`.
type	string: ServicePrincipal	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.

ServicePrincipalProfileDetails

Objet

Détails du profil du principal de service. Applicable lorsque le type principal est ServicePrincipalProfile.

Nom	Type	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Principal parent du profil de principal de service.

ServicePrincipalProfilePrincipal

Objet

Représente un profil de principal de service.

Nom	Type	Description
displayName	string	Nom complet du principal.
id	string (uuid)	ID du principal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Détails du profil du principal de service. Applicable lorsque le type principal est `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.

UserDetails

Objet

Détails spécifiques au principal de l’utilisateur. Applicable lorsque le type principal est User.

Nom	Type	Description
userPrincipalName	string	Nom d’utilisateur principal.

UserPrincipal

Objet

Représente un principal d’utilisateur Microsoft Entra.

Nom	Type	Description
displayName	string	Nom complet du principal.
id	string (uuid)	ID du principal.
type	string: User	Type du principal. Des types principaux supplémentaires peuvent être ajoutés au fil du temps.
userDetails	UserDetails	Détails spécifiques au principal de l’utilisateur. Applicable lorsque le type principal est `User`.