Partilhar via

Custom Pools - Get Workspace Custom Pool

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

Obtenha uma piscina personalizada.

Permissões

O chamador deve ter visualizador ou superior função de espaço de trabalho.

Escopos delegados necessários

Workspace.Read.All ou Workspace.ReadWrite.All

Identidades suportadas pelo Microsoft Entra

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

Identidade Apoio
Utilizador Sim
da entidade de serviço e identidades gerenciadas Sim

Interfaz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/spark/pools/{poolId}

Parâmetros do URI

Name Em Necessário Tipo Description
poolId
 path True

string (uuid)

O ID do pool personalizado.
workspaceId
 path True

string (uuid)

O ID do espaço de trabalho.

Respostas

Name Tipo Description
200 OK

CustomPool

Pedido concluído com sucesso.
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • UnknownError - Ocorreu um erro.

Exemplos

Get custom pool example

Pedido de amostra

GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/spark/pools/2367293d-b70b-4b33-97f2-161b8d04a8d7

Resposta da amostra

Código de estado:
200 
{
  "id": "2367293d-b70b-4b33-97f2-161b8d04a8d7",
  "name": "pool1",
  "type": "Workspace",
  "nodeFamily": "MemoryOptimized",
  "nodeSize": "Small",
  "autoScale": {
    "enabled": true,
    "minNodeCount": 1,
    "maxNodeCount": 4
  },
  "dynamicExecutorAllocation": {
    "enabled": true,
    "minExecutors": 1,
    "maxExecutors": 2
  }
}

Definições

Name Description
AutoScaleProperties

Propriedades de dimensionamento automático.
CustomPool

Piscina personalizada.
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.
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
NodeFamily

Família de nós. Tipos de NodeFamily adicionais podem ser adicionados ao longo do tempo.
NodeSize

Tamanho do nó. Tipos de NodeSize adicionais podem ser adicionados ao longo do tempo.

AutoScaleProperties

Object

Propriedades de dimensionamento automático.

Name Tipo Description
enabled

boolean

O status da escala automática. Falso - Desativado, verdadeiro - Ativado.
maxNodeCount

integer (int32)

minimum: 1

A contagem máxima de nós.
minNodeCount

integer (int32)

minimum: 1

A contagem mínima de nós.

CustomPool

Object

Piscina personalizada.

Name Tipo Description
autoScale

AutoScaleProperties

Dimensionamento Automático.
dynamicExecutorAllocation

DynamicExecutorAllocationProperties

Alocação dinâmica do executor.
id

string (uuid)

ID do pool personalizado.
name

string

Nome do pool personalizado.
nodeFamily

NodeFamily

Família de nós.
nodeSize

NodeSize

Tamanho do nó.
type

CustomPoolType

Tipo de pool personalizado.

CustomPoolType

Enumeração

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

Valor Description
Workspace

Pool personalizado no nível do espaço de trabalho
Capacity

Pool personalizado de nível 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

Os executores máximos.
minExecutors

integer (int32)

minimum: 1

Os executores mínimos.

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.

NodeFamily

Enumeração

Família de nós. Tipos de NodeFamily adicionais podem ser adicionados ao longo do tempo.

Valor Description
MemoryOptimized

Memória otimizada

NodeSize

Enumeração

Tamanho do nó. Tipos de NodeSize adicionais podem ser adicionados ao longo do tempo.

Valor Description
Small

Tamanho pequeno do nó
Medium

Tamanho médio do nó
Large

Tamanho grande do nó
XLarge

Tamanho do nó XLarge
XXLarge

Tamanho do nó XXLarge