Workspaces - Create Workspace
Hiermee maakt u een nieuwe werkruimte.
Machtigingen
- De aanroeper moet gemachtigd zijn om werkruimten te maken die zijn verleend door de Fabric-beheerder. Zie voor meer informatie: werkruimten maken.
- De beller moet inzendermachtigingen hebben of een beheerder zijn voor de capaciteit. Zie voor meer informatie: gebruikersmachtigingen voor capaciteit.
- Service-principals moeten machtigingen hebben die zijn verleend door de Fabric-beheerder. Zie voor meer informatie: Service-principals kunnen werkruimten, verbindingen en implementatiepijplijnen maken.
Vereiste gedelegeerde bereiken
Workspace.ReadWrite.All
Snelheidsbeperkingen
| Limiettype | Value |
|---|---|
| Uniform quotum voor platform-API's | 200 oproepen/min. |
| API-limiet | 200 oproepen/min. |
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/workspacesAanvraagbody
| Name | Vereist | Type | Description |
|---|---|---|---|
| displayName | True |
string |
De weergavenaam van de werkruimte. |
| capacityId |
string (uuid) |
De id van de capaciteit waaraan de werkruimte moet worden toegewezen. |
|
| description |
string |
De beschrijving van de werkruimte. |
|
| domainId |
string (uuid) |
De id van het domein waaraan de werkruimte moet worden toegewezen. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 201 Created |
Gemaakt. Kopteksten Location: string |
|
| 429 Too Many Requests |
De servicesnelheidslimiet is overschreden. De server retourneert een Kopteksten Retry-After: integer |
|
| Other Status Codes |
Veelvoorkomende foutcodes:
|
Voorbeelden
Create a workspace example
Voorbeeldaanvraag
POST https://api.fabric.microsoft.com/v1/workspaces
{
"displayName": "New workspace"
}
Voorbeeldrespons
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",
"capacityRegion": "West US"
}Definities
| Name | Description |
|---|---|
|
Capacity |
De regio van de capaciteit die aan deze werkruimte is gekoppeld. Er kunnen in de loop van de tijd extra capaciteitsregiowaarden worden toegevoegd. |
|
Create |
Nettolading voor werkruimteaanvragen maken. |
|
Error |
Het foutgerelateerde resourcedetailsobject. |
|
Error |
Het foutbericht. |
|
Error |
De details van het foutbericht. |
| Workspace |
Een werkruimteobject. |
|
Workspace |
Vertegenwoordigt een toegepaste tag. |
|
Workspace |
Een werkruimtetype. Er kunnen in de loop van de tijd extra werkruimtetypen worden toegevoegd. |
CapacityRegion
De regio van de capaciteit die aan deze werkruimte is gekoppeld. Er kunnen in de loop van de tijd extra capaciteitsregiowaarden worden toegevoegd.
| Waarde | Description |
|---|---|
| Australia East |
Regio Australië - oost |
| Australia Southeast |
Regio Australië - zuidoost |
| Brazil South |
Regio Brazilië - zuid |
| Brazil Southeast |
Regio Brazilië - zuidoost |
| Canada Central |
Regio Canada - centraal |
| Canada East |
Regio Canada - oost |
| Central India |
Regio India - centraal |
| Central US |
Regio VS - centraal |
| Central US EUAP |
REGIO VS - centraal EUAP |
| East Asia |
Regio Azië - oost |
| East US |
Regio VS - oost |
| East US 2 |
Regio VS - oost 2 |
| France Central |
Regio Frankrijk - centraal |
| France South |
Regio Frankrijk - zuid |
| Germany Central |
Regio Duitsland - centraal |
| Germany Northeast |
Duitse noordoostelijke regio |
| Israel Central |
Regio Israël - centraal |
| Italy North |
Regio Italië - noord |
| Japan East |
Regio Japan - oost |
| Japan West |
Regio Japan - west |
| Korea Central |
Regio Korea - centraal |
| Korea South |
Zuid-Korea |
| Mexico Central |
Regio Mexico -centraal |
| North Central US |
Regio VS - noord-centraal |
| North Europe |
Regio Europa - noord |
| Norway East |
Noorwegen - oost |
| Norway West |
Regio Noorwegen - west |
| Poland Central |
Regio Polen - centraal |
| South Africa North |
Regio Zuid-Afrika - noord |
| South Africa West |
Regio Zuid-Afrika - west |
| South Central US |
Regio VS - zuid-centraal |
| South India |
Regio India - zuid |
| Southeast Asia |
Regio Azië - zuidoost |
| Spain Central |
Regio Spanje - centraal |
| Sweden Central |
Regio Zweden - centraal |
| Switzerland North |
Regio Zwitserland - noord |
| Switzerland West |
Regio Zwitserland - west |
| West Europe |
Regio Europa - west |
| West India |
Regio India - west |
| West US |
Regio VS - west |
| West US 2 |
Regio VS - west 2 |
| West US 3 |
Regio VS - west 3 |
| West Central US |
Regio VS - west-centraal |
| UAE Central |
Regio UAE - centraal |
| UAE North |
Regio UAE - noord |
| Qatar Central |
Regio Qatar - centraal |
| Germany West Central |
Regio Duitsland - west-centraal |
| Germany North |
Regio Duitsland - noord |
| UK South |
Regio VK - zuid |
| UK West |
Regio VK - west |
| China North |
Regio China - noord |
| China East |
Regio China - oost |
| China East 2 |
Regio China - oost 2 |
| China East 3 |
Regio China - oost 3 |
| China North 2 |
Regio China - noord 2 |
| China North 3 |
Regio China - noord 3 |
CreateWorkspaceRequest
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. |
| displayName |
string |
De weergavenaam van de werkruimte. |
| domainId |
string (uuid) |
De id van het domein waaraan de werkruimte moet worden toegewezen. |
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. |
| isRetriable |
boolean |
Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de |
| message |
string |
Een leesbare weergave van de fout. |
| moreDetails |
Lijst met aanvullende foutdetails. |
|
| relatedResource |
De foutgerelateerde resourcedetails. |
|
| requestId |
string (uuid) |
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. |
Workspace
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. |
| capacityRegion |
De regio van de capaciteit die aan deze werkruimte is gekoppeld. |
|
| 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. |
| tags |
Lijst met toegepaste tags. |
|
| type |
Het type werkruimte. |
WorkspaceAppliedTag
Vertegenwoordigt een toegepaste tag.
| Name | Type | Description |
|---|---|---|
| displayName |
string |
De naam van de tag. |
| id |
string (uuid) |
De tag-id. |
WorkspaceType
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. |