Workspaces - Remove Admin Temporary Access

Service:

Admin

API バージョン:

v1

ユーザーの "マイ ワークスペース" から管理者の一時的なアクセスを削除します。

アクセス許可

呼び出し元は、Fabric管理者であるか、サービス プリンシパルを使用して認証する必要があります。

必要な委任スコープ

Tenant.ReadWrite.All

制限事項

1 分あたり最大 25 要求。

Microsoft Entra でサポートされている ID

この API では、このセクションに記載されている Microsoft ID がサポートされています。

Identity	Support
ユーザー	はい
サービス プリンシパルとマネージド ID	はい

Interface

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

URI パラメーター

Name	/	必須	型	説明
workspaceId	path	True	string (uuid)	ワークスペース ID。

応答

Name	型	説明
200 OK		[OK]
429 Too Many Requests	ErrorResponse	サービス レートの制限を超えました。 サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す Retry-After ヘッダーを返します。 ヘッダー Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラー コード: EntityNotFound - ワークスペース ID が存在しないか、ワークスペースが 'マイ ワークスペース' ではありません。 InsufficientScopes - 呼び出し元に API を呼び出すアクセス許可がありません。 BadRequest - 呼び出し元は現在、指定された個人用ワークスペースにアクセスできません。 未承認 - テナント管理者ロールを持つテナント管理者とサービス プリンシパルのみが API を呼び出す権限を持ちます。

例

Remove admin temporary access from workspace example

要求のサンプル

HTTP

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

応答のサンプル

状態コード:

200

定義

Name	説明
ErrorParameter	エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。

ErrorParameter

Object

エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。

Name	型	説明
message	string	パラメーターの意味を人間が判読できる説明。
name	string	パラメータ識別子です。
value	string	パラメーターの値を指定します。

ErrorRelatedResource

Object

エラー関連のリソース詳細オブジェクト。

Name	型	説明
resourceId	string	エラーに関係するリソース ID。
resourceType	string	エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

Name	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
isRetriable	boolean	true の場合、要求を再試行できます。 Retry-After応答ヘッダーを使用して、遅延 (使用可能な場合) を決定します。
message	string	エラーの人間が理解可能な表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
parameters	ErrorParameter[]	エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string (uuid)	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

Name	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が理解可能な表現。
parameters	ErrorParameter[]	エラーに関する追加のコンピューター読み取り可能なコンテキストを提供する構造化パラメーター。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。