Published - Get Spark Compute

Palvelu:: Environment

Ohjelmointirajapinnan versio:: v1

Hae ympäristön spark-käsittely.

Note

Tämä ohjelmointirajapinta on versio beetaversiosta, jonka on määrä vanhentua 31.3.2027. Kun kutsut tätä ohjelmointirajapintaa - soittajien on määritettävä kyselyparametri beta -arvoksi false

Käyttöoikeudet

Ympäristökohteen lukuoikeus.

Vaaditut delegoidut vaikutusalueet

Item.Read.All tai Item.ReadWrite.All tai Environment.Read.All tai Environment.ReadWrite.All

tuettujen käyttäjätietojen Microsoft Entra

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identity	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Kuvaus
environmentId	path	True	string (uuid)	Ympäristötunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.
beta	query	True	boolean	Tämä parametri määrittää, mitä ohjelmointirajapinnan versiota käytetään. Määritä käyttämään `false` julkaisuversiota.

Vastaukset

Nimi Tyyppi Kuvaus

200 OK

Nimi	Tyyppi	Kuvaus
200 OK	EnvironmentSparkCompute	Pyynnön valmistuttua.
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka `Retry-After` ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: UnknownError – Ilmeni virhe.

EnvironmentSparkCompute

Pyynnön valmistuttua.

429 Too Many Requests

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

UnknownError – Ilmeni virhe.

Esimerkit

Get environment Spark compute example

Mallipyyntö

HTTP

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

Mallivastaus

Tilakoodi:: 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"
  }
}

Määritelmät

Nimi	Kuvaus
CustomLivePoolSettings	Live-uima-altaan juoma-asetukset ympäristön spark-laskennan kohdalla.
CustomLivePoolSupport	Merkintä, joka määrittää, onko reaaliaikaisen varannon tuki aktiivinen. Lisäarvoja `CustomLivePoolSupport` voidaan lisätä ajan mittaan.
CustomPoolMemory	Mukautettu varannon muisti Spark-ohjaimelle tai Spark-suoritettavalle tiedostolle. Muita `CustomPoolMemory` tyyppejä voidaan lisätä ajan kuluessa.
CustomPoolType	Mukautettu varannon tyyppi. Muita `CustomPoolType` tyyppejä voidaan lisätä ajan kuluessa.
DynamicExecutorAllocationProperties	Dynaamisen suoritettavan tiedoston kohdistuksen proertiiveja.
EnvironmentSparkCompute
ErrorParameter	Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
InstancePool	Esiintymävaranto.
SparkProperty	Spark-ominaisuuden avain ja sen arvo.

CustomLivePoolSettings

Kohde

Live-uima-altaan juoma-asetukset ympäristön spark-laskennan kohdalla.

Nimi	Tyyppi	Kuvaus
clusterIdleTimeout	string (duration)	Käyttämättömyysajan raja-arvo, jonka jälkeen nesteytetty klusteri julkaistaan, käyttäen ISO 8601 -kestomuotoa. Pienin arvo: PT20M. Suurin arvo: PT24H.
customLivePoolLifespan	string (duration)	Reaaliaikaisen varannon aktivoinnin enimmäiskesto ISO 8601 -kestomuodossa. Reaaliaikainen varannon työ suoritetaan tälle kestolle, ja se päättyy. Pienin arvo: PT30M. Suurin arvo: PT24H.
maxClustersToHydrate	integer (int32) minimum: 1	Jokaisen aktivointijakson aikana hydraatteja esihydraatteja esihyytettävien klustereiden enimmäismäärä. Pienin arvo: 1. Kapasiteetin koko määrittää suurimman sallitun arvon, ja se näytetään esiintymävarannon asetuksissa muodossa `InstancePool.maxClustersToHydrateLimit`.

CustomLivePoolSupport

Luettelointi

Merkintä, joka määrittää, onko reaaliaikaisen varannon tuki aktiivinen. Lisäarvoja CustomLivePoolSupport voidaan lisätä ajan mittaan.

Arvo	Kuvaus
Enabled	Reaaliaikaisten varantojen tuki on aktiivinen.
Disabled	Live-varannon tuki ei ole käytössä. Määritys säilytetään.

