OneLake Data Access Security - Get Data Access Role

サービス:: Core

API バージョン:: v1

指定されたロール名のデータアクセスロールの詳細を返します。

注

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

この API を呼び出すとき、呼び出し元はクエリパラメーター trueの値としてpreviewを指定する必要があります。

Permissions

呼び出し元には、ワークスペースの メンバー 以上のロールが必要です。

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

OneLake.Read.All または OneLake.ReadWrite.All

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

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

アイデンティティ	Support
ユーザー	イエス
サービスプリンシパルとマネージド ID	イエス

インターフェイス

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/dataAccessRoles/{roleName}

URI パラメーター

名前	/	必須	型	説明
itemId	path	True	string (uuid)	ロールを取得する Fabric 項目の ID。
roleName	path	True	string	取得するロールの名前。
workspaceId	path	True	string (uuid)	ワークスペース ID。

要求ヘッダー

名前	必須	型	説明
If-Match		string	ETag 値。 ETag は引用符で囲む必要があります。指定した場合、呼び出しは、リソースの ETag が指定された ETag と一致する場合にのみ成功します。
If-None-Match		string	ETag 値。 ETag は引用符で囲む必要があります。指定した場合、呼び出しは、リソースの ETag が指定された ETag と一致しない場合にのみ成功します。

応答

名前型説明

200 OK

名前	型	説明
200 OK	DataAccessRoleBase	要求は正常に完了しました。ヘッダー ETag: string
429 Too Many Requests	ErrorResponse	サービスレートの制限を超えました。サーバーは、クライアントが追加の要求を送信するまでに待機する必要がある時間を秒単位で示す `Retry-After` ヘッダーを返します。ヘッダー Retry-After: integer
Other Status Codes	ErrorResponse	一般的なエラーコード: ItemNotFound - サーバーが要求された項目を見つけることができないことを示します。 RoleNotFound - 指定されたロールが見つからなかったことを示します。 PreconditionFailed - 現在のリソース ETag が、If-Match ヘッダーで指定された値と一致しないことを示します。

DataAccessRoleBase

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

ヘッダー

ETag: string

429 Too Many Requests

ErrorResponse

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

ヘッダー

Retry-After: integer

Other Status Codes

ErrorResponse

一般的なエラーコード:

ItemNotFound - サーバーが要求された項目を見つけることができないことを示します。
RoleNotFound - 指定されたロールが見つからなかったことを示します。
PreconditionFailed - 現在のリソース ETag が、If-Match ヘッダーで指定された値と一致しないことを示します。

例

Get data access role example

要求のサンプル

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/dataAccessRoles/DefaultReader

応答のサンプル

状態コード:: 200

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4

{
  "name": "DefaultReader",
  "decisionRules": [
    {
      "effect": "Permit",
      "permission": [
        {
          "attributeName": "Path",
          "attributeValueIncludedIn": [
            "Tables/schema1",
            "Tables/schema2/TableB"
          ]
        },
        {
          "attributeName": "Action",
          "attributeValueIncludedIn": [
            "Read",
            "ReadWrite"
          ]
        }
      ],
      "constraints": {
        "columns": [
          {
            "tablePath": "Tables/schema1/TableB",
            "columnNames": [
              "*"
            ],
            "columnEffect": "Permit",
            "columnAction": [
              "Read"
            ]
          }
        ],
        "rows": [
          {
            "tablePath": "Tables/schema1/TableC",
            "value": "select * from [schema1].[TableC] where name = 'Aaron' AND country = 'USA'"
          }
        ]
      }
    }
  ],
  "members": {
    "fabricItemMembers": [
      {
        "sourcePath": "cfafbeb1-8037-4d0c-896e-a46fb27ff222/25bac802-080d-4f73-8a42-1b406eb1fceb",
        "itemAccess": [
          "ReadAll"
        ]
      }
    ],
    "microsoftEntraMembers": [
      {
        "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
        "objectId": "EAF3B3B8-524A-4EC6-A96F-3340748DF869"
      }
    ]
  }
}

定義

