Items - Update Environment

Služba:

Environment

Verzia rozhrania API:

v1

Aktualizuje vlastnosti zadaného prostredia.

Povolenia

Volajúci musí mať povolenia na čítanie a zápis pre prostredie.

Povinné delegované rozsahy

Environment.ReadWrite.All alebo Item.ReadWrite.All

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identita	Podpora
Používateľ	Áno
Objekt služby a spravované identity	Áno

Rozhranie

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

Parametre URI

Name	V	Povinné	Typ	Description
environmentId	path	True	string (uuid)	ID prostredia.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Text požiadavky

Name	Typ	Description
description	string	Popis prostredia. Maximálna dĺžka je 256 znakov.
displayName	string	Zobrazovaný názov prostredia.

Odpovede

Name	Typ	Description
200 OK	Environment	Požiadavka sa úspešne dokončila.
Other Status Codes	ErrorResponse	Bežné kódy chýb: ItemNotFound – požadovaná položka sa nenašla. InvalidRequest – neplatná požiadavka na aktualizáciu

Príklady

Update a environment example

Vzorová požiadavka

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments/5b218778-e7a5-4d73-8187-f10824047715

{
  "displayName": "Environment_New_Name",
  "description": "A new description for environment."
}

Vzorová odpoveď

Kód stavu:

200

{
  "displayName": "Environment_New_Name",
  "description": "A new description for environment.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definície

Name	Description
ComponentPublishInfo	Publikujte informácie o jednotlivých súčastiach v prostredí.
Environment	Položka prostredia.
EnvironmentProperties	Vlastnosti prostredia.
EnvironmentPublishState	Stav publikovania. V priebehu času je možné pridať ďalšie typy stavov.
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
ItemTag	Predstavuje značku použitú na položke.
ItemType	Typ položky. V priebehu času je možné pridať ďalšie typy položiek.
PublishDetails	Podrobnosti o operácii publikovania.
SparkLibraries	Knižnice Spark.
SparkSettings	Nastavenia spark.
UpdateEnvironmentRequest	Aktualizovať požiadavku na prostredie.

ComponentPublishInfo

Object

Publikujte informácie o jednotlivých súčastiach v prostredí.

Name	Typ	Description
sparkLibraries	SparkLibraries	Knižnice Spark publikuujú informácie.
sparkSettings	SparkSettings	Nastavenia Spark publikujte informácie.

Environment

Object

Položka prostredia.

Name	Typ	Description
description	string	Popis položky.
displayName	string	Zobrazovaný názov položky.
folderId	string (uuid)	ID priečinka.
id	string (uuid)	ID položky.
properties	EnvironmentProperties	Vlastnosti prostredia.
tags	ItemTag[]	Zoznam použitých značiek.
type	ItemType	Typ položky.
workspaceId	string (uuid)	ID pracovného priestoru.

EnvironmentProperties

Object

Vlastnosti prostredia.

Name	Typ	Description
publishDetails	PublishDetails	Podrobnosti o operácii publikovania prostredia.

EnvironmentPublishState

Enumerácia

Stav publikovania. V priebehu času je možné pridať ďalšie typy stavov.

Hodnota	Description
Success	Publikovanie prostredia je v stave úspechu.
Cancelled	Publikovanie prostredia je v stave zrušené.
Failed	Publikovanie prostredia je v stave neúspešných.
Cancelling	Publikovanie prostredia je v stave zrušenia.
Running	Publikovanie prostredia je v stave spustenia.
Waiting	Publikovanie prostredia čaká.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

ItemTag

Object

Predstavuje značku použitú na položke.

Name	Typ	Description
displayName	string	Názov značky.
id	string (uuid)	ID značky.

ItemType

Enumerácia

Typ položky. V priebehu času je možné pridať ďalšie typy položiek.

Hodnota	Description
Dashboard	Tabuľa služby PowerBI.
Report	Zostava PowerBI.
SemanticModel	Sémantický model PowerBI.
PaginatedReport	Stránkovaná zostava služby PowerBI.
Datamart	Údajový diagram služby PowerBI.
Lakehouse	Jazero.
Eventhouse	Eventhouse.
Environment	Prostredie.
KQLDatabase	Databáza KQL.
KQLQueryset	Množina dotazov KQL.
KQLDashboard	Tabuľa KQL.
DataPipeline	Kanál údajov.
Notebook	Poznámkový blok.
SparkJobDefinition	Definícia úlohy iskry.
MLExperiment	Experiment strojového učenia.
MLModel	Model strojového učenia.
Warehouse	Sklad.
Eventstream	Udalosť eventstream.
SQLEndpoint	Koncový bod SQL.
MirroredWarehouse	Zrkadlový sklad.
MirroredDatabase	Zrkadlová databáza.
Reflex	A Reflex.
GraphQLApi	Rozhranie API pre položku GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Databáza SQLDatabase.
CopyJob	Kopírovať úlohu.
VariableLibrary	A VariableLibrary.
Dataflow	Tok údajov.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Snímka skladu.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Digitálny postup Twin Buildera.
MirroredAzureDatabricksCatalog	Zrkadlový katalóg Azure databricks.
Map	Mapa.
AnomalyDetector	Detektor anomálií.
UserDataFunction	Funkcia user data function.
GraphModel	A GraphModel.
GraphQuerySet	Množina dotazov Graphu.
SnowflakeDatabase	Databáza Snowflake na ukladanie tabuliek ľadovec vytvorených z konta Snowflake.
OperationsAgent	OperationsAgent (Operácia).
CosmosDBDatabase	Databáza Cosmos DB.
Ontology	Ontológia.
EventSchemaSet	Množina schém udalosti.

PublishDetails

Object

Podrobnosti o operácii publikovania.

Name	Typ	Description
componentPublishInfo	ComponentPublishInfo	Súčasť prostredia publikuje informácie.
endTime	string (date-time)	Čas ukončenia operácie publikovania v UTC pomocou formátu RRRR-MM-DDTHH:mm:sssssZ.
startTime	string (date-time)	Čas začatia operácie publikovania v UTC pomocou formátu RRRR-MM-DDTHH:mm:sssssZ.
state	EnvironmentPublishState	Stav publikovania. V priebehu času je možné pridať ďalšie typy stavov.
targetVersion	string (uuid)	Cieľová verion, ktorá sa má publikovať.

SparkLibraries

Object

Knižnice Spark.

Name	Typ	Description
state	EnvironmentPublishState	Stav publikovania. V priebehu času je možné pridať ďalšie typy stavov.

SparkSettings

Object

Nastavenia spark.

Name	Typ	Description
state	EnvironmentPublishState	Stav publikovania. V priebehu času je možné pridať ďalšie typy stavov.

UpdateEnvironmentRequest

Object

Aktualizovať požiadavku na prostredie.

Name	Typ	Description
description	string	Popis prostredia. Maximálna dĺžka je 256 znakov.
displayName	string	Zobrazovaný názov prostredia.