Delen via

Workspaces - Create Workspace

Service:
Core
API-versie:
v1

Hiermee maakt u een nieuwe werkruimte.

Machtigingen

Vereiste gedelegeerde bereiken

Workspace.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

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

Identiteit Ondersteuning
Gebruiker Ja
serviceprincipal en beheerde identiteiten Ja

gebruikersinterface

POST https://api.fabric.microsoft.com/v1/workspaces

Aanvraagbody

Name Vereist Type Description
displayName True

string

De weergavenaam van de werkruimte.
De weergavenaam mag niet meer dan 256 tekens bevatten.
Alleen ongebruikte werkruimtenamen zijn toegestaan.
'Beheerbewaking' is een gereserveerde werkruimtenaam.
capacityId

string (uuid)

De id van de capaciteit waaraan de werkruimte moet worden toegewezen.
description

string

De beschrijving van de werkruimte.
De beschrijving mag niet meer dan 4000 tekens bevatten.
domainId

string (uuid)

De id van het domein waaraan de werkruimte moet worden toegewezen.

Antwoorden

Name Type Description
201 Created

Workspace

Gemaakt.

Kopteksten

Location: string
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • DomainNotFound - Het opgegeven domein is niet gevonden

  • InsufficientPermissionsToDomain - Gebruikersmachtiging voor het domein is niet voldoende om de bewerking uit te voeren

  • UnknownError: er is een fout opgetreden.

Voorbeelden

Create a workspace example

Voorbeeldaanvraag

POST https://api.fabric.microsoft.com/v1/workspaces

{
  "displayName": "New workspace"
}

Voorbeeldrespons

Statuscode:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb22287ff
{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb22287ff",
  "displayName": "New workspace",
  "description": "",
  "type": "Workspace"
}

Definities

Name Description
CreateWorkspaceRequest

Nettolading voor werkruimteaanvragen maken.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
Workspace

Een werkruimteobject.
WorkspaceType

Een werkruimtetype. Er kunnen in de loop van de tijd extra werkruimtetypen worden toegevoegd.

CreateWorkspaceRequest

Object

Nettolading voor werkruimteaanvragen maken.

Name Type Description
capacityId

string (uuid)

De id van de capaciteit waaraan de werkruimte moet worden toegewezen.
description

string

De beschrijving van de werkruimte.
De beschrijving mag niet meer dan 4000 tekens bevatten.
displayName

string

De weergavenaam van de werkruimte.
De weergavenaam mag niet meer dan 256 tekens bevatten.
Alleen ongebruikte werkruimtenamen zijn toegestaan.
'Beheerbewaking' is een gereserveerde werkruimtenaam.
domainId

string (uuid)

De id van het domein waaraan de werkruimte moet worden toegewezen.

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.

Workspace

Object

Een werkruimteobject.

Name Type Description
apiEndpoint

string (uri)

HTTP-URL die het API-eindpunt vertegenwoordigt dat specifiek is voor de werkruimte. Deze eindpuntwaarde wordt geretourneerd wanneer de gebruiker preferWorkspaceSpecificEndpoints inschakelt. Het biedt API-toegang via privékoppelingen.
capacityId

string (uuid)

De id van de capaciteit waaraan de werkruimte is toegewezen.
description

string

De beschrijving van de werkruimte.
displayName

string

De weergavenaam van de werkruimte.
domainId

string (uuid)

De id van het domein waaraan de werkruimte is toegewezen.
id

string (uuid)

De werkruimte-ID.
type

WorkspaceType

Het type werkruimte.

WorkspaceType

Inventarisatie

Een werkruimtetype. Er kunnen in de loop van de tijd extra werkruimtetypen worden toegevoegd.

Waarde Description
Personal

Mijn map of Mijn werkruimte die wordt gebruikt voor het beheren van gebruikersitems.
Workspace

Werkruimte die wordt gebruikt voor het beheren van de Fabric-items.
AdminWorkspace

Werkruimte voor beheerbewaking. Bevat beheerdersrapporten, zoals het auditrapport en het gebruiks- en acceptatierapport.