名前	説明
AttributeName	アクセス許可を評価する属性の名前を指定します。 AttributeName は、`Path` または `Action`できます。 attributeName 型は、時間の経過と同時に追加される場合があります。
ColumnAction	columnNames に適用されるアクションの配列。これにより、ユーザーが列に対して実行できるアクションが決まります。使用できる値は、 Read です。 columnAction 型は、時間の経過と同時に追加される場合があります。
ColumnConstraint	ColumnConstraint は、ユーザーがテーブル内の列に対して持つ権限と可視性を決定する制約を示します。
ColumnEffect	columnNames に与えられる効果。許可される値は Permit のみです。 columnEffect 型は、時間の経過と同時に追加される場合があります。
Constraints	このロールの一部としてテーブルに適用される行レベルまたは列レベルのセキュリティなどの制約。含まれていない場合、ロール内のどのテーブルにも制約は適用されません。
DataAccessRoleBase	単一ロール操作に使用される基本データアクセスロールオブジェクト (ID は含まれません)。スコープ付きデータに対して許可されるアクションを定義するアクセス許可とアクセス許可スコープのセットを表します。
DecisionRule	要求されたアクションに一致するルールを指定します。リソースに対して特定のアクション (読み取りなど) を実行する権限をユーザーまたはエンティティに付与するかどうかを決定する効果 (許可) とアクセス許可が含まれます。アクセス許可は、適用するルールの要求されたアクションと一致する必要がある、属性によって定義される一連のスコープです。
Effect	ロールがデータリソースへのアクセスに与える影響。現在、サポートされている効果の種類は `Permit`のみです。この種類では、リソースへのアクセスが許可されます。追加の効果の種類は、時間の経過と同時に追加される場合があります。
ErrorRelatedResource	エラー関連のリソース詳細オブジェクト。
ErrorResponse	エラー応答。
ErrorResponseDetails	エラー応答の詳細。
FabricItemMember	ファブリック項目メンバー。
ItemAccess	Fabric ユーザーがロールメンバーに自動的に含める必要があるアクセス許可を指定するリスト。追加の itemAccess 型は、時間の経過と同時に追加される場合があります。
Members	さまざまなメンバー型の配列としてロールのメンバーを含む members オブジェクト。
MicrosoftEntraMember	ロールに割り当てられている Microsoft Entra ID メンバー。
ObjectType	Microsoft Entra ID オブジェクトの型。追加の objectType 型は、時間の経過と同時に追加される場合があります。
PermissionScope	リソースへのアクセスのスコープとレベルを決定する属性 (プロパティ) のセットを定義します。 `attributeName` プロパティが `Path`に設定されている場合、`attributeValueIncludedIn` プロパティはアクセスするリソースの場所 ("Tables/Table1" など) を指定する必要があります。 `attributeName` プロパティが `Action`に設定されている場合、`attributeValueIncludedIn` プロパティは、許可するアクセスの種類 (`Read`など) を指定する必要があります。
RowConstraint	RowConstraint は、ユーザーが表示できるテーブル内の行を決定する制約を示します。 RowConstraints で定義されたロールは、T-SQL を使用して、テーブル内のデータをフィルター処理する述語を定義します。述語の条件を満たしていない行はフィルターで除外され、元の行のサブセットが残ります。 RowConstraints を使用して、T-SQL を使用して RLS の動的および複数テーブルのフレーバーを指定することもできます。

AttributeName

列挙

アクセス許可を評価する属性の名前を指定します。 AttributeName は、Path または Actionできます。 attributeName 型は、時間の経過と同時に追加される場合があります。

値	説明
Path	属性名パス
Action	属性名アクション

ColumnAction

列挙

columnNames に適用されるアクションの配列。これにより、ユーザーが列に対して実行できるアクションが決まります。使用できる値は、 Read です。 columnAction 型は、時間の経過と同時に追加される場合があります。

値	説明
Read	ColumnAction 値 Read

ColumnConstraint

Object

ColumnConstraint は、ユーザーがテーブル内の列に対して持つ権限と可視性を決定する制約を示します。

