Workspaces - Grant Admin Temporary Access

Service:: Admin

API-versie:: v1

Verleent beheerders tijdelijk (24 uur) toegang tot de 'Mijn werkruimte' van een gebruiker.

toestemmingen

De beller moet een Fabric beheerder zijn of verifiëren met behulp van een service-principal.

Vereiste gedelegeerde bevoegdheden

Tenant.ReadWrite.All

Limitations

Maximaal 25 aanvragen per minuut.

Door Microsoft Entra ondersteunde identiteiten

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

Identity	Support
User	Ja
serviceprincipal en beheerde identiteiten	Ja

Interface

POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/grantAdminTemporaryAccess

URI-parameters

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

Antwoorden

Name Type Description

200 OK

Name	Type	Description
200 OK		OK
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: EntityNotFound: de werkruimte-id bestaat niet of de werkruimte is geen 'Mijn werkruimte'. InsufficientScopes: de aanroeper heeft geen machtigingen om de API aan te roepen. BadRequest: toegang tot de persoonlijke werkruimte is al verleend. Niet gemachtigd: alleen tenantbeheerders en service-principals met de rol tenantbeheerder zijn gemachtigd om de API aan te roepen.

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:

EntityNotFound: de werkruimte-id bestaat niet of de werkruimte is geen 'Mijn werkruimte'.
InsufficientScopes: de aanroeper heeft geen machtigingen om de API aan te roepen.
BadRequest: toegang tot de persoonlijke werkruimte is al verleend.
Niet gemachtigd: alleen tenantbeheerders en service-principals met de rol tenantbeheerder zijn gemachtigd om de API aan te roepen.

Voorbeelden

Grant admin temporary access to workspace example

Voorbeeldaanvraag

HTTP

POST https://api.fabric.microsoft.com/v1/admin/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/grantAdminTemporaryAccess

Voorbeeldrespons

Statuscode:: 200

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	De foutreactie.
ErrorResponseDetails	De details van het foutbericht.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-ID die betrokken is bij het probleem.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

De foutreactie.

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	Details van de foutgerelateerde resource.
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	Details van de foutgerelateerde resource.