Deployment Pipelines - List Deployment Pipeline Operations
Vráti zoznam up-to-20 najnovších operácií nasadenia vykonaných v zadanom kanáli nasadenia.
Povolenia
Volajúci musí mať rolu kanálov nasadenia správcu .
Povinné delegované rozsahy
Pipeline.Read.All alebo Pipeline.ReadWrite.All
Podporované identity v aplikácii Microsoft Entra
Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.
| Identita | Podpora |
|---|---|
| Používateľ | Yes |
| Objekt služby a spravované identity | Yes |
Rozhranie
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/{deploymentPipelineId}/operations?continuationToken={continuationToken}
Parametre URI
| Name | V | Povinné | Typ | Description |
|---|---|---|---|---|
|
deployment
|
path | True |
string (uuid) |
ID kanála nasadenia. |
|
continuation
|
query |
string |
Token na načítanie ďalšej stránky výsledkov. |
Odpovede
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Požiadavka sa úspešne dokončila. |
|
| Other Status Codes |
Bežné kódy chýb:
|
Príklady
| List deployment pipeline operations example |
| List deployment pipeline operations with continuation example |
List deployment pipeline operations example
Vzorová požiadavka
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations
Vzorová odpoveď
{
"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
Vzorová požiadavka
GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations
Vzorová odpoveď
{
"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"
}
Definície
| Name | Description |
|---|---|
|
Deployment |
Operácia kanála nasadenia služby Fabric. |
|
Deployment |
Poznámka popisujúca nasadenie. |
|
Deployment |
Kolekcia operácií kanálov nasadenia služby Fabric. |
|
Deployment |
Stav operácie kanála nasadenia. Ďalšie stavy sa môžu pridať v priebehu času. |
|
Deployment |
Typ operácie. V priebehu času je možné pridať ďalšie typy. |
|
Error |
Objekt s podrobnosťami o zdroji súvisiacej s chybou. |
|
Error |
Odpoveď na chybu. |
|
Error |
Podrobnosti o chybovej odpovedi. |
|
Group |
Podrobnosti špecifické pre skupinu. Platí, ak je |
|
Group |
Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín. |
|
Pre |
Počet nových, rôznych a identických nasadených položiek pred nasadením. |
| Principal |
Predstavuje identitu alebo skupinu Microsoft Entra. |
|
Principal |
Typ objektu. V priebehu času je možné pridať ďalšie typy objektov. |
|
Service |
Konkrétne podrobnosti objektu služby. Platí, ak je |
|
Service |
Podrobnosti o profile objektu služby. Platí, ak je |
|
User |
Konkrétne podrobnosti o objekte používateľa. Platí, ak je |
DeploymentPipelineOperation
Operácia kanála nasadenia služby Fabric.
| Name | Typ | Description |
|---|---|---|
| executionEndTime |
string (date-time) |
Dátum a čas ukončenia operácie. |
| executionStartTime |
string (date-time) |
Dátum a čas začatia operácie. |
| id |
string (uuid) |
ID operácie. |
| lastUpdatedTime |
string (date-time) |
Dátum a čas poslednej aktualizácie operácie. |
| note |
Poznámka predstavujúca popis operácie. |
|
| performedBy |
Objekt, ktorý vykonal operáciu kanála nasadenia. |
|
| preDeploymentDiffInformation |
Počet nasadených položiek v zdrojovej fáze, ktoré sú nové, identické alebo odlišné od položiek v cieľovej fáze pred nasadením. |
|
| sourceStageId |
string (uuid) |
ID fázy kanála nasadenia zdroja. |
| status |
Stav operácie kanála nasadenia. Ďalšie stavy sa môžu pridať v priebehu času. |
|
| targetStageId |
string (uuid) |
ID cieľovej fázy kanála nasadenia. |
| type |
Typ operácie. V priebehu času je možné pridať ďalšie typy. |
DeploymentPipelineOperationNote
Poznámka popisujúca nasadenie.
| Name | Typ | Description |
|---|---|---|
| content |
string |
Text s popisom nasadenia. |
| isTruncated |
boolean |
Udáva, či sa obsah poznámky skráti. Pravda – obsah poznámky sa skráti, nepravda – obsah poznámky sa neskracuje. Predvolená hodnota je nepravda. |
DeploymentPipelineOperations
Kolekcia operácií kanálov nasadenia služby Fabric.
| Name | Typ | Description |
|---|---|---|
| continuationToken |
string |
Token pre ďalšiu dávku množiny výsledkov. Ak už žiadne záznamy neexistujú, odstráni sa z odpovede. |
| continuationUri |
string |
Identifikátor URI ďalšej série množiny výsledkov. Ak už žiadne záznamy neexistujú, odstráni sa z odpovede. |
| value |
Kolekcia operácií kanála nasadenia. |
DeploymentPipelineOperationStatus
Stav operácie kanála nasadenia. Ďalšie stavy sa môžu pridať v priebehu času.
| Hodnota | Description |
|---|---|
| NotStarted |
Operácia nebola spustená |
| Running |
Spustená operácia |
| Succeeded |
Úspešná operácia |
| Failed |
Operácia zlyhala |
DeploymentPipelineOperationType
Typ operácie. V priebehu času je možné pridať ďalšie typy.
| Hodnota | Description |
|---|---|
| Deploy |
Nasadenie obsahu medzi fázami. |
ErrorRelatedResource
Objekt s podrobnosťami o zdroji súvisiacej s chybou.
| Name | Typ | Description |
|---|---|---|
| resourceId |
string |
ID prostriedku, ktoré je súčasťou chyby. |
| resourceType |
string |
Typ prostriedku, ktorý je zapojený do chyby. |
ErrorResponse
Odpoveď na chybu.
| Name | Typ | Description |
|---|---|---|
| errorCode |
string |
Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi. |
| message |
string |
Zobrazenie chyby čitateľné ľuďmi. |
| moreDetails |
Zoznam ďalších podrobností o chybe. |
|
| relatedResource |
Podrobnosti o zdrojoch súvisiacich s chybou. |
|
| requestId |
string |
ID požiadavky súvisiacej s chybou. |
ErrorResponseDetails
Podrobnosti o chybovej odpovedi.
| Name | Typ | Description |
|---|---|---|
| errorCode |
string |
Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi. |
| message |
string |
Zobrazenie chyby čitateľné ľuďmi. |
| relatedResource |
Podrobnosti o zdrojoch súvisiacich s chybou. |
GroupDetails
Podrobnosti špecifické pre skupinu. Platí, ak je Grouptyp objektu .
| Name | Typ | Description |
|---|---|---|
| groupType |
Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín. |
GroupType
Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín.
| Hodnota | Description |
|---|---|
| Unknown |
Typ hlavnej skupiny nie je známy. |
| SecurityGroup |
Principal je skupina zabezpečenia. |
| DistributionList |
Principal je distribučný zoznam. |
PreDeploymentDiffInformation
Počet nových, rôznych a identických nasadených položiek pred nasadením.
| Name | Typ | Description |
|---|---|---|
| differentItemsCount |
integer |
Počet nasadených položiek s rozdielmi medzi zdrojovou a cieľovou fázou pred nasadením. |
| newItemsCount |
integer |
Počet nových položiek nasadených do cieľovej fázy. |
| noDifferenceItemsCount |
integer |
Počet identických nasadených položiek v zdrojovej a cieľovej fáze pred nasadením. |
Principal
Predstavuje identitu alebo skupinu Microsoft Entra.
| Name | Typ | Description |
|---|---|---|
| displayName |
string |
Zobrazovaný názov objektu. |
| groupDetails |
Podrobnosti špecifické pre skupinu. Platí, ak je |
|
| id |
string (uuid) |
ID objektu. |
| servicePrincipalDetails |
Konkrétne podrobnosti objektu služby. Platí, ak je |
|
| servicePrincipalProfileDetails |
Podrobnosti o profile objektu služby. Platí, ak je |
|
| type |
Typ objektu. V priebehu času je možné pridať ďalšie typy objektov. |
|
| userDetails |
Konkrétne podrobnosti o objekte používateľa. Platí, ak je |
PrincipalType
Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.
| Hodnota | Description |
|---|---|
| User |
Principal je objekt používateľa služby Microsoft Entra. |
| ServicePrincipal |
Principal je objekt služby Microsoft Entra. |
| Group |
Principal je skupina zabezpečenia. |
| ServicePrincipalProfile |
Principal je profil objektu služby. |
| EntireTenant |
Možnosť Principal predstavuje všetkých používateľov nájomníka. |
ServicePrincipalDetails
Konkrétne podrobnosti objektu služby. Platí, ak je ServicePrincipaltyp objektu .
| Name | Typ | Description |
|---|---|---|
| aadAppId |
string (uuid) |
Microsoft Entra AppId objektu služby. |
ServicePrincipalProfileDetails
Podrobnosti o profile objektu služby. Platí, ak je ServicePrincipalProfiletyp objektu .
| Name | Typ | Description |
|---|---|---|
| parentPrincipal |
Nadradený objekt profilu služby. |
UserDetails
Konkrétne podrobnosti o objekte používateľa. Platí, ak je Usertyp objektu .
| Name | Typ | Description |
|---|---|---|
| userPrincipalName |
string |
Hlavné meno používateľa. |