Deployment Pipelines - Get Deployment Pipeline Operation

Palvelu:: Core

Ohjelmointirajapinnan versio:: v1

Palauttaa määritetyssä käyttöönottoputkessa suoritetun määritetyn käyttöönottotoiminnon tiedot, mukaan lukien käyttöönoton suoritussuunnitelman.

Käyttöoikeudet

Soittajalla on oltava järjestelmänvalvojan käyttöönottoputkien rooli.

Vaaditut delegoidut vaikutusalueet

Pipeline.Read.All tai Pipeline.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Käyttäjätiedot	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
deploymentPipelineId	path	True	string (uuid)	Käyttöönottoputken tunnus.
operationId	path	True	string (uuid)	Toiminnon tunnus.

Vastaukset

Nimi Tyyppi Description

200 OK

Nimi	Tyyppi	Description
200 OK	DeploymentPipelineOperationExtendedInfo	Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: UnknownError – Ilmeni virhe

DeploymentPipelineOperationExtendedInfo

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

UnknownError – Ilmeni virhe

Esimerkit

Get a deployment pipeline operation example

Mallipyyntö

HTTP

GET https://api.fabric.microsoft.com/v1/deploymentPipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations/1065e6a3-a020-4c0c-ada7-92b5fe99eec5

Mallivastaus

Tilakoodi:: 200

{
  "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",
  "executionPlan": {
    "steps": [
      {
        "index": 0,
        "description": "DataflowDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "29efcfb0-0063-44af-a4ed-6c0bee3417d3",
          "sourceItemDisplayName": "Source dataflow",
          "itemType": "Dataflow"
        }
      },
      {
        "index": 1,
        "description": "DatamartDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "645cd81f-1b21-4006-82b6-54cc7ec0352e",
          "sourceItemDisplayName": "Source datamart",
          "itemType": "Datamart"
        }
      },
      {
        "index": 2,
        "description": "DatasetDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "NoDifference",
        "sourceAndTarget": {
          "sourceItemId": "1a201f2a-d1d8-45c0-8c61-1676338517de",
          "sourceItemDisplayName": "Source dataset",
          "targetItemId": "dd3b6aa1-4d40-405c-a19b-48314a27e8ee",
          "targetItemDisplayName": "Target dataset",
          "itemType": "SemanticModel"
        }
      },
      {
        "index": 3,
        "description": "ReportDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "Different",
        "sourceAndTarget": {
          "sourceItemId": "2d225191-65f8-4ec3-b77d-06100602b1f7",
          "sourceItemDisplayName": "Source report",
          "targetItemId": "9d5c1f0f-f85c-48f4-8a8e-4c77547116b3",
          "targetItemDisplayName": "Target report",
          "itemType": "Report"
        }
      },
      {
        "index": 4,
        "description": "DashboardDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "sourceItemId": "9046e4cc-8aea-4a7a-a3b5-1a78b1447d82",
          "sourceItemDisplayName": "Source dashboard",
          "itemType": "Dashboard"
        }
      }
    ]
  },
  "note": {
    "content": "Sample note"
  },
  "preDeploymentDiffInformation": {
    "newItemsCount": 3,
    "differentItemsCount": 1,
    "noDifferenceItemsCount": 1
  },
  "performedBy": {
    "id": "a35d842b-90d5-59a2-c56a-5f8fcff0bf9d",
    "type": "User"
  }
}

Määritelmät

Nimi	Description
DeploymentExecutionPlan	Käyttöönoton suoritussuunnitelma.
DeploymentExecutionStep	Käyttöönoton suoritusvaihe.
DeploymentPipelineOperationExtendedInfo	Fabric-käyttöönottoputkitoiminto.
DeploymentPipelineOperationNote	Käyttöönottoa kuvaava huomautus.
DeploymentPipelineOperationStatus	Käyttöönottoputkitoiminnon tila. Lisää tilat saatetaan lisätä ajan mittaan.
DeploymentPipelineOperationType	Toiminnon tyyppi. Muita tyyppejä voidaan lisätä ajan mittaan.
DeploymentSourceAndTarget	Lähde- ja kohdekohteet.
EntireTenantPrincipal	Edustaa vuokraajan päänimeä
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
GroupDetails	Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on `Group`.
GroupPrincipal	Edustaa käyttöoikeusryhmää.
GroupType	Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.
ItemPreDeploymentDiffState	Määrittää, onko kohde uusi, erilainen tai samanlainen kuin kohdevaiheen kohteet ennen käyttöönottoa. Lisää tiloja voidaan lisätä ajan kuluessa.
ItemType	Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
PreDeploymentDiffInformation	Käyttöön otettujen uusien, erilaisten ja identtisten kohteiden määrä ennen käyttöönottoa.
PrincipalType	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
ServicePrincipalDetails	Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on `ServicePrincipal`.
ServicePrincipalPrincipal	Edustaa Microsoft Entra -palvelun päänimeä.
ServicePrincipalProfileDetails	Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Edustaa palvelun pääprofiilia.
UserDetails	Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on `User`.
UserPrincipal	Edustaa Microsoft Entra -käyttäjäobjektia.