名前	型	説明
columnAction	ColumnAction[]	columnNames に適用されるアクションの配列。これにより、ユーザーが列に対して実行できるアクションが決まります。使用できる値は、 Read です。 columnAction 型は、時間の経過と同時に追加される場合があります。
columnEffect	ColumnEffect	columnNames に与えられる効果。許可される値は Permit のみです。 columnEffect 型は、時間の経過と同時に追加される場合があります。
columnNames	string[]	大文字と小文字を区別する列名の配列。各値は、 `tablePath`で指定されたテーブルの列名です。 `columnEffect`と`columnAction`でこれらの列を使用します。一覧にない列は、既定値 null を取得します。テーブル内のすべての列を示すには、 `*` を使用します。
tablePath	string	列制約が適用されるテーブルを指定する相対ファイルパス。これは、 `/Tables/{optionalSchema}/{tableName}`の形式である必要があります。ここで指定できる値は 1 つだけで、tableName は PermissionScope に含まれるテーブルである必要があります。

ColumnEffect

列挙

columnNames に与えられる効果。許可される値は Permit のみです。 columnEffect 型は、時間の経過と同時に追加される場合があります。

値	説明
Permit	ColumnEffect 型の Permit

Constraints

Object

このロールの一部としてテーブルに適用される行レベルまたは列レベルのセキュリティなどの制約。含まれていない場合、ロール内のどのテーブルにも制約は適用されません。

名前	型	説明
columns	ColumnConstraint[]	データアクセスロールの 1 つ以上のテーブルに適用される列制約の配列。
rows	RowConstraint[]	データアクセスロールの 1 つ以上のテーブルに適用される行制約の配列。

DataAccessRoleBase

Object

単一ロール操作に使用される基本データアクセスロールオブジェクト (ID は含まれません)。スコープ付きデータに対して許可されるアクションを定義するアクセス許可とアクセス許可スコープのセットを表します。

名前	型	説明
decisionRules	DecisionRule[]	データアクセスロールを構成するアクセス許可の配列。
members	Members	さまざまなメンバー型の配列としてロールのメンバーを含む members オブジェクト。
name	string	データアクセスロールの名前。

DecisionRule

Object

要求されたアクションに一致するルールを指定します。リソースに対して特定のアクション (読み取りなど) を実行する権限をユーザーまたはエンティティに付与するかどうかを決定する効果 (許可) とアクセス許可が含まれます。アクセス許可は、適用するルールの要求されたアクションと一致する必要がある、属性によって定義される一連のスコープです。

名前	型	説明
constraints	Constraints	このロールの一部としてテーブルに適用される行レベルまたは列レベルのセキュリティなどの制約。含まれていない場合、ロール内のどのテーブルにも制約は適用されません。
effect	Effect	ロールがデータリソースへのアクセスに与える影響。現在、サポートされている効果の種類は `Permit`のみです。この種類では、リソースへのアクセスが許可されます。追加の効果の種類は、時間の経過と同時に追加される場合があります。
permission	PermissionScope[]	`permission` プロパティは、要求されたアクションのアクセスのスコープとレベルを指定する配列です。配列には、`Path` と `Action`の 2 つの PermissionScope オブジェクトが含まれている必要があります。 `scope` は、`PermissionScope` オブジェクトを使用して定義され、アクセスするリソースの場所または付与されるアクションの種類を指定 `attributeValueIncludedIn`。 `access` は、`Read`など、付与されるアクセスのレベルを指します。

Effect

列挙

ロールがデータリソースへのアクセスに与える影響。現在、サポートされている効果の種類は Permitのみです。この種類では、リソースへのアクセスが許可されます。追加の効果の種類は、時間の経過と同時に追加される場合があります。

値	説明
Permit	効果の種類の許可

ErrorRelatedResource

Object

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

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

ErrorResponse

Object

エラー応答。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
moreDetails	ErrorResponseDetails[]	その他のエラーの詳細の一覧。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。
requestId	string (uuid)	エラーに関連付けられている要求の ID。

ErrorResponseDetails

Object

エラー応答の詳細。

名前	型	説明
errorCode	string	エラー状態に関する情報を提供し、サービスとそのユーザー間の標準化された通信を可能にする特定の識別子。
message	string	エラーの人間が判読できる表現。
relatedResource	ErrorRelatedResource	エラー関連のリソースの詳細。

FabricItemMember

Object

ファブリック項目メンバー。

