Compartilhar via

Published - Get Spark Compute

Serviço:
Environment
Versão da API:
v1

Obter computação do Spark de ambiente.

Observação

Essa API é uma versão de lançamento de uma versão beta que deve ser preterida em 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 Leitura para o item de ambiente.

Escopos delegados necessários

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

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identidade Support
Utilizador Yes
Entidade de serviço e identidades gerenciadas Yes

Interfase

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
environmentId
 path True

string (uuid)

A ID do ambiente.
workspaceId
 path True

string (uuid)

O identificador do espaço de trabalho.
beta
 query True

boolean

Esse parâmetro especifica qual versão da API usar. Defina para false usar a versão de versão.

Respostas

Nome Tipo Description
200 OK

EnvironmentSparkCompute

Solicitação concluída com êxito.
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • UnknownError – Ocorreu um erro.

Exemplos

Get environment Spark compute example

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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

Nome Description
CustomPoolMemory

Memória do pool personalizada para o driver spark ou o executor do 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

Proeridades de alocação do 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 do pool personalizada para o driver spark ou o executor do Spark. Tipos de CustomPoolMemory adicionais podem ser adicionados ao longo do tempo.

Valor Description
28g

Memória de 28 GB.
56g

Memória de 56G.
112g

Memória 112G.
224g

Memória 224G.
400g

Memória de 400G.

CustomPoolType

Enumeração

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

Valor Description
Workspace

Pool personalizado do workspace
Capacity

Pool personalizado de capacidade

DynamicExecutorAllocationProperties

Objeto

Proeridades de alocação do executor dinâmico.

Nome Tipo Description
enabled

boolean

O status da alocação do executor dinâmico. False – Desabilitado, verdadeiro – Habilitado.
maxExecutors

integer (int32)

minimum: 1

O número máximo do executor para alocação dinâmica e o mínimo para essa propriedade é 1. O valor máximo deve ser menor que o pool de instâncias maxNodeCount.
minExecutors

integer (int32)

minimum: 1

O número mínimo do executor para alocação dinâmica e o mínimo para essa propriedade é 1. O valor máximo deve ser menor que maxExecutors.

EnvironmentSparkCompute

Objeto
Nome Tipo Description
driverCores

integer (int32)

Núcleo do driver spark. Deve ser um dos seguintes valores: 4, 8, 16, 32, 64.
driverMemory

CustomPoolMemory

Memória do driver spark.
dynamicExecutorAllocation

DynamicExecutorAllocationProperties

Alocação de executor dinâmico.
executorCores

integer (int32)

Núcleo do executor do Spark. Deve ser um dos seguintes valores: 4, 8, 16, 32, 64.
executorMemory

CustomPoolMemory

Memória do executor do Spark.
instancePool

InstancePool

O pool de ambientes deve ser um pool personalizado válido. "Pool inicial" significa usar o pool inicial.
runtimeVersion

string

Versão de runtime, localize os runtimes de malha com suporte. Por exemplo: 1.3
sparkProperties

SparkProperty[]

Propriedades do Spark.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

Nome Tipo Description
resourceId

string

A ID do recurso envolvida no erro.
resourceType

string

O tipo do recurso envolvido no erro.

ErrorResponse

Objeto

A resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.

InstancePool

Objeto

Uma instância de um pool.

Nome 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

Objeto

Uma chave de propriedade Spark e seu valor.

Nome Tipo Description
key

string

A chave de propriedade do Spark.
value

string

O valor da propriedade Spark.