Dela via

OneLake Shortcuts - Create Shortcut

Tjänst:
Core
API-version:
v1

Skapar en ny genväg eller uppdaterar en befintlig genväg.

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.

Identitet Stöd
Användare Ja
Tjänsthuvudnamn och hanterade identiteter Ja

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
itemId
 path True

string (uuid)

ID:t för dataobjektet.
workspaceId
 path True

string (uuid)

Arbetsområdets ID.
shortcutConflictPolicy
 query

ShortcutConflictPolicy

När den tillhandahålls definierar den den åtgärd som ska vidtas när det redan finns en genväg med samma namn och sökväg. Standardåtgärden är "Abort". Ytterligare ShortcutConflictPolicy-typer kan läggas till över tid.

Begärandetext

Name Obligatorisk Typ Description
name True

string

Namnet på genvägen.
path True

string

En sträng som representerar den fullständiga sökvägen där genvägen skapas, inklusive antingen "Files" eller "Tables".
target True

CreatableShortcutTarget

Ett objekt som innehåller måldatakällan och som måste ange exakt ett av de mål som stöds: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3-kompatibel, Dataverse eller Azure Blob Storage.

Svar

Name Typ Description
200 OK

Shortcut

Har uppdaterats.

Sidhuvuden

Location: string
201 Created

Shortcut

Har skapats.

Sidhuvuden

Location: string
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • ItemNotFound – servern kan inte hitta det begärda objektet.

  • UnknownError – Ett fel uppstod.

Exempel

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 S3 Compatible target example
Update shortcut target to OneLake

Create or update shortcut target to OneLake

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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 S3 Compatible target example

Exempelbegäran

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

Exempelsvar

Statuskod:
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

Exempelbegäran

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

Exempelsvar

Statuskod:
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"
    }
  }
}

Definitioner

Name Description
AdlsGen2

Ett objekt som innehåller egenskaperna för mål-ADLS Gen2-datakällan.
AmazonS3

Ett objekt som innehåller egenskaperna för Amazon S3-måldatakällan.
AzureBlobStorage

Ett objekt som innehåller egenskaperna för Azure Blob Storage-måldatakällan.
CreatableShortcutTarget

Ett objekt som innehåller måldatakällan och måste ange exakt ett av de mål som stöds enligt beskrivningen i tabellen nedan.
CreateShortcutRequest

En begäran om att skapa genvägar med ett objekt som representerar en referens till en annan lagringsplats.
CsvToDeltaTransform

CSV till Delta-transformering.
CsvToDeltaTransformProperties

Egenskaper för CSV till Delta-transformering.
Dataverse

Ett objekt som innehåller egenskaperna för Dataverse-måldatakällan.
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
ExternalDataShareTarget

Ett objekt som innehåller egenskaperna för den externa måldataresursen.
GoogleCloudStorage

Ett objekt som innehåller egenskaperna för Google Cloud Storage-måldatakällan.
OneLake

Ett objekt som innehåller egenskaperna för onelake-måldatakällan.
S3Compatible

Ett objekt som innehåller egenskaperna för den mål-S3-kompatibla datakällan.
Shortcut

Ett objekt som representerar en referens som pekar på andra lagringsplatser som kan vara interna eller externa till OneLake. Genvägen definieras med namn, sökväg där genvägen skapas och målet anger mållagringsplatsen.
ShortcutConflictPolicy

När den tillhandahålls definierar den den åtgärd som ska vidtas när det redan finns en genväg med samma namn och sökväg. Standardåtgärden är "Abort". Ytterligare ShortcutConflictPolicy-typer kan läggas till över tid.
Target

Ett objekt som innehåller måldatakällan och måste ange exakt ett av de mål som stöds enligt beskrivningen i tabellen nedan.
Type

Typobjektet innehåller egenskaper som typ av målgenvägskonto. Ytterligare typer kan läggas till över tid.

AdlsGen2

Objekt