DeploymentExecutionPlan

Kohde

Käyttöönoton suoritussuunnitelma.

Nimi	Tyyppi	Description
steps	DeploymentExecutionStep[]	Tämä on kokoelma suoritussuunnitelman vaiheita.

DeploymentExecutionStep

Kohde

Käyttöönoton suoritusvaihe.

Nimi	Tyyppi	Description
description	string	Käyttöönottovaiheen kuvaus.
error	ErrorResponse	Virheen tiedot. Käytettävissä vain, jos käyttöönottoputkitoiminto epäonnistui.
index	integer	Vaiheen indeksi.
preDeploymentDiffState	ItemPreDeploymentDiffState	Onko kohde uusi, erilainen tai samanlainen kuin kohdevaiheen kohteet ennen käyttöönottoa.
sourceAndTarget	DeploymentSourceAndTarget	Vaiheen lähde- ja kohdekohteet.
status	DeploymentPipelineOperationStatus	Käyttöönottoputkitoiminnon tila. Lisää tilat saatetaan lisätä ajan mittaan.

DeploymentPipelineOperationExtendedInfo

Kohde

Fabric-käyttöönottoputkitoiminto.

Nimi	Tyyppi	Description
executionEndTime	string (date-time)	Päivämäärä ja aika, jolloin toiminto päättyi.
executionPlan	DeploymentExecutionPlan	Käyttöönoton suoritussuunnitelma.
executionStartTime	string (date-time)	Toiminnon aloittamisen päivämäärä ja aika.
id	string (uuid)	Toiminnon tunnus.
lastUpdatedTime	string (date-time)	Päivämäärä ja aika, jolloin toiminto päivitettiin viimeksi.
note	DeploymentPipelineOperationNote	Huomautus, joka edustaa toiminnon kuvausta.
performedBy	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Päänimi, joka suoritti käyttöönottoputkitoiminnon.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Lähdevaiheessa käyttöönotettujen kohteiden määrä, jotka ovat uusia, identtisiä tai erilaisia kuin kohdevaiheen kohteet, ennen käyttöönottoa.
sourceStageId	string (uuid)	Lähteen käyttöönottoputken vaiheen tunnus.
status	DeploymentPipelineOperationStatus	Käyttöönottoputken toiminnon tila. Lisää tilat saatetaan lisätä ajan mittaan.
targetStageId	string (uuid)	Käyttöönottoputken kohdevaiheen tunnus.
type	DeploymentPipelineOperationType	Toiminnon tyyppi. Muita tyyppejä voidaan lisätä ajan mittaan.

DeploymentPipelineOperationNote

Kohde

Käyttöönottoa kuvaava huomautus.

Nimi	Tyyppi	Description
content	string	Käyttöönottoa kuvaava teksti.
isTruncated	boolean	Ilmaisee, katkaistaanko muistiinpanon sisältö. Tosi – muistiinpanon sisältö katkaistaan, epätosi – muistiinpanon sisältöä ei katkaista. Oletusarvo on false.

DeploymentPipelineOperationStatus

Luettelointi

Käyttöönottoputkitoiminnon tila. Lisää tilat saatetaan lisätä ajan mittaan.

Arvo	Description
NotStarted	Käyttöönottoputkitoiminto ei käynnistynyt.
Running	Käyttöönottoputkitoiminto on käynnissä.
Succeeded	Käyttöönottoputkitoiminto onnistui.
Failed	Käyttöönottoputken toiminto epäonnistui.

DeploymentPipelineOperationType

Luettelointi

Toiminnon tyyppi. Muita tyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
Deploy	Sisällön käyttöönotto vaiheiden välillä.

DeploymentSourceAndTarget

Kohde

Lähde- ja kohdekohteet.

Nimi	Tyyppi	Description
itemType	ItemType	Se Fabric-kohteen tyyppi, joka korvataan kohdevaiheessa. Koskee vain Fabric-kohteen korvaamista.
sourceItemDisplayName	string	Lähdevaiheesta käyttöönotetun Fabric-kohteen näyttönimi.
sourceItemId	string (uuid)	Lähdevaiheesta käyttöönotetun Fabric-kohteen tunnus.
targetItemDisplayName	string	Sen Fabric-kohteen nimi, joka korvataan kohdevaiheessa. Koskee vain Fabric-kohteen korvaamista.
targetItemId	string (uuid)	Sen Fabric-kohteen tunnus, joka korvataan kohdevaiheessa. Koskee vain Fabric-kohteen korvaamista.

EntireTenantPrincipal

Kohde

Edustaa vuokraajan päänimeä

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
id	string (uuid)	Päänimen tunnus.
type	string: EntireTenant	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

GroupDetails

Kohde

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.

Nimi	Tyyppi	Description
groupType	GroupType	Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

