Items - Create Environment

Služba:: Environment

Verzia rozhrania API:: v1

Vytvorí prostredie v zadanom pracovnom priestore.
Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Povolenia

Volajúci musí mať rolu pracovného priestoru prispievateľa .

Povinné delegované rozsahy

Environment.ReadWrite.All alebo Item.ReadWrite.All

Obmedzenia

Ak chcete vytvoriť prostredie, pracovný priestor sa musí nachádzať v podporovanej kapacite služby Fabric.

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

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

Parametre URI

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

Text požiadavky

Name	Povinné	Typ	Description
displayName	True	string	Zobrazovaný názov prostredia.
definition		EnvironmentDefinition	Verejná definícia prostredia.
description		string	Popis prostredia. Maximálna dĺžka je 256 znakov.
folderId		string (uuid)	ID priečinka. Ak parameter nie je zadaný alebo má hodnotu null, vytvorí sa prostredie s pracovným priestorom ako jeho priečinkom.

Odpovede

Name	Typ	Description
201 Created	Environment	Úspešne vytvorené
202 Accepted		Žiadosť prijatá, prebieha poskytovanie prostriedkov prostredia Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: InvalidItemType – typ položky je neplatný ItemDisplayNameAlreadyInUse – zobrazovaný názov položky sa už používa CorruptedPayload – poskytnutá údajová časť je poškodená. Limit položiek pracovného priestoruItemsLimitExceeded – limit položiek pracovného priestoru bol prekročený.

Name

Typ

Description

201 Created

Environment

Úspešne vytvorené

202 Accepted

Žiadosť prijatá, prebieha poskytovanie prostriedkov prostredia

Hlavičky

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

Other Status Codes

ErrorResponse

Bežné kódy chýb:

InvalidItemType – typ položky je neplatný
ItemDisplayNameAlreadyInUse – zobrazovaný názov položky sa už používa
CorruptedPayload – poskytnutá údajová časť je poškodená.
Limit položiek pracovného priestoruItemsLimitExceeded – limit položiek pracovného priestoru bol prekročený.

Príklady

Create an environment example

Create an environment with public definition example

Create an environment example

Vzorová požiadavka

HTTP

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

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

Vzorová odpoveď

Kód stavu:: 201

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

Kód stavu:: 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

Vzorová požiadavka

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"
      }
    ]
  }
}

Vzorová odpoveď

Kód stavu:: 201

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

Kód stavu:: 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ície

Name	Description
ComponentPublishInfo	Publikujte informácie o jednotlivých súčastiach v prostredí.
CreateEnvironmentRequest	Vytvorenie údajovej časti požiadavky prostredia.
Environment	Položka prostredia.
EnvironmentDefinition	Objekt verejnej definície prostredia. V tomto článku nájdete ďalšie podrobnosti o tom, ako vytvoriť verejnú definíciu prostredia.
EnvironmentDefinitionPart	Časť objektu definície 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.
PayloadType	Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.
PublishDetails	Podrobnosti o operácii publikovania.
SparkLibraries	Knižnice Spark.
SparkSettings	Nastavenia spark.

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.

CreateEnvironmentRequest

Object

Vytvorenie údajovej časti požiadavky prostredia.

Name	Typ	Description
definition	EnvironmentDefinition	Verejná definícia prostredia.
description	string	Popis prostredia. Maximálna dĺžka je 256 znakov.
displayName	string	Zobrazovaný názov prostredia.
folderId	string (uuid)	ID priečinka. Ak parameter nie je zadaný alebo má hodnotu null, vytvorí sa prostredie s pracovným priestorom ako jeho priečinkom.

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.

EnvironmentDefinition

Object

Objekt verejnej definície prostredia. V tomto článku nájdete ďalšie podrobnosti o tom, ako vytvoriť verejnú definíciu prostredia.

Name	Typ	Description
format	string	Formát definície prostredia.
parts	EnvironmentDefinitionPart[]	Zoznam častí definície.

EnvironmentDefinitionPart

Object

Časť objektu definície prostredia.

Name	Typ	Description
path	string	Cesta časti prostredia.
payload	string	Údajová časť prostredia.
payloadType	PayloadType	Typ údajovej časti.

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.

PayloadType

Enumerácia

Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.

Hodnota	Description
InlineBase64	Inline Base 64.

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.

Zdieľať cez

Items - Create Environment

Povolenia

Povinné delegované rozsahy

Obmedzenia

Podporované identity v aplikácii Microsoft Entra

Rozhranie

Parametre URI

Text požiadavky

Odpovede

Príklady

Create an environment example

Vzorová požiadavka

Vzorová odpoveď

Create an environment with public definition example

Vzorová požiadavka

Vzorová odpoveď

Definície

ComponentPublishInfo

CreateEnvironmentRequest

Environment

EnvironmentDefinition

EnvironmentDefinitionPart

EnvironmentProperties

EnvironmentPublishState

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

PublishDetails

SparkLibraries

SparkSettings