Items - Publish Environment

Hizmet:

Environment

API Sürümü:

v1

Ortam yayımlama işlemini tetikleme.

Uyarı

Bu API, 1 Mart 2026'da kullanım dışı bırakılacağı için bir beta sürümünün yayın sürümüdür. Bu API'yi çağırırken - çağıranların sorgu parametresini beta değere ayarlaması gerekir false

Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Permissions

Ortam öğesi için yazma izni.

Gerekli Temsilci Kapsamları

Item.ReadWrite.All veya Environment.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
environmentId	path	True	string (uuid)	Ortam kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
beta	query	True	boolean	Bu parametre, API'nin hangi sürümünün kullanılacağını belirtir. false Yayın sürümünü kullanmak için olarak ayarlayın.

Yanıtlar

Name	Tür	Description
200 OK	EnvironmentProperties	Yayımlama işlemi isteği başarıyla gönderildi.
202 Accepted		İstek kabul edildi, yayımlama işlemi devam ediyor. Ga sözleşmesini döndürdüğünde beta=false (varsayılan olarak 1 Mart 2026'da). Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: InvalidEnvironmentPublish - Başarısız yayımlama işleminin sürüm <GUID'i için ortam yayımlama işlemi> şu hata nedeniyle başarısız oldu: Code = EnvironmentAnotherOngoingPublishProcess.

Örnekler

Publish environment example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:

200

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

Durum kodu:

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

Tanımlar

Name	Description
ComponentPublishInfo	Ortamdaki her bileşen için bilgi yayımlayın.
EnvironmentProperties	Ortam özellikleri.
EnvironmentPublishState	Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
PublishDetails	Yayımlama işleminin ayrıntıları.
SparkLibraries	Spark kitaplıkları.
SparkSettings	Spark ayarları.

ComponentPublishInfo

Nesne

Ortamdaki her bileşen için bilgi yayımlayın.

Name	Tür	Description
sparkLibraries	SparkLibraries	Spark kitaplıkları bilgileri yayımlar.
sparkSettings	SparkSettings	Spark ayarları bilgileri yayımlar.

EnvironmentProperties

Nesne

Ortam özellikleri.

Name	Tür	Description
publishDetails	PublishDetails	Ortam yayımlama işlemi ayrıntıları.

EnvironmentPublishState

Numaralandırma

Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.

Değer	Description
Success	Ortam yayımlama başarılı durumda.
Cancelled	Ortam yayımlama iptal edildi durumunda.
Failed	Ortam yayımlama başarısız durumda.
Cancelling	Ortam yayımlama iptal etme durumunda.
Running	Ortam yayımlama çalışıyor durumda.
Waiting	Ortam yayımlama bekleme durumunda.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

PublishDetails

Nesne

Yayımlama işleminin ayrıntıları.

Name	Tür	Description
componentPublishInfo	ComponentPublishInfo	Ortam bileşeni yayımlama bilgileri.
endTime	string (date-time)	YYYY-MM-DDTHH:mm:ss.ssZ biçimini kullanarak UTC'de yayımlama işleminin bitiş saati.
startTime	string (date-time)	YYYY-MM-DDTHH:mm:ss.ssZ biçimini kullanarak utc'de yayımlama işleminin başlangıç saati.
state	EnvironmentPublishState	Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.
targetVersion	string (uuid)	Yayımlanacak verion'ı hedefle.

SparkLibraries

Nesne

Spark kitaplıkları.

Name	Tür	Description
state	EnvironmentPublishState	Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.

SparkSettings

Nesne

Spark ayarları.

Name	Tür	Description
state	EnvironmentPublishState	Yayımlama durumu. Zaman içinde ek durum türleri eklenebilir.