Published - Get Spark Compute

Hizmet:

Environment

API Sürümü:

v1

Ortam spark işlem alın.

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

Permissions

Ortam öğesi için okuma izni.

Gerekli Temsilci Kapsamları

Item.Read.All veya Item.ReadWrite.All veya Environment.Read.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

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/sparkcompute?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	EnvironmentSparkCompute	İstek başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Yaygın hata kodları: UnknownError - Bir hata oluştu.

Örnekler

Get environment Spark compute example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/environments/707cfd07-cbf1-41da-aad7-dd157ddb8c11/sparkcompute?beta=false

Örnek yanıt

Durum kodu:

200

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace",
    "id": "78942136-106c-4f3e-80fc-7ff4eae11603"
  },
  "driverCores": 4,
  "driverMemory": "56g",
  "executorCores": 4,
  "executorMemory": "56g",
  "dynamicExecutorAllocation": {
    "enabled": false,
    "minExecutors": 1,
    "maxExecutors": 1
  },
  "sparkProperties": [
    {
      "key": "spark.acls.enable",
      "value": "false"
    }
  ],
  "runtimeVersion": "1.2"
}

Tanımlar

Name	Description
CustomPoolMemory	Spark sürücüsü veya Spark yürütücüsü için özel havuz belleği. Zaman içinde ek CustomPoolMemory türleri eklenebilir.
CustomPoolType	Özel havuz türü. Zaman içinde ek CustomPoolType türleri eklenebilir.
DynamicExecutorAllocationProperties	Dinamik yürütücü ayırma avantajları.
EnvironmentSparkCompute
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
InstancePool	Bir havuzun örneği.
SparkProperty	Spark özellik anahtarı ve değeri.

CustomPoolMemory

Numaralandırma

Spark sürücüsü veya Spark yürütücüsü için özel havuz belleği. Zaman içinde ek CustomPoolMemory türleri eklenebilir.

Değer	Description
28g	28 GB bellek.
56g	56G bellek.
112g	112G bellek.
224g	224G bellek.
400g	400G bellek.

CustomPoolType

Numaralandırma

Özel havuz türü. Zaman içinde ek CustomPoolType türleri eklenebilir.

Değer	Description
Workspace	Çalışma alanı özel havuzu
Capacity	Kapasite özel havuzu

DynamicExecutorAllocationProperties

Nesne

Dinamik yürütücü ayırma avantajları.

Name	Tür	Description
enabled	boolean	Dinamik yürütücü ayırmasının durumu. False - Devre dışı, true - Etkin.
maxExecutors	integer (int32) minimum: 1	Dinamik ayırma için en yüksek yürütücü sayısı ve bu özelliğin en düşük değeri 1'dir. En büyük değerin örnek havuzundan maxNodeCountdaha düşük olması gerekir.
minExecutors	integer (int32) minimum: 1	Dinamik ayırma için en düşük yürütücü numarası ve bu özelliğin en düşük yürütücü sayısı 1'dir. En büyük değerin değerinden maxExecutorsdüşük olması gerekir.

EnvironmentSparkCompute

Nesne

Name	Tür	Description
driverCores	integer (int32)	Spark sürücü çekirdeği. Şu değerlerden biri olmalıdır: 4, 8, 16, 32, 64.
driverMemory	CustomPoolMemory	Spark sürücü belleği.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Dinamik yürütücü ayırma.
executorCores	integer (int32)	Spark yürütücü çekirdeği. Şu değerlerden biri olmalıdır: 4, 8, 16, 32, 64.
executorMemory	CustomPoolMemory	Spark yürütücü belleği.
instancePool	InstancePool	Ortam havuzunun geçerli bir özel havuz olması gerekir. "Başlangıç Havuzu", başlangıç havuzunu kullanma anlamına gelir.
runtimeVersion	string	Çalışma zamanı sürümü, desteklenen doku çalışma zamanlarını bulun. Örneğin: 1.3
sparkProperties	SparkProperty[]	Spark özellikleri.

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ı.

InstancePool

Nesne

Bir havuzun örneği.

Name	Tür	Description
id	string (uuid)	Örnek havuzu kimliği.
name	string	Örnek havuzu adı.
type	CustomPoolType	Örnek havuzu türü.

SparkProperty

Nesne

Spark özellik anahtarı ve değeri.

Name	Tür	Description
key	string	Spark özellik anahtarı.
value	string	Spark özellik değeri.