GroupPrincipal

Kohde

Edustaa käyttöoikeusryhmää.

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
groupDetails	GroupDetails	Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on `Group`.
id	string (uuid)	Päänimen tunnus.
type	string: Group	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

GroupType

Luettelointi

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
Unknown	Pääryhmän tyyppi on tuntematon.
SecurityGroup	Principal on käyttöoikeusryhmä.
DistributionList	Principal on jakeluluettelo.

ItemPreDeploymentDiffState

Luettelointi

Määrittää, onko kohde uusi, erilainen tai samanlainen kuin kohdevaiheen kohteet ennen käyttöönottoa. Lisää tiloja voidaan lisätä ajan kuluessa.

Arvo	Description
New	Uusi käyttöönotettu kohde, jota ei ole olemassa kohdevaiheessa.
Different	Ennen käyttöönottoa lähdevaiheen kohde ei ollut samanlainen kuin kohdevaiheessa.
NoDifference	Ennen käyttöönottoa lähdevaiheen kohde oli samanlainen kuin kohdevaiheessa.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
Dashboard	Power BI -koontinäyttö.
Report	PowerBI -raportti.
SemanticModel	PowerBI:n semanttinen malli.
PaginatedReport	PowerBI:n sivutettu raportti.
Datamart	PowerBI -tietomarssi.
Lakehouse	Tämä on lakehouse.
Eventhouse	Tapahtumatalo.
Environment	Ympäristö.
KQLDatabase	KQL-tietokanta.
KQLQueryset	KQL-kyselyjoukko.
KQLDashboard	KQL-koontinäyttö.
DataPipeline	Tietoputki.
Notebook	Muistikirja.
SparkJobDefinition	Spark-työn määritelmä.
MLExperiment	Koneoppimisen kokeilu.
MLModel	Koneoppimismalli.
Warehouse	Varasto.
Eventstream	Tapahtumavirta.
SQLEndpoint	SQL-päätepiste.
MirroredWarehouse	Peilattu varasto.
MirroredDatabase	Peilattu tietokanta.
Reflex	Refleksi.
GraphQLApi	Ohjelmointirajapinta GraphQL-kohteelle.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopiotyö.
VariableLibrary	MuuttujaLibrary.
Dataflow	Tietovuo.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Varastotilannevedos.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digital Twin Builder -työnkulku.
MirroredAzureDatabricksCatalog	Peilattu Azure Databricks -luettelo.
Map	Kartta.
AnomalyDetector	Poikkeamien tunnistaminen.
UserDataFunction	Käyttäjätietofunktio.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake-tietokannalla tallennetaan Snowflake-tililtä luodut Iceberg-taulukot.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB -tietokanta.
Ontology	Ontologia.
EventSchemaSet	An EventSchemaSet.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.

PreDeploymentDiffInformation

Kohde

Käyttöön otettujen uusien, erilaisten ja identtisten kohteiden määrä ennen käyttöönottoa.

Nimi	Tyyppi	Description
differentItemsCount	integer	Käyttöön otettujen kohteiden määrä, jolla on erot lähde- ja kohdevaiheiden välillä ennen käyttöönottoa.
newItemsCount	integer	Kohdevaiheeseen käyttöönotettujen uusien kohteiden määrä.
noDifferenceItemsCount	integer	Identtisten käyttöön otettujen kohteiden määrä lähde- ja kohdevaiheissa ennen käyttöönottoa.

PrincipalType

Luettelointi

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
User	Principal on Microsoft Entra -käyttäjäobjekti.
ServicePrincipal	Principal on Microsoft Entra -palvelun päänimi.
Group	Principal on käyttöoikeusryhmä.
ServicePrincipalProfile	Principal on palvelun pääprofiili.
EntireTenant	Principal edustaa kaikkia vuokraajan käyttäjiä.

ServicePrincipalDetails

Kohde

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.

Nimi	Tyyppi	Description
aadAppId	string (uuid)	Palvelun päänimen Microsoft Entra AppId.

ServicePrincipalPrincipal

Kohde

Edustaa Microsoft Entra -palvelun päänimeä.

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
id	string (uuid)	Päänimen tunnus.
servicePrincipalDetails	ServicePrincipalDetails	Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on `ServicePrincipal`.
type	string: ServicePrincipal	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

ServicePrincipalProfileDetails

Kohde

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.

Nimi	Tyyppi	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Palvelun pääprofiilin pääobjekti.

ServicePrincipalProfilePrincipal

Kohde

Edustaa palvelun pääprofiilia.

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
id	string (uuid)	Päänimen tunnus.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

UserDetails

Kohde

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

Nimi	Tyyppi	Description
userPrincipalName	string	Täydellinen käyttäjänimi.

UserPrincipal

Kohde

Edustaa Microsoft Entra -käyttäjäobjektia.

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
id	string (uuid)	Päänimen tunnus.
type	string: User	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
userDetails	UserDetails	Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on `User`.