Git - Get Status

リファレンス

サービス:: Core

API バージョン:: v1

Git にコミットできるワークスペース内の項目の Git status を返します。
この API は、実行時間の長い操作 (LRO)をサポートします。

状態は、最後のワークスペースとリモートブランチの同期以降の項目への変更を示します。両方の場所が変更された場合、API は競合にフラグを設定します。

権限

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

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

Workspace.GitUpdate.All または Workspace.GitCommit.All

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

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

同一性	支える
利用者	はい
サービスプリンシパルのとマネージド ID の	いいえ

インターフェイス

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status

URI パラメーター

名前	/	必須	型	説明
workspaceId	path	True	string uuid	ワークスペース ID。

応答

名前	型	説明
200 OK	GitStatusResponse	要求は正常に完了しました。
202 Accepted		要求は受け入れ済み、進行中の状態を取得します。ヘッダー Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラーコード: WorkspaceNotConnectedToGit - ワークスペースが git に接続されていません。 WorkspaceHasNoCapacityAssigned - ワークスペースが容量にありません。 InsufficientPrivileges - 呼び出し元に十分なワークスペースアクセス許可がありません。

名前

型

説明

200 OK

GitStatusResponse

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

202 Accepted

要求は受け入れ済み、進行中の状態を取得します。

ヘッダー

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

一般的なエラーコード:

WorkspaceNotConnectedToGit - ワークスペースが git に接続されていません。
WorkspaceHasNoCapacityAssigned - ワークスペースが容量にありません。
InsufficientPrivileges - 呼び出し元に十分なワークスペースアクセス許可がありません。

例

Get status example

Get status no changes example

Get status with conflict example

Get status example

要求のサンプル

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

応答のサンプル

状態コード:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
        },
        "itemType": "SemanticModel",
        "displayName": "My new dataset in the workspace"
      },
      "workspaceChange": "Added",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "1423f3b4-dba5-44c1-a94f-6ae4d776369a"
        },
        "itemType": "Report",
        "displayName": "My deleted report in Git"
      },
      "remoteChange": "Deleted",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
          "objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
        },
        "itemType": "SemanticModel",
        "displayName": "Modified dataset in the workspace"
      },
      "workspaceChange": "Modified",
      "conflictType": "None"
    }
  ]
}

状態コード:: 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

Get status no changes example

要求のサンプル

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

応答のサンプル

状態コード:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}

状態コード:: 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

Get status with conflict example

要求のサンプル

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

応答のサンプル

状態コード:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "222e8d7b-4a95-4c02-8ccd-6faef5ba1bd2",
          "objectId": "8853f3b4-dbb8-33c1-a84f-6ae4d776362a"
        },
        "itemType": "Report",
        "displayName": "Modified report on both sides"
      },
      "remoteChange": "Modified",
      "workspaceChange": "Modified",
      "conflictType": "Conflict"
    }
  ]
}

状態コード:: 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

定義

名前	説明
ChangeType	アイテムの変更。変更された型は、時間の経過と同時に追加される可能性があります。
ConflictType	ワークスペースとリモートの両方の項目の変更。変更された型は、時間の経過と同時に追加される可能性があります。
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
GitStatusResponse	状態の応答を格納します。
ItemChange	アイテムの変更情報を格納します。
ItemIdentifier	アイテム識別子を格納します。少なくとも 1 つのプロパティを定義する必要があります。
ItemMetadata	項目メタデータを格納します。
ItemType	アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。

ChangeType

列挙

アイテムの変更。変更された型は、時間の経過と同時に追加される可能性があります。

値	説明
Added	新しく作成された項目。
Deleted	アイテムが削除されました。
Modified	アイテムの内容が変更されました。

ConflictType

列挙

ワークスペースとリモートの両方の項目の変更。変更された型は、時間の経過と同時に追加される可能性があります。

値	説明
Conflict	ワークスペースとリモート Git の項目には、さまざまな変更があります。
None	項目に変更はありません。
SameChanges	ワークスペースとリモート Git の項目に同じ変更があります。

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	エラー関連のリソースの詳細。

GitStatusResponse

Object

状態の応答を格納します。

名前	型	説明
changes	ItemChange[]	指定されたワークスペースに適用されていないリモート Git の変更と、リモート Git に適用されていないワークスペース内の変更の一覧。
remoteCommitHash	string	リモート完全 SHA コミットハッシュ。
workspaceHead	string	ワークスペースが同期されている完全な SHA ハッシュ。

ItemChange

Object

アイテムの変更情報を格納します。

名前	型	説明
conflictType	ConflictType	ワークスペース側とリモート Git 側の両方に変更がある場合。
itemMetadata	ItemMetadata	項目のメタデータ。
remoteChange	ChangeType	リモート Git 側で変更します。
workspaceChange	ChangeType	ワークスペース側で変更します。

ItemIdentifier

Object

アイテム識別子を格納します。少なくとも 1 つのプロパティを定義する必要があります。

名前	型	説明
logicalId	string uuid	項目の論理 ID。アイテムがまだワークスペースに追加されていないために論理 ID を使用できない場合は、オブジェクト ID を使用できます。
objectId	string uuid	項目のオブジェクト ID。アイテムがワークスペースから削除されたためにオブジェクト ID を使用できない場合は、論理 ID を使用できます。

ItemMetadata

Object

項目メタデータを格納します。

名前	型	説明
displayName	string	アイテムの表示名。ワークスペースアイテムが存在する場合は表示名を優先し、それ以外の場合は displayName はリモートアイテムの表示名を使用します。
itemIdentifier	ItemIdentifier	アイテム識別子。
itemType	ItemType	アイテムの種類。

ItemType

列挙

アイテムの種類。追加の項目の種類は、時間の経過と同時に追加される場合があります。

値	説明
Dashboard	PowerBI ダッシュボード。
DataPipeline	データパイプライン。
Datamart	PowerBI データマート。
Environment	環境。
Eventhouse	イベントハウス。
Eventstream	イベントストリーム。
GraphQLApi	GraphQL 項目の API。
KQLDashboard	KQL ダッシュボード。
KQLDatabase	KQL データベース。
KQLQueryset	KQL クエリセット。
Lakehouse	レイクハウス。
MLExperiment	機械学習の実験。
MLModel	機械学習モデル。
MirroredDatabase	ミラー化されたデータベース。
MirroredWarehouse	ミラー化された倉庫。
MountedDataFactory	MountedDataFactory。
Notebook	ノートブック。
PaginatedReport	PowerBI のページ分割されたレポート。
Reflex	反射。
Report	PowerBI レポート。
SQLDatabase	SQLDatabase。
SQLEndpoint	SQL エンドポイント。
SemanticModel	PowerBI セマンティックモデル。
SparkJobDefinition	Spark ジョブ定義。
Warehouse	倉庫。

次の方法で共有

Git - Get Status

権限

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

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

インターフェイス

URI パラメーター

応答

例

Get status example

要求のサンプル

応答のサンプル

Get status no changes example

要求のサンプル

応答のサンプル

Get status with conflict example

要求のサンプル

応答のサンプル

定義

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType

その他のリソース