Items - Update Environment Definition

Service:: Environment

Version d'API:: v1

Remplace la définition de l’environnement spécifié.
Cette API prend en charge opérations longues (LRO).

La mise à jour de la définition de l’environnement n’affecte pas son étiquette de confidentialité.

Permissions

L’appelant doit disposer d’autorisations de lecture et d’écriture pour l’environnement.

Étendues déléguées requises

Environment.ReadWrite.All ou Item.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identité	Support
Utilisateur	Oui
Service principal et identités gérées	Oui

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/updateDefinition

Avec des paramètres facultatifs:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/updateDefinition?updateMetadata={updateMetadata}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
environmentId	path	True	string (uuid)	ID d’environnement.
workspaceId	path	True	string (uuid)	Identifiant de l’espace de travail.
updateMetadata	query		boolean	Lorsque la valeur est true et que le fichier .platform est fourni dans le cadre de la définition, les métadonnées de l’élément sont mises à jour à l’aide des métadonnées dans le fichier .platform

Corps de la demande

Nom	Obligatoire	Type	Description
definition	True	EnvironmentDefinition	Objet de définition publique d’environnement. Pour plus d’informations sur la création d’une définition publique d’environnement, consultez cet article .

Réponses

Nom	Type	Description
200 OK		La demande s’est terminée avec succès.
202 Accepted		Demande acceptée. La définition de mise à jour est en cours. En-têtes Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Codes d’erreur courants : OperationNotSupportedForItem : opération non prise en charge pour l’élément demandé. CorruptedPayload : la charge utile fournie est endommagée.

Nom

Type

Description

200 OK

La demande s’est terminée avec succès.

202 Accepted

Demande acceptée. La définition de mise à jour est en cours.

En-têtes

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Codes d’erreur courants :

OperationNotSupportedForItem : opération non prise en charge pour l’élément demandé.
CorruptedPayload : la charge utile fournie est endommagée.

Exemples

Update a environment definition example

Exemple de requête

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "Libraries/CustomLibraries/samplelibrary.jar",
        "payload": "eyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/samplepython.py",
        "payload": "FyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/samplewheel-0.18.0-py2.py3-none-any.whl",
        "payload": "LyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/CustomLibraries/sampleR.tar.gz",
        "payload": "ZyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Libraries/PublicLibraries/environment.yml",
        "payload": "IyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": "Setting/Sparkcompute.yml",
        "payload": "GyJuYmZvcm1hdCI6N..",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Exemple de réponse

Code d’état:: 200

Code d’état:: 202

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Définitions

Nom	Description
EnvironmentDefinition	Objet de définition publique d’environnement. Pour plus d’informations sur la création d’une définition publique d’environnement, consultez cet article .
EnvironmentDefinitionPart	Objet de partie définition d’environnement.
ErrorRelatedResource	Objet de détails de ressource associé à l’erreur.
ErrorResponse	Réponse d’erreur.
ErrorResponseDetails	Détails de la réponse d’erreur.
PayloadType	Type de la charge utile du composant de définition. Des types de charge utile supplémentaires peuvent être ajoutés au fil du temps.
UpdateEnvironmentDefinitionRequest	Mettre à jour la charge utile de demande de définition publique de l’environnement.

EnvironmentDefinition

Object

Objet de définition publique d’environnement. Pour plus d’informations sur la création d’une définition publique d’environnement, consultez cet article .

Nom	Type	Description
format	string	Format de la définition d’environnement.
parts	EnvironmentDefinitionPart[]	Liste des parties de définition.

EnvironmentDefinitionPart

Object

Objet de partie définition d’environnement.

Nom	Type	Description
path	string	Chemin d’accès de la partie environnement.
payload	string	Charge utile de la partie environnement.
payloadType	PayloadType	Type de charge utile.

ErrorRelatedResource

Object

Objet de détails de ressource associé à l’erreur.

Nom	Type	Description
resourceId	string	ID de ressource impliqué dans l’erreur.
resourceType	string	Type de la ressource impliquée dans l’erreur.

ErrorResponse

Object

Réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
moreDetails	ErrorResponseDetails[]	Liste des détails d’erreur supplémentaires.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.
requestId	string	ID de la demande associée à l’erreur.

ErrorResponseDetails

Object

Détails de la réponse d’erreur.

Nom	Type	Description
errorCode	string	Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message	string	Représentation lisible humaine de l’erreur.
relatedResource	ErrorRelatedResource	Détails de la ressource associée à l’erreur.

PayloadType

Énumération

Type de la charge utile du composant de définition. Des types de charge utile supplémentaires peuvent être ajoutés au fil du temps.

Valeur	Description
InlineBase64	Base 64 inline.

UpdateEnvironmentDefinitionRequest

Object

Mettre à jour la charge utile de demande de définition publique de l’environnement.

Nom	Type	Description
definition	EnvironmentDefinition	Objet de définition publique d’environnement. Pour plus d’informations sur la création d’une définition publique d’environnement, consultez cet article .

Partager via

Items - Update Environment Definition

Permissions

Étendues déléguées requises

Identités prises en charge par Microsoft Entra

Interface

Paramètres URI

Corps de la demande

Réponses

Exemples

Update a environment definition example

Exemple de requête

Exemple de réponse

Définitions

EnvironmentDefinition

EnvironmentDefinitionPart

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

PayloadType

UpdateEnvironmentDefinitionRequest