Items - Publish Environment

Hizmet:: Environment

API Sürümü:: v1

Ortam yayımlama işlemini tetikleme.

Uyarı

Bu API, 31 Ağustos 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

Desteklenen kimlikleri Microsoft Entra

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

Veri Akışı Adı	İç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

Veri Akışı Adı	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 ne zaman `beta=false` (varsayılan olarak 31 Ağustos 2026'dan sonra) döndürür. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler 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

Veri Akışı Adı	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.
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
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.

Veri Akışı Adı	Tür	Description
sparkLibraries	SparkLibraries	Spark kitaplıkları bilgileri yayımlar.
sparkSettings	SparkSettings	Spark ayarları bilgileri yayımlar.

EnvironmentProperties

Nesne

Ortam özellikleri.

Veri Akışı Adı	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.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	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ı.

Veri Akışı Adı	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ı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

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

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

PublishDetails

Nesne

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

Veri Akışı Adı	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ı.

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

SparkSettings

Nesne

Spark ayarları.

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