Del via

Items - Update Environment

  • Referanse
Tjeneste:
Environment
API-versjon:
v1

Oppdaterer egenskapene for det angitte miljøet.

Tillatelser

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

Nødvendige delegerte omfang

Environment.ReadWrite.All eller Item.ReadWrite.All

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

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
environmentId
 path True

string

uuid

Miljø-ID-en.
workspaceId
 path True

string

uuid

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Type Beskrivelse
description

string

Miljøbeskrivelsen. Maksimal lengde er 256 tegn.
displayName

string

Visningsnavnet for miljøet.

Svar

Navn Type Beskrivelse
200 OK

Environment

Forespørselen er fullført.
Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • ItemNotFound – Finner ikke det forespurte elementet.

  • InvalidRequest – ugyldig oppdateringsforespørsel

Eksempler

Update a environment example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:
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"
}

Definisjoner

Navn Beskrivelse
ComponentPublishInfo

Publiser informasjon for hver komponent i miljøet.
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.
UpdateEnvironmentRequest

Oppdater miljøforespørsel.

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.

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.

UpdateEnvironmentRequest

Object

Oppdater miljøforespørsel.

Navn Type Beskrivelse
description

string

Miljøbeskrivelsen. Maksimal lengde er 256 tegn.
displayName

string

Visningsnavnet for miljøet.