Ett objekt som innehåller egenskaperna för mål-ADLS Gen2-datakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan. Om du vill hitta det här anslutnings-ID:t skapar du först en molnanslutning som ska användas av genvägen när du ansluter till ADLS-dataplatsen. Öppna vyn Inställningar för molnanslutningen och kopiera anslutnings-ID:t. detta är ett GUID.
location

string (uri)

Anger platsen för ADLS-målcontainern. URI:n måste vara i formatet https://[account-name].dfs.core.windows.net där [account-name] är namnet på mål-ADLS-kontot.
subpath

string

Anger containern och undermappen i ADLS-kontot där målmappen finns. Måste vara av formatet [container]/[subfolder] där [container] är namnet på containern som innehåller filerna och mapparna. [undermapp] är namnet på undermappen i containern (valfritt). Exempel: /mycontainer/mysubfolder

AmazonS3

Objekt

Ett objekt som innehåller egenskaperna för Amazon S3-måldatakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan. Om du vill hitta det här anslutnings-ID:t skapar du först en molnanslutning som ska användas av genvägen när du ansluter till Amazon S3-dataplatsen. Öppna vyn Inställningar för molnanslutningen och kopiera anslutnings-ID:t. detta är ett GUID.
location

string (uri)

HTTP-URL som pekar på mål bucketen i S3. URL:en ska vara i formatet https://[bucket-name].s3. [regionkod].amazonaws.com, där "bucket-name" är namnet på S3-bucketen som du vill peka på, och "regionkod" är koden för den region där bucketen finns. Till exempel: https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath

string

Anger en målmapp eller undermapp i S3-bucketen.

AzureBlobStorage

Objekt

Ett objekt som innehåller egenskaperna för Azure Blob Storage-måldatakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan. Om du vill hitta det här anslutnings-ID:t skapar du först en molnanslutning som ska användas av genvägen när du ansluter till Azure Blob Storage-dataplatsen. Öppna molnanslutningens inställningsvy och kopiera det GUID som är anslutnings-ID:t.
location

string (uri)

Anger platsen för Azure Blob Storage-målcontainern. URI:n måste vara i det format https://[account-name].blob.core.windows.net där [account-name] är namnet på målets Azure Blob Storage-konto.
subpath

string

Anger containern och undermappen i Azure Blob Storage-kontot där målmappen finns. Måste ha formatet [container]/[undermapp]. [Container] är namnet på containern som innehåller filerna och mapparna. [Undermapp] är namnet på undermappen i containern och är valfri. Exempel: /mycontainer/mysubfolder

CreatableShortcutTarget

Objekt

Ett objekt som innehåller måldatakällan och måste ange exakt ett av de mål som stöds enligt beskrivningen i tabellen nedan.

Name Typ Description
adlsGen2

AdlsGen2

Ett objekt som innehåller egenskaperna för mål-ADLS Gen2-datakällan.
amazonS3

AmazonS3

Ett objekt som innehåller egenskaperna för Amazon S3-måldatakällan.
azureBlobStorage

AzureBlobStorage

Ett objekt som innehåller egenskaperna för Azure Blob Storage-måldatakällan.
dataverse

Dataverse

Ett objekt som innehåller egenskaperna för Dataverse-måldatakällan.
googleCloudStorage

GoogleCloudStorage

Ett objekt som innehåller egenskaperna för Google Cloud Storage-måldatakällan.
oneLake

OneLake

Ett objekt som innehåller egenskaperna för onelake-måldatakällan.
s3Compatible

S3Compatible

Ett objekt som innehåller egenskaperna för den mål-S3-kompatibla datakällan.

CreateShortcutRequest

Objekt

En begäran om att skapa genvägar med ett objekt som representerar en referens till en annan lagringsplats.

Name Typ Description
name

string

Namnet på genvägen.
path

string

En sträng som representerar den fullständiga sökvägen där genvägen skapas, inklusive antingen "Files" eller "Tables".
target

