Items - List Environments

Service:: Environment

API-versie:: v1

Retourneert een lijst met omgevingen uit de opgegeven werkruimte.
Deze API ondersteunt paginering.

Machtigingen

De aanroeper moet een werkruimterol voor de kijker hebben.

Vereiste gedelegeerde bereiken

Workspace.Read.All of Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Ja

gebruikersinterface

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

Met optionele parameters:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments?continuationToken={continuationToken}

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-id.
continuationToken	query		string	Een token voor het ophalen van de volgende pagina met resultaten.

Antwoorden

Name	Type	Description
200 OK	Environments	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Ongeldig itemtype

Name

Type

Description

200 OK

Environments

De aanvraag is voltooid.

Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

InvalidItemType - Ongeldig itemtype

Voorbeelden

List environments in workspace example

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "Environment_1",
      "description": "A environment description.",
      "type": "Environment",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "properties": {
        "publishDetails": {
          "state": "Failed",
          "targetVersion": "14ece8b5-68a1-4130-a9e7-074c04537588",
          "startTime": "2024-03-30T14:17:09.0697022Z",
          "endTime": "2024-03-30T14:48:09.0697022Z",
          "componentPublishInfo": {
            "sparkLibraries": {
              "state": "Failed"
            },
            "sparkSettings": {
              "state": "Success"
            }
          }
        }
      }
    },
    {
      "id": "a8a1bffa-7eea-49dc-a1d2-6281c1d031f1",
      "displayName": "Environment_2",
      "description": "A environment description.",
      "type": "Environment",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "properties": {
        "publishDetails": {
          "state": "Success",
          "targetVersion": "46838a80-5450-4414-bea0-40fb6f3e0c0d",
          "startTime": "2024-03-29T14:17:09.0697022Z",
          "endTime": "2024-03-29T14:48:09.0697022Z",
          "componentPublishInfo": {
            "sparkLibraries": {
              "state": "Success"
            },
            "sparkSettings": {
              "state": "Success"
            }
          }
        }
      }
    }
  ]
}

Definities

Name	Description
ComponentPublishInfo	Publiceer informatie voor elke onderdelen in de omgeving.
Environment	Een omgevingsitem.
EnvironmentProperties	Omgevingseigenschappen.
EnvironmentPublishState	Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd.
Environments	Een lijst met omgevingen.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
ItemTag	Vertegenwoordigt een tag die is toegepast op een item.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
PublishDetails	Details van de publicatiebewerking.
SparkLibraries	Spark-bibliotheken.
SparkSettings	Spark-instellingen.

ComponentPublishInfo

Object

Publiceer informatie voor elke onderdelen in de omgeving.

Name	Type	Description
sparkLibraries	SparkLibraries	Spark-bibliotheken publiceren informatie.
sparkSettings	SparkSettings	Spark-instellingen publiceren informatie.

Environment

Object

Een omgevingsitem.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
folderId	string (uuid)	De map-id.
id	string (uuid)	De item-id.
properties	EnvironmentProperties	De omgevingseigenschappen.
tags	ItemTag[]	Lijst met toegepaste tags.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De werkruimte-id.

EnvironmentProperties

Object

Omgevingseigenschappen.

Name	Type	Description
publishDetails	PublishDetails	Details van de publicatiebewerking in de omgeving.

EnvironmentPublishState

Opsomming

Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd.

Waarde	Description
Success	Het publiceren van de omgeving heeft de status Geslaagd.
Cancelled	Het publiceren van de omgeving heeft de status Geannuleerd.
Failed	Het publiceren van de omgeving heeft de status Mislukt.
Cancelling	Het publiceren van de omgeving heeft de status Annuleren.
Running	Het publiceren van de omgeving heeft de status Actief.
Waiting	Het publiceren van de omgeving heeft een wachtstatus.

Environments

Object

Een lijst met omgevingen.

Name	Type	Description
continuationToken	string	Het token voor de volgende batch met resultatensets. Als er geen records meer zijn, wordt deze verwijderd uit het antwoord.
continuationUri	string	De URI van de volgende batch met resultatensets. Als er geen records meer zijn, wordt deze verwijderd uit het antwoord.
value	Environment[]	Een lijst met omgevingen.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name	Type	Description
displayName	string	De naam van de tag.
id	string (uuid)	De tag-id.

ItemType

Opsomming

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
Report	PowerBI-rapport.
SemanticModel	Semantisch Power BI-model.
PaginatedReport	Gepagineerd Power BI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Een lakehouse.
Eventhouse	Een eventhouse.
Environment	Een omgeving.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
KQLDashboard	Een KQL-dashboard.
DataPipeline	Een gegevenspijplijn.
Notebook	Een notitieblok.
SparkJobDefinition	Een Spark-taakdefinitie.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
Warehouse	Een magazijn.
Eventstream	Een eventstream.
SQLEndpoint	Een SQL-eindpunt.
MirroredWarehouse	Een gespiegeld magazijn.
MirroredDatabase	Een gespiegelde database.
Reflex	Een reflex.
GraphQLApi	Een API voor GraphQL-item.
MountedDataFactory	Een MountedDataFactory.
SQLDatabase	Een SQLDatabase.
CopyJob	Een kopieertaak.
VariableLibrary	Een VariableLibrary.
Dataflow	Een gegevensstroom.
ApacheAirflowJob	Een ApacheAirflowJob.
WarehouseSnapshot	Een momentopname van een magazijn.
DigitalTwinBuilder	Een DigitalTwinBuilder.
DigitalTwinBuilderFlow	Een Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Een gespiegelde Azure Databricks-catalogus.
Map	Een kaart.
AnomalyDetector	Een Anomaly Detector.
UserDataFunction	Een gebruikersgegevensfunctie.
GraphModel	Een GraphModel.
GraphQuerySet	Een Graph QuerySet.
SnowflakeDatabase	Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account.
OperationsAgent	Een OperationsAgent.
CosmosDBDatabase	Een Cosmos DB-database.
Ontology	Een Ontologie.
EventSchemaSet	Een EventSchemaSet.

PublishDetails

Object

Details van de publicatiebewerking.

Name	Type	Description
componentPublishInfo	ComponentPublishInfo	Informatie over het publiceren van omgevingsonderdelen.
endTime	string (date-time)	Eindtijd van de publicatiebewerking in UTC, met behulp van de JJJJ-MM-DDTHH:mm:ss.ssZ-indeling.
startTime	string (date-time)	Begintijd van publicatiebewerking in UTC, met de indeling JJJJ-MM-DDTHH:mm:ss.ssZ.
state	EnvironmentPublishState	Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd.
targetVersion	string (uuid)	Doelversie die moet worden gepubliceerd.

SparkLibraries

Object

Spark-bibliotheken.

Name	Type	Description
state	EnvironmentPublishState	Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd.

SparkSettings

Object

Spark-instellingen.

Name	Type	Description
state	EnvironmentPublishState	Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd.

Delen via

Items - List Environments

Machtigingen

Vereiste gedelegeerde bereiken

Door Microsoft Entra ondersteunde identiteiten

gebruikersinterface

URI-parameters

Antwoorden

Voorbeelden

List environments in workspace example

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ComponentPublishInfo

Environment

EnvironmentProperties

EnvironmentPublishState

Environments

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PublishDetails

SparkLibraries

SparkSettings