Del via

Items - Create Environment

  • Referanse
Tjeneste:
Environment
API-versjon:
v1

Oppretter et miljø i det angitte arbeidsområdet.
Denne API-en støtter langvarige operasjoner (LRO).

Denne API-en støtter ikke oppretting av et miljø med definisjon.

Tillatelser

Innringeren må ha bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Environment.ReadWrite.All eller Item.ReadWrite.All

Begrensninger

  • Hvis du vil opprette et miljø, må arbeidsområdet være på en støttet stoffkapasitet.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet Støtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Ja

Grensesnitt

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string

uuid

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Obligatorisk Type Beskrivelse
displayName True

string

Visningsnavnet for miljøet.
description

string

Miljøbeskrivelsen. Maksimal lengde er 256 tegn.

Svar

Navn Type Beskrivelse
201 Created

Environment

Opprettet
202 Accepted

Forespørsel godtatt, miljøklargjøring pågår

Overskrifter

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • InvalidItemType – elementtypen er ugyldig

  • ItemDisplayNameAlreadyInUse – visningsnavnet for elementet er allerede brukt

  • CorruptedPayload – den angitte nyttelasten er skadet

Eksempler

Create a environment example

Eksempelforespørsel

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

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

Eksempelsvar

Statuskode:
201 
{
  "displayName": "Environment_1",
  "description": "An environment description",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Statuskode:
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

Definisjoner

Navn Beskrivelse
ComponentPublishInfo

Publiser informasjon for hver komponent i miljøet.
CreateEnvironmentRequest

Opprett nyttelast for miljøforespørsler.
Environment

Et miljøelement.
EnvironmentPublishInfo

Informasjon om publisering av miljø.
EnvironmentPublishState

Publiser tilstand. Flere tilstandstyper kan legges til over tid.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
ItemType

Typen element. Flere elementtyper kan legges til over tid.
PublishDetails

Detaljer om publiseringsoperasjon.
SparkLibraries

Spark-biblioteker.
SparkSettings

Spark-innstillinger.

ComponentPublishInfo

Object

Publiser informasjon for hver komponent i miljøet.

Navn Type Beskrivelse
sparkLibraries

SparkLibraries

Spark-biblioteker publiserer informasjon.
sparkSettings

SparkSettings

Spark-innstillinger publiserer informasjon.

CreateEnvironmentRequest

Object

Opprett nyttelast for miljøforespørsler.

Navn Type Beskrivelse
description

string

Miljøbeskrivelsen. Maksimal lengde er 256 tegn.
displayName

string

Visningsnavnet for miljøet.

Environment

Object

Et miljøelement.

Navn Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Visningsnavnet for elementet.
id

string

uuid

Element-ID-en.
properties

EnvironmentPublishInfo

Miljøegenskapene.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbeidsområde-ID-en.

EnvironmentPublishInfo

Object

Informasjon om publisering av miljø.

Navn Type Beskrivelse
publishDetails

PublishDetails

Detaljer for publisering av miljø.

EnvironmentPublishState

Opplisting

Publiser tilstand. Flere tilstandstyper kan legges til over tid.

Verdi Beskrivelse
Cancelled

Publisering av miljø er i avbrutt tilstand.
Cancelling

Publisering av miljø er i avbrytertilstand.
Failed

Publisering av miljø er i mislykket tilstand.
Running

Publisering av miljø er i kjørende tilstand.
Success

Publisering av miljø er i vellykket tilstand.
Waiting

Publisering av miljø er i ventetilstand.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

ItemType

Opplisting

Typen element. Flere elementtyper kan legges til over tid.

Verdi Beskrivelse
Dashboard

PowerBI-instrumentbord.
DataPipeline

Et datasamlebånd.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et arrangementshus.
Eventstream

En hendelsesstrøm.
GraphQLApi

En API for GraphQL-element.
KQLDashboard

Et KQL-instrumentbord.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-spørringssett.
Lakehouse

Et innsjøhus.
MLExperiment

Et maskinlæringseksperiment.
MLModel

En maskinlæringsmodell.
MirroredDatabase

En speilvendt database.
MirroredWarehouse

Et speilvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notatblokk.
PaginatedReport

Paginert powerbi-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-endepunkt.
SemanticModel

Semantisk PowerBI-modell.
SparkJobDefinition

En spark-jobbdefinisjon.
Warehouse

Et lager.

PublishDetails

Object

Detaljer om publiseringsoperasjon.

Navn Type Beskrivelse
componentPublishInfo

ComponentPublishInfo

Informasjon om miljøkomponenten publiserer.
endTime

string

date-time

Sluttidspunkt for publiseringsoperasjonen.
startTime

string

date-time

Starttidspunktet for publiseringsoperasjonen.
state

EnvironmentPublishState

Publiser tilstand. Flere tilstandstyper kan legges til over tid.
targetVersion

string

uuid

Mål-verion som skal publiseres.

SparkLibraries

Object

Spark-biblioteker.

Navn Type Beskrivelse
state

EnvironmentPublishState

Publiser tilstand. Flere tilstandstyper kan legges til over tid.

SparkSettings

Object

Spark-innstillinger.

Navn Type Beskrivelse
state

EnvironmentPublishState

Publiser tilstand. Flere tilstandstyper kan legges til over tid.