OneLake Shortcuts - Create Shortcut

Servizio:: Core

Versione API:: v1

Crea un nuovo collegamento o aggiorna un collegamento esistente.

Ambiti delegati obbligatori

OneLake.ReadWrite.All

Microsoft Entra identità supportate

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

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

Interfaccia

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts

Con parametri facoltativi:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts?shortcutConflictPolicy={shortcutConflictPolicy}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
itemId	path	True	string (uuid)	ID dell'elemento di dati.
workspaceId	path	True	string (uuid)	ID dell'area di lavoro.
shortcutConflictPolicy	query		ShortcutConflictPolicy	Se specificato, definisce l'azione da eseguire quando esiste già un collegamento con lo stesso nome e percorso. L'azione predefinita è 'Abort'. È possibile aggiungere altri tipi ShortcutConflictPolicy nel tempo.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome del collegamento.
path	True	string	Stringa che rappresenta il percorso completo in cui viene creato il collegamento, incluso "File" o "Tabelle".
target	True	CreatableShortcutTarget	Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 compatibile, Dataverse, Azure Archiviazione BLOB o OneDrive SharePoint.

Risposte

Nome	Tipo	Descrizione
200 OK	Shortcut	Aggiornamento corretto. Intestazioni Location: string
201 Created	Shortcut	Creazione completata. Intestazioni Location: string
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione `Retry-After` che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: ItemNotFound: il server non riesce a trovare l'elemento richiesto. UnknownError: si è verificato un errore.

Esempio

Create or update shortcut target to OneLake

Create shortcut AdlsGen2 target example

Create shortcut AmazonS3 target example

Create shortcut Azure Blob Storage target example

Create shortcut Google Cloud Storage target example

Create shortcut One Lake target example

Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example

Create shortcut S3 Compatible target example

Update shortcut target to OneLake

Create or update shortcut target to OneLake

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Risposta di esempio

Codice di stato:: 200

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut AdlsGen2 target example

Esempio di richiesta

HTTP

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

