次の方法で共有

Git - Update From Git

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

接続されたブランチにプッシュされたコミットでワークスペースを更新します。
この API は、実行時間の長い操作 (LRO)をサポートします。

この API を使用するには、呼び出し元の Git 資格情報を Update My Git Credentials API を使用して構成する必要があります。 Get My Git Credentials API を使用して、Git 資格情報の構成を確認できます。

更新プログラムは、これらのコミットで変更されたワークスペース内の項目にのみ影響します。 Connect API と Initialize Connection API の後に呼び出されると、ワークスペース全体の完全な更新が実行されます。

権限

呼び出し元には、共同作成者 以上のワークスペース ロールが必要です。

必要な委任されたスコープ

Workspace.GitUpdate.All

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

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

アイデンティティ 支援
ユーザー イエス
サービス プリンシパルの とマネージド ID の 操作に関係するすべての 項目 がサービス プリンシパルをサポートしている場合にのみサポートされます

インターフェイス

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/updateFromGit

URI パラメーター

名前 / 必須 型 説明
workspaceId
 path True

string (uuid)

ワークスペース ID。

要求本文

名前 必須 型 説明
remoteCommitHash True

string

リモート完全 SHA コミット ハッシュ。
conflictResolution

WorkspaceConflictResolution

Git 操作からの更新で使用される競合の解決。 項目が競合していて、競合解決が指定されていない場合、更新操作は開始されません。
options

UpdateOptions

Git 操作からの更新で使用するオプション
workspaceHead

string

ワークスペースが同期されている完全な SHA ハッシュ。 この値は、接続の初期化後にのみ null にすることができます。 それ以外の場合、システムは、指定された値がシステムに認識されているヘッドと一致していることを検証します。

応答

名前 型 説明
200 OK

要求は正常に完了しました。
202 Accepted

承諾を要求し、進行中の Git から更新します。

ヘッダー

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

一般的なエラー コード:

  • WorkspaceNotConnectedToGit - ワークスペースが git に接続されていません。

  • WorkspaceHasNoCapacityAssigned - ワークスペースに割り当てられた容量がありません。

  • WorkspaceHeadMismatch - 要求のヘッドがシステム内のヘッドと一致しません。

  • WorkspacePreviousOperationInProgress - 前の操作はまだ進行中です。

  • MissingDependency - 更新操作に依存関係がありません。

  • PotentialDuplicateDisplayNameAndType - 更新操作では、重複する表示名と種類が作成されます。

  • DependencyDeletionFailed - 更新操作では、ハード依存関係が削除されます。

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

  • PrincipalTypeNotSupported - 呼び出し元 ID の種類はサポートされていません。

例

Update a workspace using data from a Git example

要求のサンプル

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/updateFromGit

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

応答のサンプル

状態コード:
200
状態コード:
202 
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

定義

名前 説明
ConflictResolutionPolicy

競合解決ポリシー。 競合解決ポリシーが時間の経過と同時に追加される場合があります。
ConflictResolutionType

競合解決の種類。 競合解決の種類が時間の経過と同時に追加される場合があります。
ErrorRelatedResource

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

エラー応答。
ErrorResponseDetails

エラー応答の詳細。
UpdateFromGitRequest

Git 要求データからの更新が含まれています。
UpdateOptions

Git からの更新に対して有効になっているオプションが含まれています。
WorkspaceConflictResolution

基本的な競合解決データ。

ConflictResolutionPolicy

列挙

競合解決ポリシー。 競合解決ポリシーが時間の経過と同時に追加される場合があります。

値 説明
PreferRemote

リモート Git 側のコンテンツを優先します。
PreferWorkspace

ワークスペース側のコンテンツを優先します。

ConflictResolutionType

列挙

競合解決の種類。 競合解決の種類が時間の経過と同時に追加される場合があります。

値 説明
Workspace

ワークスペース レベルを表す競合解決。

ErrorRelatedResource

Object

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

名前 型 説明
resourceId

string

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

string

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

ErrorResponse

Object

エラー応答。

名前 型 説明
errorCode

string

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

string

エラーの人間が判読できる表現。
moreDetails

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string

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

ErrorResponseDetails

Object

エラー応答の詳細。

名前 型 説明
errorCode

string

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

string

エラーの人間が判読できる表現。
relatedResource

ErrorRelatedResource

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

UpdateFromGitRequest

Object

Git 要求データからの更新が含まれています。

名前 型 説明
conflictResolution

WorkspaceConflictResolution

Git 操作からの更新で使用される競合の解決。 項目が競合していて、競合解決が指定されていない場合、更新操作は開始されません。
options

UpdateOptions

Git 操作からの更新で使用するオプション
remoteCommitHash

string

リモート完全 SHA コミット ハッシュ。
workspaceHead

string

ワークスペースが同期されている完全な SHA ハッシュ。 この値は、接続の初期化後にのみ null にすることができます。 それ以外の場合、システムは、指定された値がシステムに認識されているヘッドと一致していることを検証します。

UpdateOptions

Object

Git からの更新に対して有効になっているオプションが含まれています。

名前 型 説明
allowOverrideItems

boolean

Git プロセスからの更新中に受信項目をオーバーライドすることにユーザーの同意。 受信項目が存在し、許可オーバーライド項目が指定されていないか、false として指定されている場合、更新操作は開始されません。 既定値は false です。

WorkspaceConflictResolution

Object

基本的な競合解決データ。

名前 型 説明
conflictResolutionPolicy

ConflictResolutionPolicy

競合解決ポリシー。 競合解決ポリシーが時間の経過と同時に追加される場合があります。
conflictResolutionType

ConflictResolutionType

競合解決の種類。 競合解決の種類が時間の経過と同時に追加される場合があります。