Items - Publish Environment

Palvelu:

Environment

Ohjelmointirajapinnan versio:

v1

Käynnistä ympäristön julkaisutoiminto.

Note

Tämä ohjelmointirajapinta on versio beetaversiosta, jonka on määrä vanhentua 1.3.2026. Kun kutsut tätä ohjelmointirajapintaa - soittajien on määritettävä kyselyparametri beta -arvoksi false

Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Käyttöoikeudet

Ympäristön kohteen kirjoitusoikeus.

Vaaditut delegoidut vaikutusalueet

Item.ReadWrite.All tai Environment.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

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

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

Liittymä

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/staging/publish?beta={beta}

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
environmentId	path	True	string (uuid)	Ympäristötunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.
beta	query	True	boolean	Tämä parametri määrittää, mitä ohjelmointirajapinnan versiota käytetään. Määritä käyttämään false julkaisuversiota.

Vastaukset

Nimi	Tyyppi	Description
200 OK	EnvironmentProperties	Julkaisutoimintopyyntö on lähetetty onnistuneesti.
202 Accepted		Pyyntö hyväksytty, julkaisutoiminto on meneillään. Palauttaa GA-sopimuksen, kun beta=false (oletusarvo 1.3.2026 jälkeen). Otsikot Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: InvalidEnvironmentPublish – Epäonnistuneen julkaisutoiminnon< version > ympäristön julkaisutoiminto epäonnistui virheen vuoksi: Code = EnvironmentAnotherOngoingPublishProcess.

Esimerkit

Publish environment example

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/environments/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/staging/publish?beta=false

Mallivastaus

Tilakoodi:

200

{
  "publishDetails": {
    "state": "Running",
    "targetVersion": "46838a80-5450-4414-bea0-40fb6f3e0c0d",
    "startTime": "2024-03-29T14:17:09.0697022Z",
    "componentPublishInfo": {
      "sparkLibraries": {
        "state": "Running"
      },
      "sparkSettings": {
        "state": "Running"
      }
    }
  }
}

Tilakoodi:

202

Location: https://api.fabric.microsoft.com/v1/operations/abcdef00-9d7e-469a-abf1-fca847a0ea69
x-ms-operation-id: abcdef00-9d7e-469a-abf1-fca847a0ea69
Retry-After: 120

Määritelmät

Nimi	Description
ComponentPublishInfo	Julkaise ympäristön kunkin komponentin tiedot.
EnvironmentProperties	Ympäristön ominaisuudet.
EnvironmentPublishState	Julkaisutila. Muita tilatyyppejä voidaan lisätä ajan kuluessa.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
PublishDetails	Julkaisutoiminnon tiedot.
SparkLibraries	Spark-kirjastot.
SparkSettings	Spark-asetukset.

ComponentPublishInfo

Kohde

Julkaise ympäristön kunkin komponentin tiedot.

Nimi	Tyyppi	Description
sparkLibraries	SparkLibraries	Spark-kirjastot julkaisevat tietoja.
sparkSettings	SparkSettings	Spark-asetusten julkaisutiedot.

EnvironmentProperties

Kohde

Ympäristön ominaisuudet.

Nimi	Tyyppi	Description
publishDetails	PublishDetails	Ympäristön julkaisutoiminnon tiedot.

EnvironmentPublishState

Luettelointi

Julkaisutila. Muita tilatyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
Success	Ympäristön julkaiseminen on onnistumistilassa.
Cancelled	Ympäristön julkaiseminen on peruutettuna.
Failed	Ympäristön julkaisu on epäonnistuneessa tilassa.
Cancelling	Ympäristön julkaisu on peruuttamassa tilaa.
Running	Ympäristön julkaisu on käynnissä-tilassa.
Waiting	Ympäristön julkaisu on odotustilassa.

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ä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	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.

PublishDetails

Kohde

Julkaisutoiminnon tiedot.

Nimi	Tyyppi	Description
componentPublishInfo	ComponentPublishInfo	Ympäristön osan julkaisutiedot.
endTime	string (date-time)	Julkaisutoiminnon päättymisaika UTC-muodossa VVVV-KK-PPTHH:mm:ss.ssssssZ.
startTime	string (date-time)	Julkaisutoiminnon alkamisaika UTC-muodossa VVVV-KK-PPTHH:mm:ss.ssssssZ.
state	EnvironmentPublishState	Julkaisutila. Muita tilatyyppejä voidaan lisätä ajan kuluessa.
targetVersion	string (uuid)	Target verion julkaistaan.

SparkLibraries

Kohde

Spark-kirjastot.

Nimi	Tyyppi	Description
state	EnvironmentPublishState	Julkaisutila. Muita tilatyyppejä voidaan lisätä ajan kuluessa.

SparkSettings

Kohde

Spark-asetukset.

Nimi	Tyyppi	Description
state	EnvironmentPublishState	Julkaisutila. Muita tilatyyppejä voidaan lisätä ajan kuluessa.