Published - Get Spark Compute

Usługa:: Environment

Wersja interfejsu API:: v1

Pobierz środowisko obliczeniowe platformy Spark.

Uwaga / Notatka

Ten interfejs API jest wersją wersji beta, która zostanie wycofana 1 marca 2026 r. Podczas wywoływania tego interfejsu API obiekt wywołujący musi ustawić parametr beta zapytania na wartość false

Permissions

Uprawnienie do odczytu dla elementu środowiska.

Wymagane zakresy delegowane

Item.Read.All lub Item.ReadWrite.All lub Environment.Read.All lub Environment.ReadWrite.All

Tożsamości obsługiwane przez Microsoft Entra

To API obsługuje tożsamości Microsoft wymienione w tej sekcji.

Tożsamość	Support
User	Tak
Główne usługi i Tożsamości zarządzane	Tak

Interfejs

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/sparkcompute?beta={beta}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
environmentId	path	True	string (uuid)	Identyfikator środowiska.
workspaceId	path	True	string (uuid)	Identyfikator przestrzeni roboczej.
beta	query	True	boolean	Ten parametr określa, która wersja interfejsu API ma być używana. Ustaw wartość na , aby `false` używać wersji wydania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	EnvironmentSparkCompute	Żądanie zostało ukończone pomyślnie.
Other Status Codes	ErrorResponse	Typowe kody błędów: UnknownError — wystąpił błąd.

Nazwa

Typ

Opis

200 OK

EnvironmentSparkCompute

Żądanie zostało ukończone pomyślnie.

Other Status Codes

ErrorResponse

Typowe kody błędów:

UnknownError — wystąpił błąd.

Przykłady

Get environment Spark compute example

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:: 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"
}

Definicje

Nazwa	Opis
CustomPoolMemory	Niestandardowa pamięć puli dla sterownika platformy Spark lub funkcji wykonawczej platformy Spark. Dodatkowe typy `CustomPoolMemory` można dodawać w czasie.
CustomPoolType	Typ puli niestandardowej. Dodatkowe typy `CustomPoolType` można dodawać w czasie.
DynamicExecutorAllocationProperties	Dynamiczne zalety alokacji funkcji wykonawczej.
EnvironmentSparkCompute
ErrorRelatedResource	Obiekt szczegółów zasobu powiązanego z błędem.
ErrorResponse	Odpowiedź na błąd.
ErrorResponseDetails	Szczegóły odpowiedzi na błąd.
InstancePool	Wystąpienie puli.
SparkProperty	Klucz właściwości platformy Spark i jego wartość.

CustomPoolMemory

Wyliczenie

Niestandardowa pamięć puli dla sterownika platformy Spark lub funkcji wykonawczej platformy Spark. Dodatkowe typy CustomPoolMemory można dodawać w czasie.

Wartość	Opis
28g	28 GB pamięci.
56g	Pamięć 56G.
112g	Pamięć 112G.
224g	Pamięć 224G.
400g	Pamięć 400G.

CustomPoolType

Wyliczenie

Typ puli niestandardowej. Dodatkowe typy CustomPoolType można dodawać w czasie.

Wartość	Opis
Workspace	Pula niestandardowa obszaru roboczego
Capacity	Pula niestandardowa pojemności

DynamicExecutorAllocationProperties

Objekt

Dynamiczne zalety alokacji funkcji wykonawczej.

Nazwa	Typ	Opis
enabled	boolean	Stan alokacji funkcji wykonawczej dynamicznej. Fałsz — wyłączone, true — włączone.
maxExecutors	integer (int32) minimum: 1	Maksymalna liczba funkcji wykonawczej dla alokacji dynamicznej i minimalna dla tej właściwości to 1. Wartość maksymalna musi być niższa niż pula `maxNodeCount`wystąpień.
minExecutors	integer (int32) minimum: 1	Minimalna liczba funkcji wykonawczej dla alokacji dynamicznej i minimalna dla tej właściwości to 1. Wartość maksymalna musi być niższa niż `maxExecutors`.

EnvironmentSparkCompute

Objekt

Nazwa	Typ	Opis
driverCores	integer (int32)	Rdzenie sterowników platformy Spark. Musi być jedną z następujących wartości: 4, 8, 16, 32, 64.
driverMemory	CustomPoolMemory	Pamięć sterownika platformy Spark.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Alokacja funkcji wykonawczej dynamicznej.
executorCores	integer (int32)	Rdzeń funkcji wykonawczej platformy Spark. Musi być jedną z następujących wartości: 4, 8, 16, 32, 64.
executorMemory	CustomPoolMemory	Pamięć funkcji wykonawczej platformy Spark.
instancePool	InstancePool	Pula środowisk musi być prawidłową pulą niestandardową. "Pula początkowa" oznacza użycie puli początkowej.
runtimeVersion	string	Wersja środowiska uruchomieniowego— znajdź obsługiwane środowiska uruchomieniowe sieci szkieletowej. Na przykład: 1.3
sparkProperties	SparkProperty[]	Właściwości platformy Spark.

ErrorRelatedResource

Objekt

Obiekt szczegółów zasobu powiązanego z błędem.

Nazwa	Typ	Opis
resourceId	string	Identyfikator zasobu, który jest zaangażowany w błąd.
resourceType	string	Typ zasobu, który jest zaangażowany w błąd.

ErrorResponse

Objekt

Odpowiedź na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
moreDetails	ErrorResponseDetails[]	Lista dodatkowych szczegółów błędu.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.
requestId	string	Identyfikator żądania skojarzonego z błędem.

ErrorResponseDetails

Objekt

Szczegóły odpowiedzi na błąd.

Nazwa	Typ	Opis
errorCode	string	Określony identyfikator, który zawiera informacje o stanie błędu, co pozwala na ustandaryzowaną komunikację między naszą usługą a jej użytkownikami.
message	string	Czytelna reprezentacja błędu przez człowieka.
relatedResource	ErrorRelatedResource	Szczegóły zasobu powiązanego z błędem.

InstancePool

Objekt

Wystąpienie puli.

Nazwa	Typ	Opis
id	string (uuid)	Identyfikator puli wystąpień.
name	string	Nazwa puli wystąpień.
type	CustomPoolType	Typ puli wystąpień.

SparkProperty

Objekt

Klucz właściwości platformy Spark i jego wartość.

Nazwa	Typ	Opis
key	string	Klucz właściwości platformy Spark.
value	string	Wartość właściwości Platformy Spark.

Udostępnij przez

Published - Get Spark Compute

Permissions

Wymagane zakresy delegowane

Tożsamości obsługiwane przez Microsoft Entra

Interfejs

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Get environment Spark compute example

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

CustomPoolMemory

CustomPoolType

DynamicExecutorAllocationProperties

EnvironmentSparkCompute

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

InstancePool

SparkProperty