Published - Get Spark Compute

Serviço:: Environment

Versão da API:: v1

Obtenha computação de faísca do ambiente.

Observação

Esta API é uma versão de lançamento de uma versão beta, prevista para ser descontinuada a 1 de março de 2026. Ao chamar essa API - os chamadores devem definir o parâmetro beta de consulta como o valor false

Permissions

permissão de Ler para o item ambiente.

Escopos delegados necessários

Item.Read.All ou Item.ReadWrite.All ou Environment.Read.All ou Environment.ReadWrite.All

Identidades suportadas pelo Entra da Microsoft

Esta API suporta as identidades do Microsoft listadas nesta secção.

Identidade	Support
User	Yes
Entidade de serviço e identidades geridas	Yes

Interfaz

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
environmentId	path	True	string (uuid)	O ID do ambiente.
workspaceId	path	True	string (uuid)	O ID do espaço de trabalho.
beta	query	True	boolean	Este parâmetro especifica qual versão da API deve ser usada. Defina para `false` usar a versão de lançamento.

Respostas

Name	Tipo	Description
200 OK	EnvironmentSparkCompute	Pedido concluído com sucesso.
Other Status Codes	ErrorResponse	Códigos de erro comuns: UnknownError - Ocorreu um erro.

Name

Tipo

Description

200 OK

EnvironmentSparkCompute

Pedido concluído com sucesso.

Other Status Codes

ErrorResponse

Códigos de erro comuns:

UnknownError - Ocorreu um erro.

Exemplos

Get environment Spark compute example

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:: 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"
}

Definições

Name	Description
CustomPoolMemory	Memória de pool personalizada para driver Spark ou executor Spark. Tipos de `CustomPoolMemory` adicionais podem ser adicionados ao longo do tempo.
CustomPoolType	Tipo de pool personalizado. Tipos de `CustomPoolType` adicionais podem ser adicionados ao longo do tempo.
DynamicExecutorAllocationProperties	Proerties de alocação de executor dinâmico.
EnvironmentSparkCompute
ErrorRelatedResource	O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse	A resposta de erro.
ErrorResponseDetails	Os detalhes da resposta de erro.
InstancePool	Uma instância de um pool.
SparkProperty	Uma chave de propriedade Spark e seu valor.

CustomPoolMemory

Enumeração

Memória de pool personalizada para driver Spark ou executor Spark. Tipos de CustomPoolMemory adicionais podem ser adicionados ao longo do tempo.

Valor	Description
28g	28GB de memória.
56g	Memória 56G.
112g	Memória 112G.
224g	Memória 224G.
400g	400G de memória.

CustomPoolType

Enumeração

Tipo de pool personalizado. Tipos de CustomPoolType adicionais podem ser adicionados ao longo do tempo.

Valor	Description
Workspace	Pool personalizado do espaço de trabalho
Capacity	Pool personalizado de capacidade

DynamicExecutorAllocationProperties

Object

Proerties de alocação de executor dinâmico.

Name	Tipo	Description
enabled	boolean	O status da alocação do executor dinâmico. Falso - Desativado, verdadeiro - Ativado.
maxExecutors	integer (int32) minimum: 1	O número máximo do executor para alocação dinâmica e o mínimo para esta propriedade é 1. O valor máximo deve ser menor do que o pool de instâncias `maxNodeCount`.
minExecutors	integer (int32) minimum: 1	O número mínimo de executor para alocação dinâmica e o mínimo para esta propriedade é 1. O valor máximo tem de ser inferior a `maxExecutors`.

EnvironmentSparkCompute

Object

Name	Tipo	Description
driverCores	integer (int32)	Núcleo do driver de faísca. Deve ser um dos seguintes valores: 4, 8, 16, 32, 64.
driverMemory	CustomPoolMemory	Memória do driver de faísca.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Alocação dinâmica do executor.
executorCores	integer (int32)	Núcleo do executor de faísca. Deve ser um dos seguintes valores: 4, 8, 16, 32, 64.
executorMemory	CustomPoolMemory	Memória do executor Spark.
instancePool	InstancePool	O pool de ambiente deve ser um pool personalizado válido. "Starter Pool" significa usar o starter pool.
runtimeVersion	string	Versão de tempo de execução, localize os tempos de execução de malha suportados. Por exemplo: 1.3
sparkProperties	SparkProperty[]	Propriedades de faísca.

ErrorRelatedResource

Object

O objeto de detalhes do recurso relacionado ao erro.

Name	Tipo	Description
resourceId	string	A ID do recurso envolvida no erro.
resourceType	string	O tipo de recurso envolvido no erro.

ErrorResponse

Object

A resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
moreDetails	ErrorResponseDetails[]	Lista de detalhes de erro adicionais.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.
requestId	string	ID da solicitação associada ao erro.

ErrorResponseDetails

Object

Os detalhes da resposta de erro.

Name	Tipo	Description
errorCode	string	Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários.
message	string	Uma representação legível por humanos do erro.
relatedResource	ErrorRelatedResource	Os detalhes do recurso relacionados ao erro.

InstancePool

Object

Uma instância de um pool.

Name	Tipo	Description
id	string (uuid)	ID do pool de instâncias.
name	string	Nome do pool de instâncias.
type	CustomPoolType	Tipo de pool de instâncias.

SparkProperty

Object

Uma chave de propriedade Spark e seu valor.

Name	Tipo	Description
key	string	A chave de propriedade do Spark.
value	string	O valor da propriedade Spark.

Partilhar via

Published - Get Spark Compute

Permissions

Escopos delegados necessários

Identidades suportadas pelo Entra da Microsoft

Interfaz

Parâmetros do URI

Respostas

Exemplos

Get environment Spark compute example

Pedido de amostra

Resposta da amostra

Definições

CustomPoolMemory

CustomPoolType

DynamicExecutorAllocationProperties

EnvironmentSparkCompute

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

InstancePool

SparkProperty