Megosztás a következőn keresztül:

Items - Create Environment

  • Referencia
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).

Ez az API nem támogatja a definícióval rendelkező környezetek létrehozását.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

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 hálókapacitáson kell lennie.

Microsoft Entra által támogatott identitások

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

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév é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.
description

string

A környezet leírása. A maximális hossz 256 karakter.

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
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 a environment example

Mintakérelem

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"
}
Á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.
Environment

Környezeti elem.
EnvironmentPublishInfo

Környezeti közzétételi információk.
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.
ItemTag

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

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

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

Spark-kódtárak.
SparkSettings

Spark-beállítások.

ComponentPublishInfo

Objektum

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

Objektum

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

Name Típus Description
description

string

A környezet leírása. A maximális hossz 256 karakter.
displayName

string

A környezet megjelenítendő neve.

Environment

Objektum

Környezeti elem.

Name Típus Description
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

EnvironmentPublishInfo

A környezeti tulajdonságok.
tags

ItemTag[]

Az alkalmazott címkék listája.
type

ItemType

Az elem típusa.
workspaceId

string (uuid)

A munkaterület azonosítója.

EnvironmentPublishInfo

Objektum

Környezeti közzétételi információk.

Name Típus Description
publishDetails

PublishDetails

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

EnvironmentPublishState

Enumerálás

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

Érték Description
Cancelled

A környezeti közzététel megszakított állapotban van.
Cancelling

A környezeti közzététel visszavonási állapotban van.
Failed

A környezeti közzététel sikertelen állapotban van.
Running

A környezeti közzététel futó állapotban van.
Success

A környezeti közzététel sikeres állapotban van.
Waiting

A környezeti közzététel várakozási állapotban van.

ErrorRelatedResource

Objektum

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

Objektum

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.
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

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

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.

ItemTag

Objektum

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

Enumerálás

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

Érték Description
CopyJob

Másolási feladat.
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
VariableLibrary

Egy VariableLibrary.
Warehouse

Egy raktár.

PublishDetails

Objektum

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 ideje.
startTime

string (date-time)

A közzétételi művelet kezdési időpontja.
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.

SparkLibraries

Objektum

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

Objektum

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.