CreatableShortcutTarget

Ett objekt som innehåller måldatakällan och som måste ange exakt ett av de mål som stöds: OneLake, Amazon S3, ADLS Gen2, Google Cloud Storage, S3-kompatibel, Dataverse eller Azure Blob Storage.

CsvToDeltaTransform

Objekt

CSV till Delta-transformering.

Name Typ Description
properties

CsvToDeltaTransformProperties

EGENSKAPER för CSV till Delta-transformering.
type string:

csvToDelta

Typ av transformering. Ytterligare transformeringstyper kan läggas till över tid.

CsvToDeltaTransformProperties

Objekt

Egenskaper för CSV till Delta-transformering.

Name Typ Standardvärde Description
delimiter

string

,

Anger det tecken som används för att avgränsa värden i en rad i CSV-filen och måste ange exakt ett av de värden som stöds: ,, , \t, |, &, ;. Standardvärdet är ,.
skipFilesWithErrors

boolean

True

Om du vill hoppa över filer med fel. Sant – Hoppa över filer med fel, False – Hoppa inte över filer med fel. Standardvärdet är Sant.
useFirstRowAsHeader

boolean

True

Om den första raden i CSV-filen ska användas som rubrik. True – Använd första raden som rubrik. False – Använd inte första raden som rubrik. Standardvärdet är Sant.

Dataverse

Objekt

Ett objekt som innehåller egenskaperna för Dataverse-måldatakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan. Om du vill hitta det här anslutnings-ID:t skapar du först en molnanslutning som ska användas av genvägen när du ansluter till Dataverse-dataplatsen. Öppna vyn Inställningar för molnanslutningen och kopiera anslutnings-ID:t. detta är ett GUID.
deltaLakeFolder

string

Anger sökvägen till DeltaLake-mappen där måldata lagras.
environmentDomain

string (uri)

URI som anger Dataverse-målmiljöns domännamn. URI:n ska formateras som "https://[orgname].crm[xx].dynamics.com", där [orgname] representerar namnet på din Dataverse-organisation.
tableName

string

Anger namnet på måltabellen i Dataverse

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

ExternalDataShareTarget

Objekt

Ett objekt som innehåller egenskaperna för den externa måldataresursen.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan.

GoogleCloudStorage

Objekt

Ett objekt som innehåller egenskaperna för Google Cloud Storage-måldatakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan.
location

string (uri)

HTTP-URL som pekar på mål bucketen i GCS. URL:en ska vara i formatet https://[bucket-name].storage.googleapis.com, där [bucket-name] är namnet på den bucket som du vill peka på. Till exempel: https://my-gcs-bucket.storage.googleapis.com
subpath

string

Anger en målmapp eller undermapp i GCS-bucketen. Till exempel: /folder

OneLake

Objekt

Ett objekt som innehåller egenskaperna för onelake-måldatakällan.

Name Typ Description
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan. Om du vill hitta det här anslutnings-ID:t skapar du först en molnanslutning som ska användas av genvägen när du ansluter till Amazon S3-dataplatsen. Öppna vyn Inställningar för molnanslutningen och kopiera anslutnings-ID:t. detta är ett GUID.
itemId

string (uuid)

ID:t för målet i OneLake. Målet kan vara ett objekt i Lakehouse, KQLDatabase eller Warehouse.
path

string

En sträng som representerar den fullständiga sökvägen till målmappen i objektet. Den här sökvägen bör vara relativ till roten i OneLake-katalogstrukturen. Exempel: "Tables/myTablesFolder/someTableSubFolder".
workspaceId

string (uuid)

ID för målarbetsytan.

S3Compatible

Objekt

Ett objekt som innehåller egenskaperna för den mål-S3-kompatibla datakällan.

Name Typ Description
bucket

string

Anger mål bucketen på den S3-kompatibla platsen.
connectionId

string (uuid)

