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 |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
De werkruimte-id. |
continuation
|
query |
string |
Een token voor het ophalen van de volgende pagina met resultaten. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
De aanvraag is voltooid. |
|
Other Status Codes |
Veelvoorkomende foutcodes:
|
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 |
---|---|
Component |
Publiceer informatie voor elke onderdelen in de omgeving. |
Environment |
Een omgevingsitem. |
Environment |
Informatie over het publiceren van de omgeving. |
Environment |
Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd. |
Environments |
Een lijst met omgevingen. |
Error |
Het foutgerelateerde resourcedetailsobject. |
Error |
Het foutbericht. |
Error |
De details van het foutbericht. |
Item |
Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd. |
Publish |
Details van de publicatiebewerking. |
Spark |
Spark-bibliotheken. |
Spark |
Spark-instellingen. |
ComponentPublishInfo
Publiceer informatie voor elke onderdelen in de omgeving.
Name | Type | Description |
---|---|---|
sparkLibraries |
Spark-bibliotheken publiceren informatie. |
|
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 |
De omgevingseigenschappen. |
|
type |
Het itemtype. |
|
workspaceId |
string uuid |
De werkruimte-id. |
EnvironmentPublishInfo
Informatie over het publiceren van de omgeving.
Name | Type | Description |
---|---|---|
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 |
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 |
Lijst met aanvullende foutdetails. |
|
relatedResource |
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 |
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 |
Informatie over het publiceren van omgevingsonderdelen. |
|
endTime |
string date-time |
Eindtijd van de publicatiebewerking. |
startTime |
string date-time |
Begintijd van de publicatiebewerking. |
state |
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 |
Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd. |
SparkSettings
Spark-instellingen.
Name | Type | Description |
---|---|---|
state |
Publicatiestatus. Er kunnen in de loop van de tijd extra statustypen worden toegevoegd. |