Workspaces - Update Workspace

Service:: Core

API-versie:: v1

Hiermee worden de opgegeven werkruimte-eigenschappen bijgewerkt.

Machtigingen

De aanroeper moet beheerdersrol werkruimte hebben.

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

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-ID.

Aanvraagbody

Name	Type	Description
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. Werkruimtenamen moeten uniek zijn binnen de tenant. 'Beheerbewaking' is een gereserveerde werkruimtenaam.

Antwoorden

Name Type Description

200 OK

Name	Type	Description
200 OK	Workspace	De aanvraag is voltooid.
429 Too Many Requests	ErrorResponse	De servicesnelheidslimiet is overschreden. De server retourneert een `Retry-After` header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden. Kopteksten Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: UnknownError: er is een fout opgetreden.

Workspace

De aanvraag is voltooid.

429 Too Many Requests

ErrorResponse

De servicesnelheidslimiet is overschreden. De server retourneert een Retry-After header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden.

Kopteksten

Retry-After: integer

Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

UnknownError: er is een fout opgetreden.

Voorbeelden

Update a workspace example

Voorbeeldaanvraag

HTTP

PATCH https://api.fabric.microsoft.com/v1/workspaces/33bae707-5fe7-4352-89bd-061a1318b60a

{
  "displayName": "Workspace New displayName",
  "description": "Workspace New description"
}

Voorbeeldrespons

Statuscode:: 200

{
  "id": "33bae707-5fe7-4352-89bd-061a1318b60a",
  "displayName": "Workspace New displayName",
  "description": "Workspace New description",
  "type": "Workspace",
  "domainId": "686177b9-ef29-45e4-a5db-1786ca6dbb9f",
  "capacityRegion": "East US"
}

Definities

Name	Description
CapacityRegion	De regio van de capaciteit die aan deze werkruimte is gekoppeld. Er kunnen in de loop van de tijd extra capaciteitsregiowaarden worden toegevoegd.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
UpdateWorkspaceRequest	Werk de nettolading van de werkruimteaanvraag bij.
Workspace	Een werkruimteobject.
WorkspaceAppliedTag	Vertegenwoordigt een toegepaste tag.
WorkspaceType	Een werkruimtetype. Er kunnen in de loop van de tijd extra werkruimtetypen worden toegevoegd.

CapacityRegion

Opsomming

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

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.
isRetriable	boolean	Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de `Retry-After` antwoordheader om de vertraging te bepalen, indien beschikbaar.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string (uuid)	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.

UpdateWorkspaceRequest

Object

Werk de nettolading van de werkruimteaanvraag bij.

Name	Type	Description
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. Werkruimtenamen moeten uniek zijn binnen de tenant. 'Beheerbewaking' is een gereserveerde werkruimtenaam.

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.
capacityRegion	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	WorkspaceAppliedTag[]	Lijst met toegepaste tags.
type	WorkspaceType	Het type werkruimte.

WorkspaceAppliedTag

Object

Vertegenwoordigt een toegepaste tag.

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

WorkspaceType

Opsomming

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.