CustomPoolMemory

Luettelointi

Mukautettu varannon muisti Spark-ohjaimelle tai Spark-suoritettavalle tiedostolle. Muita CustomPoolMemory tyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
28g	28 Gigatavua muistia.
56g	56G muistia.
112g	112G muistia.
224g	224G muistia.
400g	400 Gt muistia.

CustomPoolType

Luettelointi

Mukautettu varannon tyyppi. Muita CustomPoolType tyyppejä voidaan lisätä ajan kuluessa.

Arvo	Kuvaus
Workspace	Työtilatason mukautettu varanto
Capacity	Kapasiteettitason mukautettu varanto

DynamicExecutorAllocationProperties

Kohde

Dynaamisen suoritettavan tiedoston kohdistuksen proertiiveja.

Nimi	Tyyppi	Kuvaus
enabled	boolean	Dynaamisen suoritettavan tiedoston kohdistuksen tila. False – Ei käytössä, true – Käytössä.
maxExecutors	integer (int32) minimum: 1	Dynaamisen kohdistuksen suurin suoritettavan tiedoston numero ja tämän ominaisuuden vähimmäisarvo on 1. Suurimman arvon on oltava pienempi kuin esiintymävarannon `maxNodeCount`.
minExecutors	integer (int32) minimum: 1	Dynaamisen kohdistuksen pienin suoritusnumero ja tämän ominaisuuden vähimmäisarvo on 1. Suurimman arvon on oltava pienempi kuin `maxExecutors`.

EnvironmentSparkCompute

Kohde

Nimi	Tyyppi	Kuvaus
customLivePoolSettings	CustomLivePoolSettings	Live-uima-altaan juoma-asetukset. Määrittää, miten klustereita lisätään valmiiksi, kun reaaliaikaisen uima-altaan tuki on käytössä.
customLivePoolSupport	CustomLivePoolSupport	Määrittää, onko reaaliaikainen varanto käytössä. Kun `Enabled`, klusterit hydraatioasetusten mukaisesti esitäytetään niin, että kuormitukset alkavat ilman kylmäkäynnistysviivettä.
driverCores	integer (int32)	Spark-ohjaimen ydin. On oltava jokin seuraavista arvoista: 4, 8, 16, 32, 64.
driverMemory	CustomPoolMemory	Spark-ohjaimen muisti.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Dynaamisen suoritettavan tiedoston kohdistus.
executorCores	integer (int32)	Spark-suoritettavan tiedoston ydin. On oltava jokin seuraavista arvoista: 4, 8, 16, 32, 64.
executorMemory	CustomPoolMemory	Spark-suoritettavan tiedoston muisti.
instancePool	InstancePool	Ympäristövarannon on oltava kelvollinen mukautettu varanto. "Aloituspooli" tarkoittaa aloitusvarannon käyttämistä.
runtimeVersion	string	Runtime-versio, etsi tuetut fabric-suorituspalvelut. Esimerkki: 1.3
sparkProperties	SparkProperty[]	Spark-ominaisuudet.

ErrorParameter

Kohde

Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.

Nimi	Tyyppi	Kuvaus
message	string	Ihmisen luettavissa oleva kuvaus parametrin merkityksestä.
name	string	Parametritunniste.
value	string	Parametriarvo.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
isRetriable	boolean	Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon `Retry-After` avulla, jos se on käytettävissä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Kuvaus
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
parameters	ErrorParameter[]	Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

InstancePool

Kohde

Esiintymävaranto.

Nimi	Tyyppi	Kuvaus
id	string (uuid)	Esiintymävarannon tunnus.
maxClustersToHydrateLimit	integer (int32)	Reaaliaikaisen varannon `maxClustersToHydrate` asetuksen palvelinlaskenta, joka määräytyy tähän varantoon liittyvän kapasiteetin koon mukaan.
name	string	Esiintymävarannon nimi.
type	CustomPoolType	Esiintymävarannon tyyppi.

SparkProperty

Kohde

Spark-ominaisuuden avain ja sen arvo.

Nimi	Tyyppi	Kuvaus
key	string	Spark-ominaisuusavain.
value	string	Spark-ominaisuuden arvo.