Spark Compute - Update Staging Settings

Service:

Environment

API-versie:

v1

Notitie

Deze API is een preview-versie.

Werk spark-rekenkracht voor fasering van de omgeving bij. Als u een Spark-eigenschap wilt verwijderen, stelt u de waarde ervan in op null.

Machtigingen

Schrijfmachtiging voor het omgevingsitem.

Vereiste gedelegeerde bereiken

Environment.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Ondersteuning
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

gebruikersinterface

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/staging/sparkcompute

URI-parameters

Name	In	Vereist	Type	Description
environmentId	path	True	string (uuid)	De omgevings-id.
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

Name	Type	Description
driverCores	integer (int32)	Spark-stuurprogrammakern.
driverMemory	string	Spark-stuurprogrammageheugen.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Dynamische uitvoerdertoewijzing.
executorCores	integer (int32)	Spark-uitvoerderskern.
executorMemory	string	Spark-uitvoerprogrammageheugen.
instancePool	InstancePool	De omgevingsgroep moet een geldige aangepaste pool zijn. De naam voor een standaardwerkruimtegroep is Startersgroep.
runtimeVersion	string	Runtimeversie, zoek de ondersteunde fabric-runtimes. Bijvoorbeeld: 1.3
sparkProperties	object	Spark-eigenschappen.

Antwoorden

Name	Type	Description
200 OK	EnvironmentSparkCompute	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: UnknownError: er is een fout opgetreden.

Voorbeelden

Update environment staging spark compute example

Voorbeeldaanvraag

HTTP

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

{
  "instancePool": {
    "name": "MyWorkspacePool",
    "type": "Workspace"
  },
  "driverCores": 4,
  "driverMemory": "56g",
  "executorCores": 4,
  "executorMemory": "56g",
  "dynamicExecutorAllocation": {
    "enabled": false,
    "minExecutors": 1,
    "maxExecutors": 1
  },
  "sparkProperties": {
    "spark.acls.enable": "false",
    "spark.admin.acls": null
  },
  "runtimeVersion": "1.2"
}

Voorbeeldrespons

Statuscode:

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": {
    "spark.acls.enable": "false"
  },
  "runtimeVersion": "1.2"
}

Definities

Name	Description
CustomPoolType	Aangepast pooltype. Er kunnen in de loop van de tijd extra CustomPoolType typen worden toegevoegd.
DynamicExecutorAllocationProperties	Dynamische uitvoerprogrammatoewijzingsproxy's.
EnvironmentSparkCompute
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
InstancePool	Een exemplaar van een pool.
UpdateEnvironmentSparkComputeRequest

CustomPoolType

Inventarisatie

Aangepast pooltype. Er kunnen in de loop van de tijd extra CustomPoolType typen worden toegevoegd.

Waarde	Description
Capacity	Aangepaste capaciteitspool
Workspace	Aangepaste werkruimtegroep

DynamicExecutorAllocationProperties

Object

Dynamische uitvoerprogrammatoewijzingsproxy's.

Name	Type	Description
enabled	boolean	De status van de dynamische uitvoerderstoewijzing. False - Disabled, true - Enabled.
maxExecutors	integer (int32) minimum: 1	Het maximum aantal uitvoerders voor dynamische toewijzing en het minimum voor deze eigenschap is 1
minExecutors	integer (int32) minimum: 1	Het minimale uitvoerdernummer voor dynamische toewijzing en het minimum voor deze eigenschap is 1.

EnvironmentSparkCompute

Object

Name	Type	Description
driverCores	integer (int32)	Spark-stuurprogrammakern.
driverMemory	string	Spark-stuurprogrammageheugen.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Dynamische uitvoerdertoewijzing.
executorCores	integer (int32)	Spark-uitvoerderskern.
executorMemory	string	Spark-uitvoerprogrammageheugen.
instancePool	InstancePool	De omgevingsgroep moet een geldige aangepaste pool zijn. "Starter pool" betekent het gebruik van starterspool.
runtimeVersion	string	Runtimeversie, zoek de ondersteunde fabric-runtimes. Bijvoorbeeld: 1.3
sparkProperties	object	Spark-eigenschappen.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

InstancePool

Object

Een exemplaar van een pool.

Name	Type	Description
id	string (uuid)	Exemplaargroep-id.
name	string	Naam van exemplaargroep.
type	CustomPoolType	Type exemplaargroep.

UpdateEnvironmentSparkComputeRequest

Object

Name	Type	Description
driverCores	integer (int32)	Spark-stuurprogrammakern.
driverMemory	string	Spark-stuurprogrammageheugen.
dynamicExecutorAllocation	DynamicExecutorAllocationProperties	Dynamische uitvoerdertoewijzing.
executorCores	integer (int32)	Spark-uitvoerderskern.
executorMemory	string	Spark-uitvoerprogrammageheugen.
instancePool	InstancePool	De omgevingsgroep moet een geldige aangepaste pool zijn. De naam voor een standaardwerkruimtegroep is Startersgroep.
runtimeVersion	string	Runtimeversie, zoek de ondersteunde fabric-runtimes. Bijvoorbeeld: 1.3
sparkProperties	object	Spark-eigenschappen.