Ottenere l'accesso autorizzato per un principale

• Servizio:

  • Nucleo

• Versione API:

  • v1

Recupera l'accesso ai dati consentito per una determinata entità in base ai ruoli di sicurezza di OneLake configurati nell'elemento. Questa API consolida le autorizzazioni di un soggetto autorizzato tra i ruoli, fornendo una visualizzazione delle autorizzazioni di accesso effettive.

Ambiti delegati obbligatori

OneLake.ReadWrite.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Interfaccia

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

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Responses

Examples

Esempio di richiesta

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)
}

Risposta di esempio

• Codice di stato:
  • 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"
    }
  ]
}

Definizioni

Access

Enumerazione

Tipo di autorizzazione di accesso concessa. Attualmente, l'unico tipo di accesso supportato è Read. È possibile aggiungere altri tipi di accesso nel corso del tempo.

ColumnAccess

oggetto

Rappresenta una colonna che il soggetto principale è autorizzato ad accedere, compreso l'effetto e l'azione consentiti su quella colonna.

AzioneColonna

Enumerazione

Azione consentita su una colonna. Attualmente, l'unica azione supportata è Read. È possibile aggiungere altri tipi di azione nel tempo.

EffettoColonna

Enumerazione

Effetto applicato a una colonna. Attualmente, l'unico effetto supportato è Permit. È possibile aggiungere altri tipi di effetto nel tempo.

Effetto

Enumerazione

L'effetto che un principale ha sull'accesso alla risorsa dati. Attualmente, l'unico tipo di effetto supportato è Permit, che concede l'accesso alla risorsa. È possibile aggiungere altri tipi di effetto nel tempo.

RisorsaCorrelataAllErrore

oggetto

Oggetto dettagli della risorsa correlata all'errore.

Risposta di Errore

oggetto

Risposta di errore.

ErrorResponseDetails

oggetto

Dettagli della risposta di errore.

Voce di accesso principale (PrincipalAccessEntry)

oggetto

Rappresenta l'accesso effettivo di un'entità a un percorso di risorsa specifico, incluso il tipo di accesso, l'effetto e qualsiasi filtro a livello di riga o di colonna applicato.

PrincipalAccessResponse

oggetto

L'oggetto di risposta che contiene l'accesso effettivo per un utente principale attraverso tutte le risorse all'interno del percorso di input specificato.