Published - Get Spark Compute

Servizio:

Environment

Versione API:

v1

Ottenere il calcolo spark dell'ambiente.

Annotazioni

Questa API è una versione di rilascio di una versione beta a causa della deprecazione del 1° marzo 2026. Quando si chiama questa API, i chiamanti devono impostare il parametro beta di query sul valore false

Permissions

Autorizzazione di lettura per l'elemento dell'ambiente.

Ambiti delegati obbligatori

Item.Read.All o Item.ReadWrite.All o Environment.Read.All o Environment.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interfaccia

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
environmentId	path	True	string (uuid)	ID ambiente.
workspaceId	path	True	string (uuid)	L’ID dell’area di lavoro.
beta	query	True	boolean	Questo parametro specifica la versione dell'API da usare. Impostare su false per usare la versione di rilascio.

Risposte

Nome	Tipo	Descrizione
200 OK	EnvironmentSparkCompute	Richiesta completata correttamente.
Other Status Codes	ErrorResponse	Codici di errore comuni: UnknownError: si è verificato un errore.

Esempio

Get environment Spark compute example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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"
}

Definizioni

Nome	Descrizione
CustomPoolMemory	Memoria del pool personalizzata per il driver Spark o l'executor Spark. È possibile aggiungere altri tipi di CustomPoolMemory nel tempo.
CustomPoolType	Tipo di pool personalizzato. È possibile aggiungere altri tipi di CustomPoolType nel tempo.
DynamicExecutorAllocationProperties	Proerità di allocazione dell'executor dinamico.
EnvironmentSparkCompute
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
InstancePool	Istanza di un pool.
SparkProperty	Una chiave della proprietà Spark e il relativo valore.

CustomPoolMemory

Enumerazione

Memoria del pool personalizzata per il driver Spark o l'executor Spark. È possibile aggiungere altri tipi di CustomPoolMemory nel tempo.

Valore	Descrizione
28g	28 GB di memoria.
56g	Memoria 56G.
112g	Memoria 112G.
224g	Memoria 224G.
400g	Memoria 400G.

CustomPoolType

Enumerazione

Tipo di pool personalizzato. È possibile aggiungere altri tipi di CustomPoolType nel tempo.

Valore	Descrizione
Workspace	Pool personalizzato dell'area di lavoro
Capacity	Pool personalizzato di capacità

DynamicExecutorAllocationProperties

Oggetto

Proerità di allocazione dell'executor dinamico.

Nome	Tipo	Descrizione
enabled	boolean	Stato dell'allocazione dell'executor dinamico. False - Disabilitato, true - Abilitato.
maxExecutors	integer (int32) minimum: 1	Il numero massimo di executor per l'allocazione dinamica e il valore minimo per questa proprietà è 1. Il valore massimo deve essere inferiore al pool maxNodeCountdi istanze .
minExecutors	integer (int32) minimum: 1	Il numero minimo di executor per l'allocazione dinamica e il minimo per questa proprietà è 1. Il valore massimo deve essere inferiore a maxExecutors.

EnvironmentSparkCompute

Oggetto

Nome	Tipo	Descrizione
driverCores	integer (int32)	Core del driver Spark. Deve essere uno dei valori seguenti: 4, 8, 16, 32, 64.
driverMemory	CustomPoolMemory	Memoria del driver Spark.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Allocazione dell'executor dinamico.
executorCores	integer (int32)	Core dell'executor Spark. Deve essere uno dei valori seguenti: 4, 8, 16, 32, 64.
executorMemory	CustomPoolMemory	Memoria dell'executor Spark.
instancePool	InstancePool	Il pool di ambiente deve essere un pool personalizzato valido. "Pool di avvio" significa usare il pool di avvio.
runtimeVersion	string	Versione di runtime, trovare i runtime dell'infrastruttura supportati. Ad esempio: 1.3
sparkProperties	SparkProperty[]	Proprietà di Spark.

ErrorRelatedResource

Oggetto

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

InstancePool

Oggetto

Istanza di un pool.

Nome	Tipo	Descrizione
id	string (uuid)	ID pool di istanze.
name	string	Nome del pool di istanze.
type	CustomPoolType	Tipo di pool di istanze.

SparkProperty

Oggetto

Una chiave della proprietà Spark e il relativo valore.

Nome	Tipo	Descrizione
key	string	Chiave della proprietà Spark.
value	string	Valore della proprietà Spark.