Items - Create Environment

Szolgáltatás:: Environment

API-verzió:: v1

Létrehoz egy környezetet a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Engedélyek

A hívónak közreműködői munkaterületi szerepkörrel kell rendelkeznie.

Kötelező delegált hatókörök

Environment.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

Környezet létrehozásához a munkaterületnek támogatott Fabric kapacitáson kell lennie.

Microsoft Entra támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft dentitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatás-princípium és felügyelt identitások	Igen

Interfész

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérelem törzse

Name	Kötelező	Típus	Description
displayName	True	string	A környezet megjelenítendő neve.
definition		EnvironmentDefinition	A környezet nyilvános definíciója.
description		string	A környezet leírása. A maximális hossz 256 karakter.
folderId		string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, a környezet a munkaterülettel jön létre mappaként.
sensitivityLabelSettings		SensitivityLabelSettings	A környezet bizalmassági címkebeállításai.

Válaszok

Name	Típus	Description
201 Created	Environment	Sikeresen létrehozva
202 Accepted		A kérelem elfogadva, a környezet kiépítése folyamatban van Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy `Retry-After` fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: InvalidItemType – Az elem típusa érvénytelen ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van CorruptedPayload – A megadott hasznos adatok sérültek. WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create an environment example

Create an environment with public definition example

Create an environment example

Mintakérelem

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments

{
  "displayName": "Environment_1",
  "description": "An environment description."
}

Mintaválasz

Állapotkód:: 201

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Állapotkód:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create an environment with public definition example

Mintakérelem

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "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"
      }
    ]
  }
}

Mintaválasz

Állapotkód:: 201

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Állapotkód:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definíciók

Name	Description
ComponentPublishInfo	A környezet minden összetevőjének adatainak közzététele.
CreateEnvironmentRequest	Környezeti kérelem hasznos adatainak létrehozása.
EntireTenantPrincipal	Bérlői tagot jelöl
Environment	Környezeti elem.
EnvironmentDefinition	Környezeti nyilvános definíciós objektum. A környezetdefiníció szerkezetével kapcsolatos további részletekért tekintse meg ezt a cikket .
EnvironmentDefinitionPart	Környezetdefiníciós részobjektum.
EnvironmentProperties	Környezeti tulajdonságok.
EnvironmentPublishState	Közzétételi állapot. Idővel további állapottípusok is hozzáadhatók.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
GroupPrincipal	Biztonsági csoportot jelöl.
GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.
ItemTag	Egy elemre alkalmazott címkét jelöl.
ItemType	Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType	A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
PublishDetails	A közzétételi művelet részletei.
SensitivityLabel	Egy elemre alkalmazott bizalmassági címkét jelöl.
SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.
SensitivityLabelSettings	A bizalmassági címke beállításai.
ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
ServicePrincipalPrincipal	Egy Microsoft Entra szolgáltatásnevet jelöl.
ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Szolgáltatásnév-profilt jelöl.
SparkLibraries	Spark-kódtárak.
SparkSettings	Spark-beállítások.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.
UserPrincipal	Egy Microsoft Entra felhasználónevet jelöl.

ComponentPublishInfo

Tárgy

A környezet minden összetevőjének adatainak közzététele.

Name	Típus	Description
sparkLibraries	SparkLibraries	A Spark-kódtárak információkat tesznek közzé.
sparkSettings	SparkSettings	A Spark beállításai közzéteszik az információkat.

CreateEnvironmentRequest

Tárgy

Környezeti kérelem hasznos adatainak létrehozása.

Name	Típus	Description
definition	EnvironmentDefinition	A környezet nyilvános definíciója.
description	string	A környezet leírása. A maximális hossz 256 karakter.
displayName	string	A környezet megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója. Ha nincs megadva vagy null, a környezet a munkaterülettel jön létre mappaként.
sensitivityLabelSettings	SensitivityLabelSettings	A környezet bizalmassági címkebeállításai.

EntireTenantPrincipal

Tárgy

Bérlői tagot jelöl

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: EntireTenant	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Environment

Tárgy

Környezeti elem.

