다음을 통해 공유


OneLake Data Access Security - List Data Access Roles

OneLake 역할 목록을 반환합니다.

Note

이 API는 미리 보기 릴리스의 일부이며 평가 및 개발 목적으로만 제공됩니다. 피드백에 따라 변경 될 수 있으며 프로덕션 사용에는 권장되지 않습니다.

필요한 위임된 범위

OneLake.Read.All 또는 OneLake.ReadWrite.All

Microsoft Entra 지원 ID

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

Identity Support
User Yes
서비스 주체관리 ID Yes

Interface

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
itemId
path True

string (uuid)

역할을 배치할 패브릭 항목의 ID입니다.

workspaceId
path True

string (uuid)

작업 영역 ID입니다.

continuationToken
query

string

결과의 다음 페이지를 검색하기 위한 토큰입니다.

응답

Name 형식 Description
200 OK

DataAccessRoles

요청이 성공적으로 완료되었습니다.

헤더

Etag: string

Other Status Codes

ErrorResponse

일반적인 오류 코드:

  • ItemNotFound - 서버에서 요청된 항목을 찾을 수 없음을 나타냅니다.

예제

List data access roles multiple pages example
List data access roles single page example
List data access roles with constraints example
List default data access roles example

List data access roles multiple pages example

샘플 요청

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