En sträng som representerar anslutningen som är bunden med genvägen. ConnectionId är en unik identifierare som används för att upprätta en anslutning mellan genvägen och måldatakällan.
location

string (uri)

HTTP-URL för den S3-kompatibla slutpunkten. Den här slutpunkten måste kunna ta emot ListBuckets S3 API-anrop. URL:en måste vara i ett icke-bucketspecifikt format. ingen bucket ska anges här. Till exempel: https://s3endpoint.contoso.com
subpath

string

Anger en målmapp eller undermapp i den S3-kompatibla bucketen. Till exempel: /folder

Shortcut

Objekt

Ett objekt som representerar en referens som pekar på andra lagringsplatser som kan vara interna eller externa till OneLake. Genvägen definieras med namn, sökväg där genvägen skapas och målet anger mållagringsplatsen.

Name Typ Description
name

string

Namnet på genvägen.
path

string

En sträng som representerar den fullständiga sökvägen där genvägen skapas, inklusive antingen "Files" eller "Tables".
target

Target

Ett objekt som innehåller måldatakällan och måste ange exakt ett av de mål som stöds.
transform Transform:

CsvToDeltaTransform

Ett objekt som innehåller transformeringsnamnet och dess motsvarande egenskaper som ska tillämpas på måldata och måste ange exakt en av de omvandlingar som stöds.

ShortcutConflictPolicy

Uppräkning

När den tillhandahålls definierar den den åtgärd som ska vidtas när det redan finns en genväg med samma namn och sökväg. Standardåtgärden är "Abort". Ytterligare ShortcutConflictPolicy-typer kan läggas till över tid.

Värde Description
Abort

När det redan finns en genväg med samma namn och sökväg avbryts skapandet av genvägen.
GenerateUniqueName

När det redan finns en genväg med samma namn och sökväg fortsätter genvägen att skapas med ett nytt unikt genvägsnamn.
CreateOrOverwrite

När det redan finns en genväg med samma namn och sökväg skrivs den befintliga genvägen över. Skapa genväg om den inte finns.
OverwriteOnly

När det redan finns en genväg med samma namn och sökväg skrivs den befintliga genvägen över.

Target

Objekt

Ett objekt som innehåller måldatakällan och måste ange exakt ett av de mål som stöds enligt beskrivningen i tabellen nedan.

Name Typ Description
adlsGen2

AdlsGen2

Ett objekt som innehåller egenskaperna för mål-ADLS Gen2-datakällan.
amazonS3

AmazonS3

Ett objekt som innehåller egenskaperna för Amazon S3-måldatakällan.
azureBlobStorage

AzureBlobStorage

Ett objekt som innehåller egenskaperna för Azure Blob Storage-måldatakällan.
dataverse

Dataverse

Ett objekt som innehåller egenskaperna för Dataverse-måldatakällan.
externalDataShare

ExternalDataShareTarget

Ett objekt som innehåller egenskaperna för den externa måldataresursen.
googleCloudStorage

GoogleCloudStorage

Ett objekt som innehåller egenskaperna för Google Cloud Storage-måldatakällan.
oneLake

OneLake

Ett objekt som innehåller egenskaperna för onelake-måldatakällan.
s3Compatible

S3Compatible

Ett objekt som innehåller egenskaperna för den mål-S3-kompatibla datakällan.
type

Type

Typobjektet innehåller egenskaper som typ av målgenvägskonto. Ytterligare typer kan läggas till över tid.

Type

Uppräkning

Typobjektet innehåller egenskaper som typ av målgenvägskonto. Ytterligare typer kan läggas till över tid.

Värde Description
OneLake

OneLake
AmazonS3

AmazonS3
AdlsGen2

AdlsGen2
GoogleCloudStorage

GoogleCloudStorage
S3Compatible

S3Kompatibel
Dataverse

Dataverse (på engelska)
ExternalDataShare

ExternalDataShare
AzureBlobStorage

AzureBlobStorage