Name	Típus	Description
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Az elem alapértelmezett identitása.
description	string	Az elem leírása.
displayName	string	Az elem megjelenítendő neve.
folderId	string (uuid)	A mappa azonosítója.
id	string (uuid)	Az elem azonosítója.
properties	EnvironmentProperties	A környezeti tulajdonságok.
sensitivityLabel	SensitivityLabel	Az elem bizalmassági címkéje.
tags	ItemTag[]	Az alkalmazott címkék listája.
type	ItemType	Az elem típusa.
workspaceId	string (uuid)	A munkaterület azonosítója.

EnvironmentDefinition

Tárgy

Környezeti nyilvános definíciós objektum. A környezetdefiníció szerkezetével kapcsolatos további részletekért tekintse meg ezt a cikket .

Name	Típus	Description
format	string	A környezetdefiníció formátuma.
parts	EnvironmentDefinitionPart[]	Definíciórészek listája.

EnvironmentDefinitionPart

Tárgy

Környezetdefiníciós részobjektum.

Name	Típus	Description
path	string	A környezeti rész elérési útja.
payload	string	A környezeti rész hasznos adatai.
payloadType	PayloadType	A hasznos adat típusa.

EnvironmentProperties

Tárgy

Környezeti tulajdonságok.

Name	Típus	Description
publishDetails	PublishDetails	A környezet közzétételi műveletének részletei.

EnvironmentPublishState

Felsorolás

Közzétételi állapot. Idővel további állapottípusok is hozzáadhatók.

Érték	Description
Success	A környezeti közzététel sikeres állapotban van.
Cancelled	A környezeti közzététel megszakított állapotban van.
Failed	A környezeti közzététel sikertelen állapotban van.
Cancelling	A környezeti közzététel visszavonási állapotban van.
Running	A környezeti közzététel futó állapotban van.
Waiting	A környezeti közzététel várakozási állapotban van.

ErrorRelatedResource

Tárgy

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Tárgy

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
isRetriable	boolean	Ha igaz, a kérés újrapróbálkozott. Ha elérhető, a `Retry-After` válaszfejléc használatával állapítsa meg a késést.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

GroupDetails

Tárgy

Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.

Name	Típus	Description
groupType	GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

GroupPrincipal

Tárgy

Biztonsági csoportot jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
groupDetails	GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus `Group`.
id	string (uuid)	Az igazgató azonosítója.
type	string: Group	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

GroupType

Felsorolás

A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

Érték	Description
Unknown	Az egyszerű csoport típusa ismeretlen.
SecurityGroup	Az egyszerű egy biztonsági csoport.
DistributionList	Az egyszerű egy terjesztési lista.

ItemTag

Tárgy

Egy elemre alkalmazott címkét jelöl.

Name	Típus	Description
displayName	string	A címke neve.
id	string (uuid)	A címke azonosítója.

ItemType

Felsorolás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték	Description
Dashboard	PowerBI-irányítópult.
Report	PowerBI-jelentés.
SemanticModel	PowerBI szemantikai modell.
PaginatedReport	Többoldalas PowerBI-jelentés.
Datamart	PowerBI datamart.
Lakehouse	Egy tóház.
Eventhouse	Egy rendezvényház.
Environment	Egy környezet.
KQLDatabase	KQL-adatbázis.
KQLQueryset	KQL-lekérdezéskészlet.
KQLDashboard	KQL-irányítópult.
DataPipeline	Egy adatfolyam.
Notebook	Egy jegyzetfüzet.
SparkJobDefinition	Spark-feladat definíciója.
MLExperiment	Gépi tanulási kísérlet.
MLModel	Gépi tanulási modell.
Warehouse	Egy raktár.
Eventstream	Eseménystream.
SQLEndpoint	EGY SQL-végpont.
MirroredWarehouse	Egy tükrözött raktár.
MirroredDatabase	Tükrözött adatbázis.
Reflex	Egy reflex.
GraphQLApi	Api a GraphQL-elemhez.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Másolási feladat.
VariableLibrary	Egy VariableLibrary.
Dataflow	Adatfolyam.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Raktári pillanatkép.
DigitalTwinBuilder	Egy DigitalTwinBuilder.
DigitalTwinBuilderFlow	A Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Tükrözött Azure Databricks-katalógus.
Map	Térkép.
AnomalyDetector	Anomáliadetektor.
UserDataFunction	Felhasználói adatfüggvény.
GraphModel	Egy GraphModel.
GraphQuerySet	Egy Graph Queryset.
SnowflakeDatabase	Snowflake-adatbázis a Snowflake-fiókból létrehozott Iceberg-táblák tárolására.
OperationsAgent	Egy OperationsAgent.
CosmosDBDatabase	Cosmos DB-adatbázis.
Ontology	Egy ontológia.
EventSchemaSet	An EventSchemaSet.
DataAgent	Egy DataAgent.
MirroredCatalog	Tükrözöttcatalog.
AppBackend	Egy AppBackend.
OrgApp	Szervezeti alkalmazás.
OrgAppAudience	Szervezeti alkalmazás célközönsége.
DataBuildToolJob	Egy DataBuildToolJob.
AzureDatabricksStorage	OneLake-alapú tárolóelem Azure Databricks.
Plan	Egy terv.

