Delen via


Items - List Environments

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

Machtigingen

De beller moet viewer hebben of een hogere werkruimterol.

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

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments
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

Voorbeelden

List environments in workspace example

Voorbeeldaanvraag

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

Voorbeeldrespons

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

EnvironmentPublishInfo

Informatie over het publiceren van de omgeving.

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.

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

Publiceer informatie voor elke onderdelen in de omgeving.

Name Type Description
sparkLibraries

SparkLibraries

Spark-bibliotheken publiceren informatie.

sparkSettings

SparkSettings

Spark-instellingen publiceren informatie.

Environment

Een omgevingsitem.

Name Type Description
description

string

De beschrijving van het item.

displayName

string

De weergavenaam van het item.

id

string

uuid

De item-id.

properties

EnvironmentPublishInfo

De omgevingseigenschappen.

type

ItemType

Het itemtype.

workspaceId

string

uuid

De werkruimte-id.

EnvironmentPublishInfo

Informatie over het publiceren van de omgeving.

Name Type Description
publishDetails

PublishDetails

Details van de publicatiebewerking in de omgeving.

EnvironmentPublishState

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

Waarde Description
Cancelled

Het publiceren van de omgeving heeft de status Geannuleerd.

Cancelling

Het publiceren van de omgeving heeft de status Annuleren.

Failed

Het publiceren van de omgeving heeft de status Mislukt.

Running

Het publiceren van de omgeving heeft de status Actief.

Success

Het publiceren van de omgeving heeft de status Geslaagd.

Waiting

Het publiceren van de omgeving heeft een wachtstatus.

Environments

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

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

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

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.

ItemType

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

Waarde Description
Dashboard

PowerBI-dashboard.

DataPipeline

Een gegevenspijplijn.

Datamart

PowerBI-datamart.

Environment

Een omgeving.

Eventhouse

Een eventhouse.

Eventstream

Een eventstream.

GraphQLApi

Een API voor GraphQL-item.

KQLDashboard

Een KQL-dashboard.

KQLDatabase

Een KQL-database.

KQLQueryset

Een KQL-queryset.

Lakehouse

Een lakehouse.

MLExperiment

Een machine learning-experiment.

MLModel

Een machine learning-model.

MirroredDatabase

Een gespiegelde database.

MirroredWarehouse

Een gespiegeld magazijn.

MountedDataFactory

Een MountedDataFactory.

Notebook

Een notitieblok.

PaginatedReport

Gepagineerd Power BI-rapport.

Reflex

Een reflex.

Report

PowerBI-rapport.

SQLDatabase

Een SQLDatabase.

SQLEndpoint

Een SQL-eindpunt.

SemanticModel

Semantisch Power BI-model.

SparkJobDefinition

Een Spark-taakdefinitie.

Warehouse

Een magazijn.

PublishDetails

Details van de publicatiebewerking.

Name Type Description
componentPublishInfo

ComponentPublishInfo

Informatie over het publiceren van omgevingsonderdelen.

endTime

string

date-time

Eindtijd van de publicatiebewerking.

startTime

string

date-time

Begintijd van de publicatiebewerking.

state

EnvironmentPublishState

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

targetVersion

string

uuid

Doelversie die moet worden gepubliceerd.

SparkLibraries

Spark-bibliotheken.

Name Type Description
state

EnvironmentPublishState

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

SparkSettings

Spark-instellingen.

Name Type Description
state

EnvironmentPublishState

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