Git - Delete Workspace Relation

サービス:
Core
API バージョン:
v1

ワークスペースのリレーションシップを削除します。

Note

この API はプレビュー リリースの一部であり、評価と開発のみを目的として提供されます。 フィードバックに基づいて変更される可能性があり、運用環境での使用はお勧めしません。

リレーションシップ ID で識別される 2 つのワークスペース間の既存のワークスペース関係を削除します。 指定されたワークスペース ID には、基本ワークスペースまたはブランチ ワークスペースのいずれかを指定できます。

Permissions

呼び出し元には、指定されたワークスペースに 対する管理者 ワークスペース ロールが必要です。

必要な委任スコープ

Workspace.ReadWrite.All

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

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

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

Interface

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/workspaceRelations/{workspaceRelationId}

URI パラメーター

名前 / 必須 型 説明
workspaceId
 path True

string (uuid)

ワークスペース ID。
workspaceRelationId
 path True

string (uuid)

ワークスペースの関係 ID。

応答

名前 型 説明
200 OK

要求は正常に完了しました。
429 Too Many Requests

ErrorResponse

サービス レートの制限を超えました。 サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す Retry-After ヘッダーを返します。

ヘッダー

Retry-After: integer
Other Status Codes

ErrorResponse

一般的なエラー コード:

  • InsufficientPrivileges - 呼び出し元に十分なワークスペースアクセス許可がありません。

  • WorkspaceNotFound - 指定されたワークスペースが見つかりませんでした。

  • WorkspaceRelationNotFound - 指定されたワークスペースの関係が見つかりませんでした。

  • WorkspaceNotInvolvedInRelation - ワークスペースは、指定されたリレーションシップに関係しません。

  • WorkspaceRelationTypeNotBranch - リレーションシップはブランチ リレーションシップではないため、このエンドポイントを介して削除することはできません。

例

Delete a workspace relation example

要求のサンプル

DELETE https://api.fabric.microsoft.com/v1/workspaces/55555555-5555-5555-5555-555555555555/git/workspaceRelations/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa

応答のサンプル

状態コード:
200

定義

名前 説明
ErrorRelatedResource

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

エラー応答。
ErrorResponseDetails

エラー応答の詳細。

ErrorRelatedResource

Object

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

名前 型 説明
resourceId

string

エラーに関係するリソース ID。
resourceType

string

エラーに関係するリソースの種類。

ErrorResponse

Object

エラー応答。

名前 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
isRetriable

boolean

true の場合、要求を再試行できます。 Retry-After応答ヘッダーを使用して、遅延 (使用可能な場合) を決定します。
message

string

エラーの人間が理解可能な表現。
moreDetails

ErrorResponseDetails[]

その他のエラーの詳細の一覧。
relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。
requestId

string (uuid)

エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前 型 説明
errorCode

string

エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message

string

エラーの人間が理解可能な表現。
relatedResource

ErrorRelatedResource

エラー関連のリソースの詳細。