PayloadType

Felsorolás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték	Description
InlineBase64	Beágyazott 64-es alap.

PrincipalType

Felsorolás

A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Érték	Description
User	A rendszernév egy Microsoft Entra felhasználónév.
ServicePrincipal	Az egyszerű szolgáltatásnév egy Microsoft Entra szolgáltatásnév.
Group	Az egyszerű egy biztonsági csoport.
ServicePrincipalProfile	Az egyszerű szolgáltatásnév egy szolgáltatásnév-profil.
EntireTenant	Az egyszerűség az összes bérlőfelhasználót jelöli.

PublishDetails

Tárgy

A közzétételi művelet részletei.

Name	Típus	Description
componentPublishInfo	ComponentPublishInfo	A környezeti összetevő közzétételi információi.
endTime	string (date-time)	A közzétételi művelet befejezési időpontja UTC-ben, YYYYY-MM-DDTHH:mm:ssssZ formátumban.
startTime	string (date-time)	A közzétételi művelet kezdési időpontja UTC-ben, YYYYY-MM-DDTHH:mm:ssssZ formátumban.
state	EnvironmentPublishState	Közzétételi állapot. Idővel további állapottípusok is hozzáadhatók.
targetVersion	string (uuid)	Közzéteendő célpont.

SensitivityLabel

Tárgy

Egy elemre alkalmazott bizalmassági címkét jelöl.

Name	Típus	Description
id	string (uuid)	A bizalmassági címke azonosítója.

SensitivityLabelApplyStrategy

Felsorolás

A bizalmassági címke alkalmazásának stratégiája. Az alapértelmezett érték az ApplyOrFail. Idővel további típusok is hozzáadhatók.

Érték	Description
ApplyOrFail	Alkalmazza a bizalmassági címkét, vagy ha nem alkalmazható, akkor a művelet meghiúsul.
Ignore	Hagyja figyelmen kívül a bizalmassági címkét, ha nem alkalmazható, és folytassa a műveletet a címke alkalmazása nélkül.

SensitivityLabelSettings

Tárgy

A bizalmassági címke beállításai.

Name	Típus	Description
labelId	string (uuid)	A bizalmassági címke azonosítója.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	A bizalmassági címke alkalmazásának stratégiája.

ServicePrincipalDetails

Tárgy

A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.

Name	Típus	Description
aadAppId	string (uuid)	A szolgáltatásnév Microsoft Entra AppId.

ServicePrincipalPrincipal

Tárgy

Egy Microsoft Entra szolgáltatásnevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalDetails	ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipal`.
type	string: ServicePrincipal	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

ServicePrincipalProfileDetails

Tárgy

A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.

Name	Típus	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	A szolgáltatásnév-profil szülőnevét.

ServicePrincipalProfilePrincipal

Tárgy

Szolgáltatásnév-profilt jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

SparkLibraries

Tárgy

Spark-kódtárak.

Name	Típus	Description
state	EnvironmentPublishState	Közzétételi állapot. Idővel további állapottípusok is hozzáadhatók.

SparkSettings

Tárgy

Spark-beállítások.

Name	Típus	Description
state	EnvironmentPublishState	Közzétételi állapot. Idővel további állapottípusok is hozzáadhatók.

UserDetails

Tárgy

A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

Name	Típus	Description
userPrincipalName	string	A felhasználói főnév.

UserPrincipal

Tárgy

Egy Microsoft Entra felhasználónevet jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
id	string (uuid)	Az igazgató azonosítója.
type	string: User	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
userDetails	UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus `User`.