Staging - Get Spark Compute

Servicio:: Environment

Versión de la API:: v1

Obtenga el proceso de Spark de ensayo del entorno.

Nota:

Esta API es una versión de lanzamiento de una versión beta debido a que está en desuso el 31 de agosto 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

Microsoft Entra identidades admitidas

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}/staging/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

Nombre	Tipo	Description
200 OK	EnvironmentSparkCompute	Solicitud completada correctamente.
429 Too Many Requests	ErrorResponse	Se superó el límite de frecuencia de servicio. El servidor devuelve un `Retry-After` encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales. Encabezados Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: UnknownError: se produjo un error.

EnvironmentSparkCompute

Solicitud completada correctamente.

429 Too Many Requests

ErrorResponse

Se superó el límite de frecuencia de servicio. El servidor devuelve un Retry-After encabezado que indica, en segundos, cuánto tiempo debe esperar el cliente antes de enviar solicitudes adicionales.

Encabezados

Retry-After: integer

Other Status Codes

ErrorResponse

Códigos de error comunes:

UnknownError: se produjo un error.

Ejemplos

Get environment staging spark compute example

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace",
    "id": "78942136-106c-4f3e-80fc-7ff4eae11603",
    "maxClustersToHydrateLimit": 10
  },
  "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",
  "customLivePoolSupport": "Enabled",
  "customLivePoolSettings": {
    "maxClustersToHydrate": 4,
    "clusterIdleTimeout": "PT20M",
    "customLivePoolLifespan": "PT1H"
  }
}

Definiciones

Nombre	Description
CustomLivePoolSettings	Configuración de hidratación del grupo activo en el proceso de Spark del entorno.
CustomLivePoolSupport	Marca que controla si la compatibilidad con grupos activos está activa. Se pueden agregar valores adicionales `CustomLivePoolSupport` a lo largo del tiempo.
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	El grupo de instancias.
SparkProperty	Clave de propiedad de Spark y su valor.

CustomLivePoolSettings

Objeto

Configuración de hidratación del grupo activo en el proceso de Spark del entorno.

Nombre	Tipo	Description
clusterIdleTimeout	string (duration)	Umbral de tiempo de inactividad después del cual se libera un clúster hidratado mediante el formato de duración ISO 8601. Mínimo: PT20M. Máximo: PT24H.
customLivePoolLifespan	string (duration)	Duración máxima de la activación de un grupo activo con el formato de duración ISO 8601. El trabajo del grupo activo se ejecuta durante esta duración y, a continuación, finaliza. Mínimo: PT30M. Máximo: PT24H.
maxClustersToHydrate	integer (int32) minimum: 1	Número máximo de clústeres que se van a hidratar previamente durante cada ciclo de activación. Mínimo: 1. El valor máximo permitido viene determinado por el tamaño de capacidad y se expone en la configuración del grupo de instancias como `InstancePool.maxClustersToHydrateLimit`.

CustomLivePoolSupport

Enumeración

Marca que controla si la compatibilidad con grupos activos está activa. Se pueden agregar valores adicionales CustomLivePoolSupport a lo largo del tiempo.

Valor	Description
Enabled	La compatibilidad con el grupo activo está activa.
Disabled	La compatibilidad con el grupo activo está inactiva. La configuración se conserva.

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 de nivel de área de trabajo
Capacity	Grupo personalizado de nivel 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 `maxNodeCount`de 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 `maxExecutors`a .

EnvironmentSparkCompute

Objeto

Nombre	Tipo	Description
customLivePoolSettings	CustomLivePoolSettings	Configuración de hidratación del grupo activo. Controla cómo se hidratan previamente los clústeres cuando se habilita la compatibilidad con grupos activos.
customLivePoolSupport	CustomLivePoolSupport	Controla si el grupo activo está habilitado. Cuando `Enabled`, los clústeres se hidratan previamente según la configuración de hidratación para que las cargas de trabajo se inicien sin latencia de arranque en frío.
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.
isRetriable	boolean	Cuando es true, se puede reintentar la solicitud. Use el `Retry-After` encabezado de respuesta para determinar el retraso, si está disponible.
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 (uuid)	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

El grupo de instancias.

Nombre	Tipo	Description
id	string (uuid)	Identificador del grupo de instancias.
maxClustersToHydrateLimit	integer (int32)	Límite superior calculado por el servidor para la configuración del grupo `maxClustersToHydrate` activo, determinado por el tamaño de capacidad asociado a este grupo.
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.