샘플 응답

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4
{
  "value": [
    {
      "name": "default_role_1",
      "decisionRules": [
        {
          "effect": "Permit",
          "permission": [
            {
              "attributeName": "Path",
              "attributeValueIncludedIn": [
                "*"
              ]
            },
            {
              "attributeName": "Action",
              "attributeValueIncludedIn": [
                "Read"
              ]
            }
          ]
        }
      ],
      "members": {
        "fabricItemMembers": [
          {
            "itemAccess": [
              "ReadAll"
            ],
            "sourcePath": "cfafbeb1-8037-4d0c-896e-a46fb27ff222/25bac802-080d-4f73-8a42-1b406eb1fceb"
          }
        ]
      }
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/dataAccessRoles?continuationToken=LDEsMTAwMDAwLDA%3D"
}

List data access roles single page example

샘플 요청

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

샘플 응답

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4
{
  "value": [
    {
      "name": "default_role_1",
      "decisionRules": [
        {
          "effect": "Permit",
          "permission": [
            {
              "attributeName": "Path",
              "attributeValueIncludedIn": [
                "*"
              ]
            },
            {
              "attributeName": "Action",
              "attributeValueIncludedIn": [
                "Read"
              ]
            }
          ]
        }
      ],
      "members": {
        "fabricItemMembers": [
          {
            "itemAccess": [
              "ReadAll"
            ],
            "sourcePath": "cfafbeb1-8037-4d0c-896e-a46fb27ff222/25bac802-080d-4f73-8a42-1b406eb1fceb"
          }
        ]
      }
    }
  ]
}

List data access roles with constraints example

샘플 요청

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

샘플 응답

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4
{
  "value": [
    {
      "name": "DefaultReader",
      "decisionRules": [
        {
          "effect": "Permit",
          "permission": [
            {
              "attributeName": "Path",
              "attributeValueIncludedIn": [
                "*"
              ]
            },
            {
              "attributeName": "Action",
              "attributeValueIncludedIn": [
                "Read"
              ]
            }
          ],
          "constraints": {
            "columns": [
              {
                "tablePath": "/Tables/industrytable",
                "columnNames": [
                  "Industry"
                ],
                "columnEffect": "Permit",
                "columnAction": [
                  "Read"
                ]
              }
            ],
            "rows": [
              {
                "tablePath": "/Tables/industrytable",
                "value": "select * from Industrytable where Industry=\"Green\""
              }
            ]
          }
        }
      ],
      "members": {
        "fabricItemMembers": [
          {
            "itemAccess": [
              "ReadAll"
            ],
            "sourcePath": "cfafbeb1-8037-4d0c-896e-a46fb27ff222/25bac802-080d-4f73-8a42-1b406eb1fceb"
          }
        ]
      }
    }
  ]
}

List default data access roles example

샘플 요청

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

샘플 응답

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4
{
  "value": [
    {
      "name": "DefaultReader",
      "decisionRules": [
        {
          "effect": "Permit",
          "permission": [
            {
              "attributeName": "Path",
              "attributeValueIncludedIn": [
                "*"
              ]
            },
            {
              "attributeName": "Action",
              "attributeValueIncludedIn": [
                "Read"
              ]
            }
          ]
        }
      ],
      "members": {
        "fabricItemMembers": [
          {
            "itemAccess": [
              "ReadAll"
            ],
            "sourcePath": "cfafbeb1-8037-4d0c-896e-a46fb27ff222/25bac802-080d-4f73-8a42-1b406eb1fceb"
          }
        ]
      }
    }
  ]
}

정의

Name Description
AttributeName

액세스 권한에 대해 평가되는 특성의 이름을 지정합니다. AttributeName은 Path 또는 Action수 있습니다. 시간이 지남에 따라 추가 attributeName 형식을 추가할 수 있습니다.

ColumnAction

columnNames에 적용된 작업의 배열입니다. 이렇게 하면 사용자가 열에서 수행할 수 있는 작업이 결정됩니다. 허용되는 값은 읽기입니다. 시간이 지남에 따라 추가 columnAction 형식을 추가할 수 있습니다.

ColumnConstraint

ColumnConstraint는 사용자가 테이블 내의 열에 대해 가지고 있는 사용 권한과 가시성을 결정하는 제약 조건을 나타냅니다.

ColumnEffect

columnNames에 지정된 효과입니다. 허용되는 값은 Permit뿐입니다. 시간이 지남에 따라 추가 columnEffect 형식을 추가할 수 있습니다.

Constraints

이 역할의 일부로 테이블에 적용되는 행 또는 열 수준 보안과 같은 모든 제약 조건입니다. 포함되지 않은 경우 역할의 테이블에는 제약 조건이 적용되지 않습니다.

DataAccessRole

데이터 액세스 역할은 해당 멤버가 범위의 데이터에 대해 수행할 수 있는 작업을 정의하는 사용 권한 및 권한 범위 집합을 나타냅니다. 데이터 액세스 역할은 데이터 액세스 보안을 관리하고 권한 있는 사용자만 특정 데이터를 보거나 편집하거나 삭제할 수 있도록 하는 데 사용됩니다. 멤버는 역할을 부여받은 사용자 또는 그룹이며 역할에 할당된 권한에 따라 데이터를 읽을 수 있습니다. 예를 들어 멤버는 Microsoft Entra ID 그룹일 수 있으며 권한 범위는 OneLake의 지정된 파일 경로, 폴더 또는 테이블에 적용된 읽기 작업일 수 있습니다.

DataAccessRoles
DecisionRule

요청된 동작을 일치시키는 규칙을 지정합니다. 사용자 또는 엔터티가 리소스에 대해 특정 작업(예: 읽기)을 수행할 권한이 있는지 여부를 결정하는 효과(허용) 및 권한을 포함합니다. 사용 권한은 특성으로 정의된 범위 집합으로, 규칙이 적용되도록 요청된 작업과 일치해야 합니다.

Effect

역할이 데이터 리소스에 대한 액세스에 미치는 영향입니다. 현재 지원되는 유일한 효과 유형은 Permit리소스에 대한 액세스 권한을 부여합니다. 추가 효과 유형은 시간이 지남에 따라 추가될 수 있습니다.

ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.

ErrorResponse

오류 응답입니다.

ErrorResponseDetails

오류 응답 세부 정보입니다.

FabricItemMember

패브릭 항목 멤버입니다.

ItemAccess

패브릭 사용자가 역할 멤버에 자동으로 포함해야 하는 액세스 권한을 지정하는 목록입니다. 추가 itemAccess 형식은 시간이 지남에 따라 추가될 수 있습니다.

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 형식을 추가할 수 있습니다.

Description
Path

특성 이름 경로

Action

특성 이름 작업

ColumnAction

columnNames에 적용된 작업의 배열입니다. 이렇게 하면 사용자가 열에서 수행할 수 있는 작업이 결정됩니다. 허용되는 값은 읽기입니다. 시간이 지남에 따라 추가 columnAction 형식을 추가할 수 있습니다.

Description
Read

ColumnAction 값 읽기

ColumnConstraint

ColumnConstraint는 사용자가 테이블 내의 열에 대해 가지고 있는 사용 권한과 가시성을 결정하는 제약 조건을 나타냅니다.

Name 형식 Description
columnAction

ColumnAction[]

columnNames에 적용된 작업의 배열입니다. 이렇게 하면 사용자가 열에서 수행할 수 있는 작업이 결정됩니다. 허용되는 값은 읽기입니다. 시간이 지남에 따라 추가 columnAction 형식을 추가할 수 있습니다.

columnEffect

ColumnEffect

columnNames에 지정된 효과입니다. 허용되는 값은 Permit뿐입니다. 시간이 지남에 따라 추가 columnEffect 형식을 추가할 수 있습니다.

columnNames

string[]

대/소문자 구분 열 이름의 배열입니다. 각 값은 에 지정된 테이블의 열 이름입니다 tablePath. 다음 열과 함께 columnEffect 사용하세요 columnAction. 나열되지 않은 열은 기본값 null을 가져옵니다. 테이블의 모든 열을 나타내는 데 사용합니다 * .

tablePath

string

열 제약 조건이 적용되는 테이블을 지정하는 상대 파일 경로입니다. 이 형식은 .의 /Tables/{optionalSchema}/{tableName}형식이어야 합니다. 여기서는 하나의 값만 지정할 수 있으며 tableName은 PermissionScope에 포함된 테이블이어야 합니다.

ColumnEffect

columnNames에 지정된 효과입니다. 허용되는 값은 Permit뿐입니다. 시간이 지남에 따라 추가 columnEffect 형식을 추가할 수 있습니다.

Description
Permit

ColumnEffect 형식 허용

Constraints

이 역할의 일부로 테이블에 적용되는 행 또는 열 수준 보안과 같은 모든 제약 조건입니다. 포함되지 않은 경우 역할의 테이블에는 제약 조건이 적용되지 않습니다.

Name 형식 Description
columns

ColumnConstraint[]

데이터 액세스 역할의 하나 이상의 테이블에 적용되는 열 제약 조건의 배열입니다.

rows

RowConstraint[]

데이터 액세스 역할의 하나 이상의 테이블에 적용되는 행 제약 조건의 배열입니다.

DataAccessRole

데이터 액세스 역할은 해당 멤버가 범위의 데이터에 대해 수행할 수 있는 작업을 정의하는 사용 권한 및 권한 범위 집합을 나타냅니다. 데이터 액세스 역할은 데이터 액세스 보안을 관리하고 권한 있는 사용자만 특정 데이터를 보거나 편집하거나 삭제할 수 있도록 하는 데 사용됩니다. 멤버는 역할을 부여받은 사용자 또는 그룹이며 역할에 할당된 권한에 따라 데이터를 읽을 수 있습니다. 예를 들어 멤버는 Microsoft Entra ID 그룹일 수 있으며 권한 범위는 OneLake의 지정된 파일 경로, 폴더 또는 테이블에 적용된 읽기 작업일 수 있습니다.

Name 형식 Description
decisionRules

DecisionRule[]

데이터 액세스 역할을 구성하는 권한의 배열입니다.

id

string (uuid)

데이터 액세스 역할에 대한 고유 ID입니다.

members

Members

역할의 멤버를 다른 멤버 형식의 배열로 포함하는 멤버 개체입니다.

name

string

데이터 액세스 역할의 이름입니다.

DataAccessRoles

Name 형식 Description
continuationToken

string

다음 결과 집합 일괄 처리에 대한 토큰입니다. 레코드가 더 이상 없으면 응답에서 제거됩니다.

continuationUri

string

다음 결과 집합 일괄 처리의 URI입니다. 레코드가 더 이상 없으면 응답에서 제거됩니다.

value

DataAccessRole[]

데이터 액세스 보안을 관리하고 권한 있는 사용자만 특정 데이터를 볼 수 있도록 하는 데 사용되는 역할 목록입니다. 역할은 해당 멤버가 범위의 데이터에 대해 수행할 수 있는 작업을 정의하는 사용 권한 및 권한 범위 집합을 나타냅니다. 멤버는 역할을 부여받은 사용자 또는 그룹이며 역할에 할당된 권한에 따라 데이터를 읽을 수 있습니다. 예를 들어 멤버는 Microsoft Entra ID 그룹일 수 있으며 권한 범위는 OneLake의 지정된 파일 경로, 폴더 또는 테이블에 적용된 읽기 작업일 수 있습니다.

DecisionRule

요청된 동작을 일치시키는 규칙을 지정합니다. 사용자 또는 엔터티가 리소스에 대해 특정 작업(예: 읽기)을 수행할 권한이 있는지 여부를 결정하는 효과(허용) 및 권한을 포함합니다. 사용 권한은 특성으로 정의된 범위 집합으로, 규칙이 적용되도록 요청된 작업과 일치해야 합니다.

Name 형식 Description
constraints

Constraints

이 역할의 일부로 테이블에 적용되는 행 또는 열 수준 보안과 같은 모든 제약 조건입니다. 포함되지 않은 경우 역할의 테이블에는 제약 조건이 적용되지 않습니다.

effect

Effect

역할이 데이터 리소스에 대한 액세스에 미치는 영향입니다. 현재 지원되는 유일한 효과 유형은 Permit리소스에 대한 액세스 권한을 부여합니다. 추가 효과 유형은 시간이 지남에 따라 추가될 수 있습니다.

permission

PermissionScope[]

permission 속성은 요청된 작업에 대한 액세스 범위 및 수준을 지정하는 배열입니다. 배열에는 정확히 두 개의 PermissionScope 개체인 PathAction포함되어야 합니다. scope 액세스 중인 리소스의 위치 또는 부여되는 작업 유형을 지정하는 PermissionScopeattributeValueIncludedIn 개체를 사용하여 정의됩니다. access Read같은 부여되는 액세스 수준을 나타냅니다.

Effect

역할이 데이터 리소스에 대한 액세스에 미치는 영향입니다. 현재 지원되는 유일한 효과 유형은 Permit리소스에 대한 액세스 권한을 부여합니다. 추가 효과 유형은 시간이 지남에 따라 추가될 수 있습니다.

Description
Permit

효과 유형 허용

ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.

Name 형식 Description
resourceId

string

오류와 관련된 리소스 ID입니다.

resourceType

string

오류와 관련된 리소스의 형식입니다.

ErrorResponse

오류 응답입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.

message

string

사용자가 읽을 수 있는 오류 표현입니다.

moreDetails

ErrorResponseDetails[]

추가 오류 세부 정보 목록입니다.

relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

requestId

string

오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

오류 응답 세부 정보입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.

message

string

사용자가 읽을 수 있는 오류 표현입니다.

relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

FabricItemMember

패브릭 항목 멤버입니다.

Name 형식 Description
itemAccess

ItemAccess[]

패브릭 사용자가 역할 멤버에 자동으로 포함해야 하는 액세스 권한을 지정하는 목록입니다. 추가 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

패브릭 사용자가 역할 멤버에 자동으로 포함해야 하는 액세스 권한을 지정하는 목록입니다. 추가 itemAccess 형식은 시간이 지남에 따라 추가될 수 있습니다.

Description
Read

항목 액세스 읽기.

Write

항목 액세스 쓰기

Reshare

항목 액세스 다시 공유.

Explore

항목 액세스 탐색

Execute

항목 액세스 실행

ReadAll

항목 액세스 ReadAll입니다.

Members

역할의 멤버를 다른 멤버 형식의 배열로 포함하는 멤버 개체입니다.

Name 형식 Description
fabricItemMembers

FabricItemMember[]

Microsoft Fabric에서 특정 사용 권한이 설정된 멤버 목록입니다. 해당 권한 집합이 있는 모든 멤버는 이 데이터 액세스 역할의 멤버로 추가됩니다.

microsoftEntraMembers

MicrosoftEntraMember[]

Microsoft Entra ID 멤버 목록입니다.

MicrosoftEntraMember

역할에 할당된 Microsoft Entra ID 멤버입니다.

Name 형식 Description
objectId

string (uuid)

개체 ID입니다.

objectType

ObjectType

Microsoft Entra ID 개체의 형식입니다. 시간이 지남에 따라 추가 objectType 형식을 추가할 수 있습니다.

tenantId

string (uuid)

테넌트 ID입니다.

ObjectType

Microsoft Entra ID 개체의 형식입니다. 시간이 지남에 따라 추가 objectType 형식을 추가할 수 있습니다.

Description
Group

특성 이름 그룹

User

특성 이름 사용자

ServicePrincipal

특성 이름 ServicePrincipal

ManagedIdentity

특성 이름 ManagedIdentity

PermissionScope

리소스에 대한 액세스의 범위와 수준을 결정하는 특성(속성) 집합을 정의합니다. attributeName 속성이 Path설정되면 attributeValueIncludedIn 속성은 액세스되는 리소스의 위치(예: "Tables/Table1")를 지정해야 합니다. attributeName 속성이 Action설정되면 attributeValueIncludedIn 속성은 부여되는 액세스 유형(예: Read)을 지정해야 합니다.

Name 형식 Description
attributeName

AttributeName

액세스 권한에 대해 평가되는 특성의 이름을 지정합니다. AttributeName은 Path 또는 Action수 있습니다. 시간이 지남에 따라 추가 attributeName 형식을 추가할 수 있습니다.

attributeValueIncludedIn

string[]

리소스에 대한 액세스 수준 및 범위를 정의하는 attributeName 값 목록을 지정합니다. attributeName Path경우 attributeValueIncludedIn 액세스되는 리소스의 위치(예: "Tables/Table1")를 지정해야 합니다. attributeName Action경우 attributeValueIncludedIn 부여되는 액세스 유형(예: Read)을 지정해야 합니다.

RowConstraint

RowConstraint는 사용자가 볼 수 있는 테이블의 행을 결정하는 제약 조건을 나타냅니다. RowConstraints로 정의된 역할은 T-SQL을 사용하여 테이블의 데이터를 필터링하는 조건자를 정의합니다. 조건자의 조건을 충족하지 않는 행은 필터링되어 원래 행의 하위 집합을 남깁니다. RowConstraints를 사용하여 T-SQL을 사용하여 RLS의 동적 및 다중 테이블 버전을 지정할 수도 있습니다.

Name 형식 Description
tablePath

string

행 제약 조건이 적용되는 테이블을 지정하는 상대 파일 경로입니다. 이 형식은 .의 /Tables/{optionalSchema}/{tableName}형식이어야 합니다. 여기서는 하나의 값만 지정할 수 있으며 tableName은 PermissionScope에 포함된 테이블이어야 합니다.

value

string

역할 멤버가 볼 수 있는 행을 평가하는 데 사용되는 T-SQL 식입니다. T-SQL 하위 집합만 조건자로 사용할 수 있습니다.