{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

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

{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "type": "AdlsGen2",
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Create shortcut AmazonS3 target example

Esempio di richiesta

HTTP

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

{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

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

{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "type": "AmazonS3",
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Create shortcut Azure Blob Storage target example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyAzureBlobStorage

{
  "path": "Files",
  "name": "MyAzureBlobStorage",
  "target": {
    "type": "AzureBlobStorage",
    "azureBlobStorage": {
      "location": "https://azureblobstoragetesting.blob.core.windows.net",
      "subpath": "/tables",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335"
    }
  }
}

Create shortcut Google Cloud Storage target example

Esempio di richiesta

HTTP

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

{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

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

{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "type": "GoogleCloudStorage",
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Create shortcut One Lake target example

Esempio di richiesta

HTTP

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

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts

{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335",
      "updateFabricItemSensitivity": false
    }
  }
}

Risposta di esempio

Codice di stato:: 201

Location: https://api.fabric.microsoft.com/v1/workspaces/bf94607f-3ba1-4a95-8259-27649ccd7755/items/884e71cd-f5b4-45f9-8e00-b71355f7ea5d/shortcuts/Files/MyOneDriveSharePoint

{
  "path": "Files",
  "name": "MyOneDriveSharePoint",
  "target": {
    "type": "OneDriveSharePoint",
    "oneDriveSharePoint": {
      "location": "https://microsoft.sharepoint.com",
      "subpath": "/Shared Documents/Test Folder",
      "connectionId": "97e33458-1353-4911-96b1-6f4f4bbfd335",
      "updateFabricItemSensitivity": false
    }
  }
}

Create shortcut S3 Compatible target example

Esempio di richiesta

HTTP

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

{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Risposta di esempio

Codice di stato:: 201

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

{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "type": "S3Compatible",
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Update shortcut target to OneLake

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Risposta di esempio

Codice di stato:: 200

Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Definizioni

Nome	Descrizione
AdlsGen2	Oggetto contenente le proprietà dell'origine dati ADLS Gen2 di destinazione.
AmazonS3	Oggetto contenente le proprietà dell'origine dati Amazon S3 di destinazione.
AzureBlobStorage	Oggetto contenente le proprietà della destinazione Azure Blob Storage'origine dati.
CreatableShortcutTarget	Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate, come descritto nella tabella seguente.
CreateShortcutRequest	Richiesta di creazione di collegamenti con un oggetto che rappresenta un riferimento a un'altra posizione di archiviazione.
CsvToDeltaTransform	Trasformazione da CSV a Delta.
CsvToDeltaTransformProperties	Proprietà per la trasformazione DA CSV a Delta.
Dataverse	Oggetto contenente le proprietà dell'origine dati Dataverse di destinazione.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
ExternalDataShareTarget	Oggetto contenente le proprietà della condivisione dati esterna di destinazione.
GoogleCloudStorage	Oggetto contenente le proprietà dell'origine dati di Google Cloud Storage di destinazione.
OneDriveSharePoint	Oggetto contenente le proprietà del OneDrive for Business di destinazione o SharePoint'origine dati online.
OneLake	Oggetto contenente le proprietà dell'origine dati OneLake di destinazione.
S3Compatible	Oggetto contenente le proprietà dell'origine dati compatibile con S3 di destinazione.
Shortcut	Oggetto che rappresenta un riferimento che punta ad altre posizioni di archiviazione che possono essere interne o esterne a OneLake. Il collegamento viene definito in base al nome, al percorso in cui viene creato il collegamento e alla destinazione che specifica il percorso di archiviazione di destinazione.
ShortcutConflictPolicy	Se specificato, definisce l'azione da eseguire quando esiste già un collegamento con lo stesso nome e percorso. L'azione predefinita è 'Abort'. È possibile aggiungere altri tipi ShortcutConflictPolicy nel tempo.
Target	Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate, come descritto nella tabella seguente.
Type	L'oggetto type contiene proprietà come il tipo di account collegamento di destinazione. È possibile aggiungere altri tipi nel tempo.

AdlsGen2

Oggetto

Oggetto contenente le proprietà dell'origine dati ADLS Gen2 di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID connessione, creare prima di tutto una connessione cloud da usare tramite il collegamento durante la connessione al percorso dei dati ADLS. Aprire la visualizzazione Impostazioni della connessione cloud e copiare l'ID connessione; si tratta di un GUID.
location	string (uri)	Specifica il percorso del contenitore ADLS di destinazione. L'URI deve essere nel formato https://[account-name].dfs.core.windows.net dove [account-name] è il nome dell'account ADLS di destinazione.
subpath	string	Specifica il contenitore e la sottocartella all'interno dell'account ADLS in cui si trova la cartella di destinazione. Deve essere del formato [contenitore]/[sottocartella] dove [contenitore] è il nome del contenitore che contiene i file e le cartelle; [sottocartella] è il nome della sottocartella all'interno del contenitore (facoltativo). Ad esempio: /mycontainer/mysubfolder

AmazonS3

Oggetto

Oggetto contenente le proprietà dell'origine dati Amazon S3 di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID connessione, creare prima di tutto una connessione cloud da usare tramite il collegamento quando ci si connette alla posizione dei dati amazon S3. Aprire la visualizzazione Impostazioni della connessione cloud e copiare l'ID connessione; si tratta di un GUID.
location	string (uri)	URL HTTP che punta al bucket di destinazione in S3. L'URL deve essere nel formato https://[bucket-name].s3. [region-code].amazonaws.com, dove "bucket-name" è il nome del bucket S3 a cui si vuole puntare e "region-code" è il codice per l'area in cui si trova il bucket. Ad esempio: https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath	string	Specifica una cartella o una sottocartella di destinazione all'interno del bucket S3.

AzureBlobStorage

Oggetto

Oggetto contenente le proprietà della destinazione Azure Blob Storage'origine dati.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID connessione, prima di tutto creare una connessione cloud da usare con il collegamento durante la connessione al percorso dei dati Azure Blob Storage. Aprire la visualizzazione delle impostazioni della connessione cloud e copiare il GUID corrispondente all'ID connessione.
location	string (uri)	Specifica il percorso del contenitore Azure Blob Storage di destinazione. L'URI deve essere nel formato `https://[account-name].blob.core.windows.net` dove `[account-name]` è il nome dell'account Azure Blob Storage di destinazione.
subpath	string	Specifica il contenitore e la sottocartella all'interno dell'account Azure Blob Storage in cui si trova la cartella di destinazione. Deve essere del formato [contenitore]/[sottocartella]. [Contenitore] è il nome del contenitore che contiene i file e le cartelle. [Sottocartella] è il nome della sottocartella all'interno del contenitore ed è facoltativo. Ad esempio: /mycontainer/mysubfolder

CreatableShortcutTarget

Oggetto

Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate, come descritto nella tabella seguente.

Nome	Tipo	Descrizione
adlsGen2	AdlsGen2	Oggetto contenente le proprietà dell'origine dati ADLS Gen2 di destinazione.
amazonS3	AmazonS3	Oggetto contenente le proprietà dell'origine dati Amazon S3 di destinazione.
azureBlobStorage	AzureBlobStorage	Oggetto contenente le proprietà della destinazione Azure Blob Storage'origine dati.
dataverse	Dataverse	Oggetto contenente le proprietà dell'origine dati Dataverse di destinazione.
googleCloudStorage	GoogleCloudStorage	Oggetto contenente le proprietà dell'origine dati di Google Cloud Storage di destinazione.
oneDriveSharePoint	OneDriveSharePoint	Oggetto contenente le proprietà del OneDrive for Business di destinazione e SharePoint'origine dati online.
oneLake	OneLake	Oggetto contenente le proprietà dell'origine dati OneLake di destinazione.
s3Compatible	S3Compatible	Oggetto contenente le proprietà dell'origine dati compatibile con S3 di destinazione.

CreateShortcutRequest

Oggetto

Richiesta di creazione di collegamenti con un oggetto che rappresenta un riferimento a un'altra posizione di archiviazione.

Nome	Tipo	Descrizione
name	string	Nome del collegamento.
path	string	Stringa che rappresenta il percorso completo in cui viene creato il collegamento, incluso "File" o "Tabelle".
target	CreatableShortcutTarget	Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3 compatibile, Dataverse, Azure Archiviazione BLOB o OneDrive SharePoint.

CsvToDeltaTransform

Oggetto

Trasformazione da CSV a Delta.

Nome	Tipo	Valore predefinito	Descrizione
includeSubfolders	boolean	False	Determina se le sottocartelle all'interno del percorso di destinazione vengono incluse nell'operazione di trasformazione. True - Includi sottocartelle, False - Non includere sottocartelle. Il valore predefinito è False.
properties	CsvToDeltaTransformProperties		Csv per le proprietà di trasformazione Delta.
type	string: csvToDelta		Tipo di trasformazione. È possibile aggiungere altri tipi di trasformazione nel corso del tempo.

CsvToDeltaTransformProperties

Oggetto

Proprietà per la trasformazione DA CSV a Delta.

Nome	Tipo	Valore predefinito	Descrizione
delimiter	string	,	Specifica il carattere usato per separare i valori all'interno di una riga nel file CSV e deve specificare esattamente uno dei valori supportati: `,`, , `\t\|`, , `&`, `;`. Il valore predefinito è `,`.
skipFilesWithErrors	boolean	True	Se ignorare i file con errori. True- Ignorare i file con errori, False- Non ignorare i file con errori. Il valore predefinito è True.
useFirstRowAsHeader	boolean	True	Indica se la prima riga del file CSV deve essere usata come intestazione. True: usare la prima riga come intestazione. False: non usare la prima riga come intestazione. Il valore predefinito è True.

Dataverse

Oggetto

Oggetto contenente le proprietà dell'origine dati Dataverse di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID connessione, creare prima di tutto una connessione cloud da usare tramite il collegamento durante la connessione al percorso dei dati di Dataverse. Aprire la visualizzazione Impostazioni della connessione cloud e copiare l'ID connessione; si tratta di un GUID.
deltaLakeFolder	string	Specifica il percorso della cartella DeltaLake in cui sono archiviati i dati di destinazione.
environmentDomain	string (uri)	URI che indica il nome di dominio dell'ambiente di destinazione Dataverse. L'URI deve essere formattato come "https://[orgname].crm[xx].dynamics.com", dove `[orgname]` rappresenta il nome dell'organizzazione Dataverse.
tableName	string	Specifica il nome della tabella di destinazione in Dataverse

ErrorRelatedResource

Oggetto

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

Oggetto

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 (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

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.

ExternalDataShareTarget

Oggetto

Oggetto contenente le proprietà della condivisione dati esterna di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione.

GoogleCloudStorage

Oggetto

Oggetto contenente le proprietà dell'origine dati di Google Cloud Storage di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione.
location	string (uri)	URL HTTP che punta al bucket di destinazione in GCS. L'URL deve essere nel formato https://[bucket-name].storage.googleapis.com, dove [bucket-name] è il nome del bucket a cui si vuole puntare. Ad esempio: https://my-gcs-bucket.storage.googleapis.com
subpath	string	Specifica una cartella o una sottocartella di destinazione all'interno del bucket GCS. Ad esempio: /folder

OneDriveSharePoint

Oggetto

Oggetto contenente le proprietà del OneDrive for Business di destinazione o SharePoint'origine dati online.

Nome	Tipo	Valore predefinito	Descrizione
connectionId	string (uuid)		Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID di connessione, prima di tutto creare una connessione cloud da usare con il collegamento quando ci si connette al percorso dei dati OneDrive SharePoint. Aprire la visualizzazione delle impostazioni della connessione cloud e copiare il GUID corrispondente all'ID connessione.
location	string (uri)		Specifica il percorso del contenitore OneDrive SharePoint di destinazione. L'URI deve essere nel formato `https://microsoft.sharepoint.com`, ovvero il percorso dell'account OneDrive SharePoint di destinazione.
subpath	string		Specifica il contenitore e la sottocartella all'interno dell'account OneDrive SharePoint in cui si trova la cartella di destinazione. Deve essere del formato [contenitore]/[sottocartella]. [Contenitore] è il nome del contenitore che contiene i file e le cartelle. [Sottocartella] è il nome della sottocartella all'interno del contenitore ed è facoltativo. Ad esempio: /mycontainer/mysubfolder
updateFabricItemSensitivity	boolean	False	Specifica se l'utente desidera che la riservatezza degli elementi dell'infrastruttura sia coerente con le etichette a livello di sito per i collegamenti a SharePoint. Se l'utente lo imposta su true e se un sito di SharePoint ha un'etichetta più restrittiva dell'elemento Fabric, solo l'etichetta dell'elemento di infrastruttura verrà aggiornata in modo che corrisponda al sito di SharePoint.

OneLake

Oggetto

Oggetto contenente le proprietà dell'origine dati OneLake di destinazione.

Nome	Tipo	Descrizione
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione. Per trovare questo ID connessione, creare prima di tutto una connessione cloud da usare tramite il collegamento quando ci si connette alla posizione dei dati amazon S3. Aprire la visualizzazione Impostazioni della connessione cloud e copiare l'ID connessione; si tratta di un GUID.
itemId	string (uuid)	ID della destinazione in OneLake. La destinazione può essere un elemento di Lakehouse, KQLDatabase o Warehouse.
path	string	Stringa che rappresenta il percorso completo della cartella di destinazione all'interno dell'elemento. Questo percorso deve essere relativo alla radice della struttura di directory OneLake. Ad esempio: "Tables/myTablesFolder/someTableSubFolder".
workspaceId	string (uuid)	ID dell'area di lavoro di destinazione.

S3Compatible

Oggetto

Oggetto contenente le proprietà dell'origine dati compatibile con S3 di destinazione.

Nome	Tipo	Descrizione
bucket	string	Specifica il bucket di destinazione all'interno della posizione compatibile con S3.
connectionId	string (uuid)	Stringa che rappresenta la connessione associata al collegamento. ConnectionId è un identificatore univoco usato per stabilire una connessione tra il collegamento e l'origine dati di destinazione.
location	string (uri)	URL HTTP dell'endpoint compatibile con S3. Questo endpoint deve essere in grado di ricevere chiamate API S3 listBuckets. L'URL deve essere nel formato non specifico del bucket; non deve essere specificato alcun bucket qui. Ad esempio: `https://s3endpoint.contoso.com`
subpath	string	Specifica una cartella o una sottocartella di destinazione all'interno del bucket compatibile con S3. Ad esempio: /folder

Shortcut

Oggetto

Oggetto che rappresenta un riferimento che punta ad altre posizioni di archiviazione che possono essere interne o esterne a OneLake. Il collegamento viene definito in base al nome, al percorso in cui viene creato il collegamento e alla destinazione che specifica il percorso di archiviazione di destinazione.

Nome	Tipo	Descrizione
name	string	Nome del collegamento.
path	string	Stringa che rappresenta il percorso completo in cui viene creato il collegamento, incluso "File" o "Tabelle".
target	Target	Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate.
transform	Transform: CsvToDeltaTransform	Oggetto che contiene il nome della trasformazione e le relative proprietà corrispondenti da applicare ai dati di destinazione e deve specificare esattamente una delle trasformazioni supportate.

ShortcutConflictPolicy

Enumerazione

Se specificato, definisce l'azione da eseguire quando esiste già un collegamento con lo stesso nome e percorso. L'azione predefinita è 'Abort'. È possibile aggiungere altri tipi ShortcutConflictPolicy nel tempo.

Valore	Descrizione
Abort	Quando esiste già un collegamento con lo stesso nome e percorso, la creazione del collegamento verrà annullata.
GenerateUniqueName	Quando esiste già un collegamento con lo stesso nome e percorso, la creazione del collegamento continuerà con un nuovo nome di collegamento univoco.
CreateOrOverwrite	Quando esiste già un collegamento con lo stesso nome e percorso, la creazione del collegamento sovrascriverà il collegamento esistente. Creare un collegamento se non esiste.
OverwriteOnly	Quando esiste già un collegamento con lo stesso nome e percorso, la creazione del collegamento sovrascriverà il collegamento esistente.

Target

Oggetto

Oggetto che contiene l'origine dati di destinazione e deve specificare esattamente una delle destinazioni supportate, come descritto nella tabella seguente.

Nome	Tipo	Descrizione
adlsGen2	AdlsGen2	Oggetto contenente le proprietà dell'origine dati ADLS Gen2 di destinazione.
amazonS3	AmazonS3	Oggetto contenente le proprietà dell'origine dati Amazon S3 di destinazione.
azureBlobStorage	AzureBlobStorage	Oggetto contenente le proprietà della destinazione Azure Blob Storage'origine dati.
dataverse	Dataverse	Oggetto contenente le proprietà dell'origine dati Dataverse di destinazione.
externalDataShare	ExternalDataShareTarget	Oggetto contenente le proprietà della condivisione dati esterna di destinazione.
googleCloudStorage	GoogleCloudStorage	Oggetto contenente le proprietà dell'origine dati di Google Cloud Storage di destinazione.
oneDriveSharePoint	OneDriveSharePoint	Oggetto contenente le proprietà del OneDrive for Business di destinazione e SharePoint'origine dati online.
oneLake	OneLake	Oggetto contenente le proprietà dell'origine dati OneLake di destinazione.
s3Compatible	S3Compatible	Oggetto contenente le proprietà dell'origine dati compatibile con S3 di destinazione.
type	Type	L'oggetto type contiene proprietà come il tipo di account collegamento di destinazione. È possibile aggiungere altri tipi nel tempo.

Type

Enumerazione

L'oggetto type contiene proprietà come il tipo di account collegamento di destinazione. È possibile aggiungere altri tipi nel tempo.

Valore	Descrizione
OneLake	OneLake
AmazonS3	AmazonS3
AdlsGen2	AdlsGen2
GoogleCloudStorage	GoogleCloudStorage
S3Compatible	S3Compatible
Dataverse	Dataverse
ExternalDataShare	ExternalDataShare
AzureBlobStorage	AzureBlobStorage
OneDriveSharePoint	OneDriveSharePoint

Condividi tramite

OneLake Shortcuts - Create Shortcut

Ambiti delegati obbligatori

Microsoft Entra identità supportate

Interfaccia

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Create or update shortcut target to OneLake

Esempio di richiesta

Risposta di esempio

Create shortcut AdlsGen2 target example

Esempio di richiesta

Risposta di esempio

Create shortcut AmazonS3 target example

Esempio di richiesta

Risposta di esempio

Create shortcut Azure Blob Storage target example

Esempio di richiesta

Risposta di esempio

Create shortcut Google Cloud Storage target example

Esempio di richiesta

Risposta di esempio

Create shortcut One Lake target example

Esempio di richiesta

Risposta di esempio

Create shortcut OneDriveSharePoint or OneDrive for Business or SharePoint Online target example

Esempio di richiesta

Risposta di esempio

Create shortcut S3 Compatible target example

Esempio di richiesta

Risposta di esempio

Update shortcut target to OneLake

Esempio di richiesta

Risposta di esempio

Definizioni

AdlsGen2

AmazonS3

AzureBlobStorage

CreatableShortcutTarget

CreateShortcutRequest

CsvToDeltaTransform

CsvToDeltaTransformProperties

Dataverse

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ExternalDataShareTarget

GoogleCloudStorage

OneDriveSharePoint

OneLake

S3Compatible

Shortcut

ShortcutConflictPolicy

Target

Type