Compartir a través de

Published - Get Spark Compute

Servicio:
Environment
Versión de la API:
v1

Obtenga el proceso de Spark del entorno.

Nota:

Esta API es una versión de lanzamiento de una versión beta debido a que está en desuso el 1 de marzo de 2026. Al llamar a esta API: los autores de llamadas deben establecer el parámetro beta de consulta en el valor. false

Permissions

Permiso de lectura para el elemento de entorno.

Ámbitos delegados necesarios

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

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

identidad Support
Usuario Sí
Entidad de servicio e Identidades administradas Sí

Interfaz

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
environmentId
 path True

string (uuid)

Identificador de entorno.
workspaceId
 path True

string (uuid)

El identificador del área de trabajo.
beta
 query True

boolean

Este parámetro especifica la versión de la API que se va a usar. Establézcalo en false para usar la versión de lanzamiento.

Respuestas

Nombre Tipo Description
200 OK

EnvironmentSparkCompute

Solicitud completada correctamente.
Other Status Codes

ErrorResponse

Códigos de error comunes:

  • UnknownError: se produjo un error.

Ejemplos

Get environment Spark compute example

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
CustomPoolMemory

Memoria de grupo personalizada para el controlador de Spark o el ejecutor de Spark. Se pueden agregar tipos de CustomPoolMemory adicionales a lo largo del tiempo.
CustomPoolType

Tipo de grupo personalizado. Se pueden agregar tipos de CustomPoolType adicionales a lo largo del tiempo.
DynamicExecutorAllocationProperties

Proerties de asignación del ejecutor dinámico.
EnvironmentSparkCompute
ErrorRelatedResource

Objeto de detalles del recurso relacionado con el error.
ErrorResponse

Respuesta de error.
ErrorResponseDetails

Detalles de la respuesta de error.
InstancePool

Instancia de un grupo.
SparkProperty

Clave de propiedad de Spark y su valor.

CustomPoolMemory

Enumeración

Memoria de grupo personalizada para el controlador de Spark o el ejecutor de Spark. Se pueden agregar tipos de CustomPoolMemory adicionales a lo largo del tiempo.

Valor Description
28g

28 GB de memoria.
56g

56G de memoria.
112g

112G de memoria.
224g

224G de memoria.
400g

400G de memoria.

CustomPoolType

Enumeración

Tipo de grupo personalizado. Se pueden agregar tipos de CustomPoolType adicionales a lo largo del tiempo.

Valor Description
Workspace

Grupo personalizado del área de trabajo
Capacity

Grupo personalizado de capacidad

DynamicExecutorAllocationProperties

Objeto

Proerties de asignación del ejecutor dinámico.

Nombre Tipo Description
enabled

boolean

Estado de la asignación dinámica del ejecutor. False: deshabilitado, true: habilitado.
maxExecutors

integer (int32)

minimum: 1

El número máximo de ejecutor para la asignación dinámica y el mínimo para esta propiedad es 1. El valor máximo debe ser menor que el grupo maxNodeCountde instancias .
minExecutors

integer (int32)

minimum: 1

El número mínimo de ejecutor para la asignación dinámica y el mínimo para esta propiedad es 1. El valor máximo debe ser inferior maxExecutorsa .

EnvironmentSparkCompute

Objeto
Nombre Tipo Description
driverCores

integer (int32)

Núcleo del controlador de Spark. Debe ser uno de los siguientes valores: 4, 8, 16, 32, 64.
driverMemory

CustomPoolMemory

Memoria del controlador de Spark.
dynamicExecutorAllocation

DynamicExecutorAllocationProperties

Asignación dinámica del ejecutor.
executorCores

integer (int32)

Núcleo del ejecutor de Spark. Debe ser uno de los siguientes valores: 4, 8, 16, 32, 64.
executorMemory

CustomPoolMemory

Memoria del ejecutor de Spark.
instancePool

InstancePool

El grupo de entornos debe ser un grupo personalizado válido. "Grupo de inicio" significa usar el grupo de inicio.
runtimeVersion

string

Versión en tiempo de ejecución, busque los entornos de ejecución de tejido admitidos. Por ejemplo: 1.3
sparkProperties

SparkProperty[]

Propiedades de Spark.

ErrorRelatedResource

Objeto

Objeto de detalles del recurso relacionado con el error.

Nombre Tipo Description
resourceId

string

Identificador de recurso implicado en el error.
resourceType

string

Tipo del recurso implicado en el error.

ErrorResponse

Objeto

Respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
moreDetails

ErrorResponseDetails[]

Lista de detalles de error adicionales.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.
requestId

string

Identificador de la solicitud asociada al error.

ErrorResponseDetails

Objeto

Detalles de la respuesta de error.

Nombre Tipo Description
errorCode

string

Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message

string

Representación legible del error.
relatedResource

ErrorRelatedResource

Detalles del recurso relacionado con el error.

InstancePool

Objeto

Instancia de un grupo.

Nombre Tipo Description
id

string (uuid)

Identificador del grupo de instancias.
name

string

Nombre del grupo de instancias.
type

CustomPoolType

Tipo de grupo de instancias.

SparkProperty

Objeto

Clave de propiedad de Spark y su valor.

Nombre Tipo Description
key

string

Clave de propiedad de Spark.
value

string

Valor de la propiedad Spark.