Workspaces - Grant Admin Temporary Access

Služba:: Admin

Verze rozhraní API:: v1

Uděluje správci dočasný (24h) přístup k pracovnímu prostoru uživatele.

Povolení

Volající musí být správcem Fabric nebo se ověřovat pomocí instančního objektu.

Požadované delegované rozsahy

Tenant.ReadWrite.All

Omezení

Maximálně 25 požadavků za minutu.

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Support
User	Ano
Hlavní služba a Spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.

Odpovědi

Name Typ Description

200 OK

Name	Typ	Description
200 OK		OK
429 Too Many Requests	ErrorResponse	Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku `Retry-After` udávající, kolik sekund musí klient čekat před odesláním dalších požadavků. Hlavičky Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: EntityNotFound – ID pracovního prostoru neexistuje nebo není pracovním prostorem Můj pracovní prostor. InsufficientScopes – Volající nemá oprávnění k volání rozhraní API. BadRequest – Přístup k osobnímu pracovnímu prostoru již byl udělen. Neautorizováno – K volání rozhraní API mají oprávnění pouze správci tenantů a instanční objekty s rolí správce tenanta.

429 Too Many Requests

ErrorResponse

Byl překročen limit přenosové rychlosti služby. Server vrátí hlavičku Retry-After udávající, kolik sekund musí klient čekat před odesláním dalších požadavků.

Hlavičky

Retry-After: integer

Other Status Codes

ErrorResponse

Běžné kódy chyb:

EntityNotFound – ID pracovního prostoru neexistuje nebo není pracovním prostorem Můj pracovní prostor.
InsufficientScopes – Volající nemá oprávnění k volání rozhraní API.
BadRequest – Přístup k osobnímu pracovnímu prostoru již byl udělen.
Neautorizováno – K volání rozhraní API mají oprávnění pouze správci tenantů a instanční objekty s rolí správce tenanta.

Příklady

Grant admin temporary access to workspace example

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 200

Definice

Name	Description
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který se podílí na chybě.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
isRetriable	boolean	Pokud je hodnota true, je možné požadavek opakovat. Pomocí hlavičky `Retry-After` odpovědi určete zpoždění, pokud je k dispozici.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string (uuid)	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou