Condividi tramite

Items - List Item Connections

Servizio:
Core
Versione API:
v1

Restituisce l'elenco di connessioni a cui è connesso l'elemento specificato.
Questa API supporta paginazione.

Autorizzazioni

Il chiamante deve disporre delle autorizzazioni di lettura e scrittura per l'elemento.

Ambiti delegati obbligatori

Per le API degli elementi, usare questi tipi di ambito:

  • Ambito generico: Item.ReadWrite.All
  • Ambito specifico: itemType. ReadWrite.All (ad esempio: Notebook.ReadWrite.All)

Per altre informazioni sugli ambiti, vedere l'articolo Ambiti.

Limitazioni

Questa API viene bloccata per un elemento con un'etichetta di riservatezza protetta, a meno che il chiamante non disponga dei diritti di utilizzo per eliminare l'etichetta di riservatezza.

Identità supportate da Microsoft Entra

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

Identità Assistenza
Utente Sì
Principale del servizio e Identità gestite Sì

Interfaccia

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/connections
Con parametri facoltativi: 
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/connections?continuationToken={continuationToken}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
itemId
 path True

string (uuid)

ID elemento.
workspaceId
 path True

string (uuid)

L’ID dell’area di lavoro.
continuationToken
 query

string

Token per il recupero della pagina successiva dei risultati.

Risposte

Nome Tipo Descrizione
200 OK

ItemConnections

Richiesta completata correttamente.
Other Status Codes

ErrorResponse

Codici di errore comuni:

  • ItemNotFound: indica che il server non riesce a trovare l'elemento richiesto.

Esempio

List item connections - Semantic Model Direct Lake example
List item connections example
List item connections with continuation example

List item connections - Semantic Model Direct Lake example

Esempio di richiesta

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "connectivityType": "Automatic",
      "connectionDetails": {
        "type": "SQL",
        "path": "xqoruksalslrtkdxe2bvrlwgsi-5j2iqepw1i3ucdp6bepe62hcii.datawarehouse.fabric.microsoft.com;532183f5-ac60-4d12-0fc5-4094532f14b5"
      }
    }
  ]
}

List item connections example

Esempio di richiesta

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "connectivityType": "ShareableCloud",
      "displayName": "ContosoConnection1",
      "id": "6952a7b2-aea3-414f-9d85-6c0fe5d34539",
      "connectionDetails": {
        "type": "Web",
        "path": "https://www.contoso.com"
      }
    },
    {
      "connectivityType": "OnPremisesDataGateway",
      "displayName": "ContosoConnection2",
      "id": "0b9af1bd-e974-4893-8947-d89d5a560385",
      "gatewayId": "58376c10-5f61-4024-887e-748df4beae45",
      "connectionDetails": {
        "type": "SQL",
        "path": "contoso.database.windows.net;sales"
      }
    }
  ]
}

List item connections with continuation example

Esempio di richiesta

GET https://api.fabric.microsoft.com/v1/workspaces/4b218778-e7a5-4d73-8187-f10824047715/items/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/connections

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "connectivityType": "Automatic",
      "connectionDetails": {
        "type": "SQL",
        "path": "xqoruksalslrtkdxe2bvrlwgsi-5j2iqepw1i3ucdp6bepe62hcii.datawarehouse.fabric.microsoft.com;532183f5-ac60-4d12-0fc5-4094532f14b5"
      }
    }
  ]
}

Definizioni

Nome Descrizione
ConnectivityType

Tipo di connettività della connessione. È possibile aggiungere altri tipi di connettività nel tempo.
ErrorRelatedResource

Oggetto dettagli risorsa correlato all'errore.
ErrorResponse

Risposta di errore.
ErrorResponseDetails

Dettagli della risposta di errore.
ItemConnection
ItemConnections
ListConnectionDetails

Output dei dettagli della connessione per le operazioni di elenco.

ConnectivityType

Enumerazione

Tipo di connettività della connessione. È possibile aggiungere altri tipi di connettività nel tempo.

Valore Descrizione
Automatic

La connessione si connette tramite il cloud usando una connessione dati implicita. Questa opzione è disponibile solo per scenari specifici, ad esempio modelli semantici che usano Single Sign-On (SSO)."
None

La connessione non è associata
OnPremisesGateway

La connessione si connette tramite un gateway dati locale.
OnPremisesGatewayPersonal

La connessione si connette tramite un gateway dati locale personale.
PersonalCloud

La connessione si connette tramite il cloud e non può essere condivisa con altri utenti.
ShareableCloud

La connessione si connette tramite il cloud e può essere condivisa con altri utenti.
VirtualNetworkGateway

La connessione si connette tramite un gateway dati di rete virtuale.

ErrorRelatedResource

Object

Oggetto dettagli risorsa correlato all'errore.

Nome Tipo Descrizione
resourceId

string

ID risorsa coinvolto nell'errore.
resourceType

string

Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Object

Risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
moreDetails

ErrorResponseDetails[]

Elenco di dettagli aggiuntivi sull'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.
requestId

string

ID della richiesta associata all'errore.

ErrorResponseDetails

Object

Dettagli della risposta di errore.

Nome Tipo Descrizione
errorCode

string

Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message

string

Rappresentazione leggibile dell'errore.
relatedResource

ErrorRelatedResource

Dettagli della risorsa correlati all'errore.

ItemConnection

Object
Nome Tipo Descrizione
connectionDetails

ListConnectionDetails

Dettagli della connessione.
connectivityType

ConnectivityType

Tipo di connettività della connessione.
displayName

string

Nome visualizzato della connessione. La lunghezza massima è di 200 caratteri.
gatewayId

string (uuid)

ID oggetto gateway della connessione.
id

string (uuid)

ID oggetto della connessione.

ItemConnections

Object
Nome Tipo Descrizione
continuationToken

string

Token per il batch del set di risultati successivo. Se non sono presenti altri record, viene rimosso dalla risposta.
continuationUri

string

URI del batch del set di risultati successivo. Se non sono presenti altri record, viene rimosso dalla risposta.
value

ItemConnection[]

Elenco di connessioni di elementi

ListConnectionDetails

Object

Output dei dettagli della connessione per le operazioni di elenco.

Nome Tipo Descrizione
path

string

Percorso della connessione.
type

string

Tipo di connessione.