名前	型	説明
itemAccess	ItemAccess[]	Fabric ユーザーがロールメンバーに自動的に含める必要があるアクセス許可を指定するリスト。追加の itemAccess 型は、時間の経過と同時に追加される場合があります。
sourcePath	string pattern: ^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?/[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$	指定した項目へのアクセス権を持つ Fabric 項目へのパス。

ItemAccess

列挙

Fabric ユーザーがロールメンバーに自動的に含める必要があるアクセス許可を指定するリスト。追加の itemAccess 型は、時間の経過と同時に追加される場合があります。

値	説明
Read	アイテムアクセス読み取り。
Write	アイテムアクセス書き込み。
Reshare	アイテムアクセスの再共有。
Explore	アイテムアクセスの探索。
Execute	アイテムアクセス実行。
ReadAll	Item Access ReadAll。

Members

Object

さまざまなメンバー型の配列としてロールのメンバーを含む members オブジェクト。

名前	型	説明
fabricItemMembers	FabricItemMember[]	Microsoft Fabric で特定のアクセス許可が設定されているメンバーの一覧。そのアクセス許可セットを持つすべてのメンバーは、このデータアクセスロールのメンバーとして追加されます。
microsoftEntraMembers	MicrosoftEntraMember[]	Microsoft Entra ID メンバーの一覧。

MicrosoftEntraMember

Object

ロールに割り当てられている Microsoft Entra ID メンバー。

名前	型	説明
objectId	string (uuid)	オブジェクト ID。
objectType	ObjectType	Microsoft Entra ID オブジェクトの型。追加の objectType 型は、時間の経過と同時に追加される場合があります。
tenantId	string (uuid)	テナント ID。

ObjectType

列挙

Microsoft Entra ID オブジェクトの型。追加の objectType 型は、時間の経過と同時に追加される場合があります。

値	説明
Group	属性名グループ
User	属性名ユーザー
ServicePrincipal	属性名 ServicePrincipal
ManagedIdentity	属性名 ManagedIdentity

PermissionScope

Object

リソースへのアクセスのスコープとレベルを決定する属性 (プロパティ) のセットを定義します。 attributeName プロパティが Pathに設定されている場合、attributeValueIncludedIn プロパティはアクセスするリソースの場所 ("Tables/Table1" など) を指定する必要があります。 attributeName プロパティが Actionに設定されている場合、attributeValueIncludedIn プロパティは、許可するアクセスの種類 (Readなど) を指定する必要があります。

名前	型	説明
attributeName	AttributeName	アクセス許可を評価する属性の名前を指定します。 AttributeName は、`Path` または `Action`できます。 attributeName 型は、時間の経過と同時に追加される場合があります。
attributeValueIncludedIn	string[]	リソースへのスコープとアクセスレベルを定義する `attributeName` の値の一覧を指定します。 `attributeName` が `Path`場合、`attributeValueIncludedIn` はアクセスするリソースの場所 ("Tables/Table1" など) を指定する必要があります。 `attributeName` が `Action`されている場合、`attributeValueIncludedIn` は、許可するアクセスの種類 (`Read`など) を指定する必要があります。

RowConstraint

Object

RowConstraint は、ユーザーが表示できるテーブル内の行を決定する制約を示します。 RowConstraints で定義されたロールは、T-SQL を使用して、テーブル内のデータをフィルター処理する述語を定義します。述語の条件を満たしていない行はフィルターで除外され、元の行のサブセットが残ります。 RowConstraints を使用して、T-SQL を使用して RLS の動的および複数テーブルのフレーバーを指定することもできます。

名前	型	説明
tablePath	string	行制約が適用されるテーブルを指定する相対ファイルパス。これは、 `/Tables/{optionalSchema}/{tableName}`の形式である必要があります。ここで指定できる値は 1 つだけで、tableName は PermissionScope に含まれるテーブルである必要があります。
value	string	ロールメンバーが表示できる行を評価するために使用される T-SQL 式。述語として使用できるのは、T-SQL のサブセットだけです。

次の方法で共有

OneLake Data Access Security - Get Data Access Role

Permissions

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

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

インターフェイス

URI パラメーター

要求ヘッダー

応答

例

Get data access role example

要求のサンプル

応答のサンプル

定義

AttributeName

ColumnAction

ColumnConstraint

ColumnEffect

Constraints

DataAccessRoleBase

DecisionRule

Effect

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

FabricItemMember

ItemAccess

Members

MicrosoftEntraMember

ObjectType

PermissionScope

RowConstraint