Deployment Pipelines - List Deployment Pipeline Operations
Returnerar en lista över de up-to-20 senaste distributionsåtgärder som utförts på den angivna distributionspipelinen.
Behörigheter
Anroparen måste ha rollen pipelines för administratörsdistribution .
Obligatoriska delegerade omfång
Pipeline.Read.All eller Pipeline.ReadWrite.All
Identiteter som stöds av Microsoft Entra
Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.
| Identitet | Stöd |
|---|---|
| Användare | Ja |
| Tjänsthuvudnamn och hanterade identiteter | Ja |
Gränssnitt
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations?continuationToken={continuationToken}
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
deployment
|
path | True |
string (uuid) |
Distributionspipeline-ID:t. |
|
continuation
|
query |
string |
En token för att hämta nästa sida med resultat. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Begäran har slutförts. |
|
| Other Status Codes |
Vanliga felkoder:
|
Exempel
| List deployment pipeline operations example |
| List deployment pipeline operations with continuation example |
List deployment pipeline operations example
Exempelbegäran
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations
Exempelsvar
{
"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
Exempelbegäran
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations
Exempelsvar
{
"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"
}
Definitioner
| Name | Description |
|---|---|
|
Deployment |
En pipelineåtgärd för infrastrukturdistribution. |
|
Deployment |
En anteckning som beskriver distributionen. |
|
Deployment |
En samling pipelineåtgärder för infrastrukturdistribution. |
|
Deployment |
Status för distributionspipelinens åtgärd. Ytterligare statusar kan läggas till över tid. |
|
Deployment |
Åtgärdstypen. Ytterligare typer kan läggas till över tid. |
|
Error |
Det felrelaterade resursinformationsobjektet. |
|
Error |
Felsvaret. |
|
Error |
Information om felsvar. |
|
Group |
Gruppera specifik information. Gäller när huvudtypen är |
|
Group |
Gruppens typ. Ytterligare grupptyper kan läggas till över tid. |
|
Pre |
Antalet nya, olika och identiska distribuerade objekt före distributionen. |
| Principal |
Representerar en identitet eller en Microsoft Entra-grupp. |
|
Principal |
Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid. |
|
Service |
Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är |
|
Service |
Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är |
|
User |
Specifik information om användarens huvudnamn. Gäller när huvudtypen är |
DeploymentPipelineOperation
En pipelineåtgärd för infrastrukturdistribution.
| Name | Typ | Description |
|---|---|---|
| executionEndTime |
string (date-time) |
Datum och tid då åtgärden avslutades. |
| executionStartTime |
string (date-time) |
Datum och tid då åtgärden startade. |
| id |
string (uuid) |
Åtgärds-ID:t. |
| lastUpdatedTime |
string (date-time) |
Datum och tid då åtgärden senast uppdaterades. |
| note |
En anteckning som representerar en beskrivning av åtgärden. |
|
| performedBy |
Det huvudnamn som utförde distributionspipelineåtgärden. |
|
| preDeploymentDiffInformation |
Antalet distribuerade objekt i källsteget, som är nya, identiska eller skiljer sig från objekt i målfasen, före distributionen. |
|
| sourceStageId |
string (uuid) |
ID för en pipelinefas för källdistribution. |
| status |
Status för distributionspipelinens åtgärd. Ytterligare statusar kan läggas till över tid. |
|
| targetStageId |
string (uuid) |
ID:t för en pipelinefas för måldistribution. |
| type |
Åtgärdstypen. Ytterligare typer kan läggas till över tid. |
DeploymentPipelineOperationNote
En anteckning som beskriver distributionen.
| Name | Typ | Description |
|---|---|---|
| content |
string |
Text som beskriver distributionen. |
| isTruncated |
boolean |
Anger om anteckningsinnehållet trunkeras. Sant – anteckningsinnehållet trunkeras, Falskt – anteckningsinnehållet trunkeras inte. Standardvärdet är "falsk". |
DeploymentPipelineOperations
En samling pipelineåtgärder för infrastrukturdistribution.
| Name | Typ | Description |
|---|---|---|
| continuationToken |
string |
Token för nästa resultatuppsättningsbatch. Om det inte finns några fler poster tas den bort från svaret. |
| continuationUri |
string |
URI:n för nästa resultatuppsättningsbatch. Om det inte finns några fler poster tas den bort från svaret. |
| value |
Samlingen av distributionspipelineåtgärder. |
DeploymentPipelineOperationStatus
Status för distributionspipelinens åtgärd. Ytterligare statusar kan läggas till över tid.
| Värde | Description |
|---|---|
| NotStarted |
Åtgärden har inte startats |
| Running |
Åtgärden körs |
| Succeeded |
Åtgärden har slutförts |
| Failed |
Åtgärden misslyckades |
DeploymentPipelineOperationType
Åtgärdstypen. Ytterligare typer kan läggas till över tid.
| Värde | Description |
|---|---|
| Deploy |
Distribuera innehåll mellan faser. |
ErrorRelatedResource
Det felrelaterade resursinformationsobjektet.
| Name | Typ | Description |
|---|---|---|
| resourceId |
string |
Det resurs-ID som ingår i felet. |
| resourceType |
string |
Typen av resurs som är inblandad i felet. |
ErrorResponse
Felsvaret.
| Name | Typ | Description |
|---|---|---|
| errorCode |
string |
En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare. |
| message |
string |
En mänsklig läsbar representation av felet. |
| moreDetails |
Lista över ytterligare felinformation. |
|
| relatedResource |
Felrelaterad resursinformation. |
|
| requestId |
string |
ID för den begäran som är associerad med felet. |
ErrorResponseDetails
Information om felsvar.
| Name | Typ | Description |
|---|---|---|
| errorCode |
string |
En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare. |
| message |
string |
En mänsklig läsbar representation av felet. |
| relatedResource |
Felrelaterad resursinformation. |
GroupDetails
Gruppera specifik information. Gäller när huvudtypen är Group.
| Name | Typ | Description |
|---|---|---|
| groupType |
Gruppens typ. Ytterligare grupptyper kan läggas till över tid. |
GroupType
Gruppens typ. Ytterligare grupptyper kan läggas till över tid.
| Värde | Description |
|---|---|
| Unknown |
Huvudgrupptypen är okänd. |
| SecurityGroup |
Huvudnamn är en säkerhetsgrupp. |
| DistributionList |
Huvudnamn är en distributionslista. |
PreDeploymentDiffInformation
Antalet nya, olika och identiska distribuerade objekt före distributionen.
| Name | Typ | Description |
|---|---|---|
| differentItemsCount |
integer |
Antalet distribuerade objekt med skillnader mellan käll- och målfaserna före distributionen. |
| newItemsCount |
integer |
Antalet nya objekt som distribuerats till målfasen. |
| noDifferenceItemsCount |
integer |
Antalet identiska distribuerade objekt i käll- och målfaserna före distributionen. |
Principal
Representerar en identitet eller en Microsoft Entra-grupp.
| Name | Typ | Description |
|---|---|---|
| displayName |
string |
Huvudkontots visningsnamn. |
| groupDetails |
Gruppera specifik information. Gäller när huvudtypen är |
|
| id |
string (uuid) |
Huvudmannens ID. |
| servicePrincipalDetails |
Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är |
|
| servicePrincipalProfileDetails |
Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är |
|
| type |
Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid. |
|
| userDetails |
Specifik information om användarens huvudnamn. Gäller när huvudtypen är |
PrincipalType
Typ av huvudnamn. Ytterligare huvudnamnstyper kan läggas till över tid.
| Värde | Description |
|---|---|
| User |
Principal är ett Microsoft Entra-användarhuvudnamn. |
| ServicePrincipal |
Principal är microsoft entra-tjänstens huvudnamn. |
| Group |
Huvudnamn är en säkerhetsgrupp. |
| ServicePrincipalProfile |
Huvudnamn är en profil för tjänstens huvudnamn. |
| EntireTenant |
Huvudkontot representerar alla klientanvändare. |
ServicePrincipalDetails
Specifik information om tjänstens huvudnamn. Gäller när huvudtypen är ServicePrincipal.
| Name | Typ | Description |
|---|---|---|
| aadAppId |
string (uuid) |
Tjänstens huvudnamns Microsoft Entra AppId. |
ServicePrincipalProfileDetails
Profilinformation för tjänstens huvudnamn. Gäller när huvudtypen är ServicePrincipalProfile.
| Name | Typ | Description |
|---|---|---|
| parentPrincipal |
Tjänstens huvudnamnsprofils överordnade huvudnamn. |
UserDetails
Specifik information om användarens huvudnamn. Gäller när huvudtypen är User.
| Name | Typ | Description |
|---|---|---|
| userPrincipalName |
string |
Användarens huvudnamn. |