Skaffa auktoriserad åtkomst för en huvudaktör

• Tjänst:

  • Kärna

• API-version:

  • v1

Hämtar den tillåtna dataåtkomsten för en given användare enligt OneLake-säkerhetsrollerna som har konfigurerats för objektet. Det här API:et konsoliderar en användares eller grupps behörigheter över olika roller, vilket ger en vy av "effektiv åtkomst" över deras behörigheter.

Obligatoriska delegerade omfång

OneLake.ReadWrite.All

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Gränssnitt

GET https://onelake.dfs.fabric.microsoft.com/v1.0/workspaces/{workspaceId}/artifacts/{artifactId}/securityPolicy/principalAccess

URI parametrar

Begärandehuvud

Begärans brödtext

Responses

Exempel

Exempelbegäran

HTTP

GET https://onelake.dfs.fabric.microsoft.com/v1.0/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/artifacts/25bac802-080d-4f73-8a42-1b406eb1fceb/securityPolicy/principalAccess

{
  "aadObjectId": "CA81C0F4-5C79-4907-BD0A-B4D576AEA59B",
  "inputPath": "Tables",
  "continuationToken": "(token, optional)",
  "maxResults": (optional)
}

Exempelsvar

• Statuskod:
  • 200

ETag: 33a64df551425fcc55e4d42a148795d9f25f89d4
{
  "identityETag": "3fc4dc476ded773e4cf43936190bf20fa9480a077b25edc0b4bbe247112542f6",
  "metadataETag": "\"eyJhciI6IlwiMHg4REU3NjQ2MzA2QTIxNjhcIiIsInNjIjoiXCIweDhERTcwQzdBNjlENzk1Q1wiIiwiaXIiOiJcIjB4OERFNjhEREMyNjhBM0U0XCIiLCJkciI6IlwiNWM0YmFhZWIwYTE2MzYxZjkzNThjMzNjMDllYmM2ODJhZjQ1NmIxMDZlNTRmN2E1MzRhNjk5NzA1MjgzMTU5Yy1mODUxMjc0MDBjYjY0YzFkYTA2NjFlZWIyNzg4ZTNhZDc1N2Y3MTZhZWIyYTk0OTA4NGUxOGI2MWUyYWNjNzAxXCIifQ==\"",
  "value": [
    {
      "path": "Tables/dbo/Customers",
      "access": [
        "Read"
      ],
      "rows": "SELECT * FROM [dbo].[Customers] WHERE [customerId] = '123' UNION SELECT * FROM [dbo].[Customers] WHERE [customerID] = 'ALFKI'",
      "effect": "Permit"
    },
    {
      "path": "Tables/dbo/Employees",
      "access": [
        "Read"
      ],
      "rows": "SELECT * FROM [dbo].[Employees] WHERE [address] = '123'",
      "effect": "Permit"
    },
    {
      "path": "Tables/dbo/EmployeeTerritories",
      "access": [
        "Read"
      ],
      "effect": "Permit"
    }
  ]
}

Definitions

Åtkomst

Uppräkning

Den typ av åtkomstbehörighet som beviljas. För närvarande är Readden enda åtkomsttyp som stöds . Ytterligare åtkomsttyper kan läggas till över tid.

Kolumnåtkomst

Objekt

Representerar en kolumn som huvudmannen har tillstånd att komma åt, inklusive den beviljade effekten och åtgärden för kolumnen.

KolumnÅtgärd

Uppräkning

Åtgärden som är tillåten på en kolumn. För närvarande är Readden enda åtgärden som stöds . Ytterligare åtgärdstyper kan läggas till över tid.

KolonnEffekt

Uppräkning

Effekten som tillämpas på en kolumn. För närvarande är Permitden enda effekt som stöds . Ytterligare effekttyper kan läggas till över tid.

Effekt

Uppräkning

Effekten som en huvudman har på åtkomst till dataresursen. För närvarande är den enda effekttypen som stöds Permit, vilket ger åtkomst till resursen. Ytterligare effekttyper kan läggas till över tid.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Felmeddelande

Objekt

Felmeddelande.

Felresponsdetaljer

Objekt

Detaljer om felsvaret.

Principal Åtkomstpost

Objekt

Representerar den effektiva åtkomsten som en principal har till en specifik resurssökväg, inklusive åtkomsttyp, resultat och eventuell filtrering på radnivå eller kolumnnivå som tillämpas.

PrincipalAccessResponse

Objekt

Svarsobjektet som innehåller den effektiva åtkomsten för en behörig användare för alla resurser inom den angivna indatasökvägen.