OneLake Shortcuts - List Shortcuts

服务:: Core

API 版本:: v1

返回项的快捷方式列表，包括详尽的所有子文件夹。

所需的委派范围

OneLake.Read.All 或 OneLake.ReadWrite.All

Microsoft Entra 支持的标识

此 API 支持本节中列出的Microsoft 标识。

身份	支持
用户	是的
服务主体和托管标识	是的

接口

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

具有可选参数:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts?parentPath={parentPath}&continuationToken={continuationToken}

URI 参数

名称	在	必需	类型	说明
itemId	path	True	string (uuid)	项 ID。
workspaceId	path	True	string (uuid)	工作区 ID。
continuationToken	query		string	用于检索下一页结果的令牌。
parentPath	query		string	从中检索快捷方式的起始路径

响应

名称	类型	说明
200 OK	Shortcuts	请求成功完成。
Other Status Codes	ErrorResponse	常见错误代码： ItemNotFound - 服务器找不到请求的项目。 UnknownError - 发生错误。

名称

类型

说明

200 OK

Shortcuts

请求成功完成。

Other Status Codes

ErrorResponse

常见错误代码：

ItemNotFound - 服务器找不到请求的项目。
UnknownError - 发生错误。

示例

List shortcuts example

List shortcuts with continuation example

List shortcuts with shortcut transforms example

List shortcuts example

示例请求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/56bac802-080d-4f73-8a42-1b406eb1fcac/shortcuts

示例响应

状态代码:: 200

{
  "value": [
    {
      "path": "Files/blafolder/folder3",
      "name": "MyOneLakeShortcut",
      "target": {
        "type": "OneLake",
        "oneLake": {
          "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
          "path": "Tables/myTablesFolder/someTableSubFolder"
        }
      }
    },
    {
      "path": "Files/noaccess",
      "name": "MyS3Shortcut",
      "target": {
        "type": "AmazonS3"
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyS3CompatibleShortcut",
      "target": {
        "type": "S3Compatible",
        "s3Compatible": {
          "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc",
          "location": "https://s3endpoint.contoso.com",
          "bucket": "contosoBucket",
          "subpath": "s3CompatibleDirectory"
        }
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyGCSShortcut",
      "target": {
        "type": "GoogleCloudStorage",
        "googleCloudStorage": {
          "connectionId": "5b218778-e7a5-4d73-8187-f10824047715",
          "location": "https://gcs-contosoBucket.storage.googleapis.com",
          "subpath": "gcsDirectory"
        }
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyExternalDataShareShortcut",
      "target": {
        "type": "ExternalDataShare",
        "externalDataShare": {
          "connectionId": "af196b7b-0bf8-4430-b383-ad48d14f4edf"
        }
      }
    },
    {
      "path": "Files/bla1folder/folder4",
      "name": "MyDataShareShortcutWithREAD",
      "target": {
        "type": "ExternalDataShare"
      }
    }
  ]
}

List shortcuts with continuation example

示例请求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/56bac802-080d-4f73-8a42-1b406eb1fcac/shortcuts

示例响应

状态代码:: 200

{
  "value": [
    {
      "path": "Files/blafolder/folder3",
      "name": "MyOneLakeShortcut",
      "target": {
        "type": "OneLake",
        "oneLake": {
          "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
          "path": "Tables/myTablesFolder/someTableSubFolder"
        }
      }
    },
    {
      "path": "Files/noaccess",
      "name": "MyS3Shortcut",
      "target": {
        "type": "AmazonS3"
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyS3CompatibleShortcut",
      "target": {
        "type": "S3Compatible",
        "s3Compatible": {
          "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc",
          "location": "https://s3endpoint.contoso.com",
          "bucket": "contosoBucket",
          "subpath": "s3CompatibleDirectory"
        }
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyGCSShortcut",
      "target": {
        "type": "GoogleCloudStorage",
        "googleCloudStorage": {
          "connectionId": "5b218778-e7a5-4d73-8187-f10824047715",
          "location": "https://gcs-contosoBucket.storage.googleapis.com",
          "subpath": "gcsDirectory"
        }
      }
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyExternalDataShareShortcut",
      "target": {
        "type": "ExternalDataShare",
        "externalDataShare": {
          "connectionId": "af196b7b-0bf8-4430-b383-ad48d14f4edf"
        }
      }
    },
    {
      "path": "Files/bla1folder/folder4",
      "name": "MyDataShareShortcutWithREAD",
      "target": {
        "type": "ExternalDataShare"
      }
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/56bac802-080d-4f73-8a42-1b406eb1fcac/shortcuts?continuationToken=LDEsMTAwMDAwLDA%3D"
}

List shortcuts with shortcut transforms example

示例请求

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/56bac802-080d-4f73-8a42-1b406eb1fcac/shortcuts

示例响应

状态代码:: 200

{
  "value": [
    {
      "path": "Files/blafolder/folder3",
      "name": "MyOneLakeShortcut",
      "target": {
        "type": "OneLake",
        "oneLake": {
          "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
          "path": "Tables/myTablesFolder/someTableSubFolder"
        }
      },
      "isShortcutTransform": true
    },
    {
      "path": "Files/blafolder/folder3",
      "name": "MyS3CompatibleShortcut",
      "target": {
        "type": "S3Compatible",
        "s3Compatible": {
          "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc",
          "location": "https://s3endpoint.contoso.com",
          "bucket": "contosoBucket",
          "subpath": "s3CompatibleDirectory"
        }
      },
      "isShortcutTransform": true
    }
  ]
}

定义

名称	说明
AdlsGen2	包含目标 ADLS Gen2 数据源的属性的对象。
AmazonS3	包含目标 Amazon S3 数据源的属性的对象。
AzureBlobStorage	包含目标 Azure Blob 存储数据源的属性的对象。
CsvToDeltaTransform	CSV 到增量转换。
CsvToDeltaTransformProperties	CSV 到增量转换的属性。
Dataverse	包含目标 Dataverse 数据源的属性的对象。
ErrorRelatedResource	与错误相关的资源详细信息对象。
ErrorResponse	错误响应。
ErrorResponseDetails	错误响应详细信息。
ExternalDataShareTarget	包含目标外部数据共享的属性的对象。
GoogleCloudStorage	包含目标 Google Cloud Storage 数据源的属性的对象。
OneLake	包含目标 OneLake 数据源的属性的对象。
S3Compatible	包含目标 S3 兼容数据源的属性的对象。
Shortcuts
ShortcutTransformFlagged	表示指向其他存储位置（可以是 OneLake 内部或外部）的引用的对象。快捷方式由名称、创建快捷方式的路径以及指定目标存储位置的目标定义。
Target	一个包含目标数据源的对象，必须指定一个受支持的目标，如下表所述。
Type	类型对象包含目标快捷方式帐户类型等属性。可能会随着时间的推移添加其他类型。

AdlsGen2

Object

包含目标 ADLS Gen2 数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。若要查找此连接 ID，请先创建一个云连接，以在连接到 ADLS 数据位置时由快捷方式使用。打开云连接的“设置”视图并复制连接 ID;这是 GUID。
location	string (uri)	指定目标 ADLS 容器的位置。 URI 的格式必须为 https://[account-name].dfs.core.windows.net，其中 [account-name] 是目标 ADLS 帐户的名称。
subpath	string	指定目标文件夹所在的 ADLS 帐户中的容器和子文件夹。必须是格式 [container]/[subfolder]，其中 [container] 是保存文件和文件夹的容器的名称;[子文件夹] 是容器中子文件夹的名称（可选）。例如：/mycontainer/mysubfolder

AmazonS3

Object

包含目标 Amazon S3 数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。若要查找此连接 ID，请先创建一个云连接，以在连接到 Amazon S3 数据位置时由快捷方式使用。打开云连接的“设置”视图并复制连接 ID;这是 GUID。
location	string (uri)	指向 S3 中目标存储桶的 HTTP URL。 URL 的格式应为 https://[bucket-name].s3。[region-code].amazonaws.com，其中“bucket-name”是要指向的 S3 存储桶的名称，“region-code”是存储桶所在的区域的代码。例如：https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath	string	指定 S3 存储桶中的目标文件夹或子文件夹。

AzureBlobStorage

Object

包含目标 Azure Blob 存储数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。若要查找此连接 ID，请先创建一个云连接，以在连接到 Azure Blob 存储数据位置时由快捷方式使用。打开云连接的设置视图，并复制连接 ID 的 GUID。
location	string (uri)	指定目标 Azure Blob 存储容器的位置。 URI 必须采用目标 `https://[account-name].blob.core.windows.net` Azure Blob 存储帐户的名称的格式`[account-name]`。
subpath	string	指定目标文件夹所在的 Azure Blob 存储帐户中的容器和子文件夹。格式必须为 [container]/[subfolder]。 [容器] 是保存文件和文件夹的容器的名称。 [子文件夹] 是容器中子文件夹的名称，是可选的。例如：/mycontainer/mysubfolder

CsvToDeltaTransform

Object

CSV 到增量转换。

名称	类型	说明
properties	CsvToDeltaTransformProperties	CSV 到 Delta 转换属性。
type	string: csvToDelta	转换的类型。可能会随着时间的推移添加其他转换类型。

CsvToDeltaTransformProperties

Object

CSV 到增量转换的属性。

名称	类型	默认值	说明
delimiter	string	,	指定用于分隔 CSV 文件中某行中的值的字符，并且它必须指定受支持的值之一：`,`、、、 `\t`、`\|`、。 `;&` 默认值为 `,`。
skipFilesWithErrors	boolean	True	是否跳过出现错误的文件。 True - 跳过包含错误的文件，False - 不要跳过包含错误的文件。默认值为 True。
useFirstRowAsHeader	boolean	True	CSV 文件的第一行是否应用作标头。 True - 使用第一行作为标题。 False - 请勿将第一行用作标题。默认值为 True。

Dataverse

Object

包含目标 Dataverse 数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。若要查找此连接 ID，请先创建一个云连接，以在连接到 Dataverse 数据位置时由快捷方式使用。打开云连接的“设置”视图并复制连接 ID;这是 GUID。
deltaLakeFolder	string	指定存储目标数据的 DeltaLake 文件夹路径。
environmentDomain	string (uri)	指示 Dataverse 目标环境的域名的 URI。 URI 的格式应为“https://[orgname].crm[xx].dynamics.com”，其中 `[orgname]` 表示 Dataverse 组织的名称。
tableName	string	指定 Dataverse 中目标表的名称

ErrorRelatedResource

Object

与错误相关的资源详细信息对象。

名称	类型	说明
resourceId	string	错误中涉及的资源 ID。
resourceType	string	错误中涉及的资源的类型。

ErrorResponse

Object

错误响应。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
moreDetails	ErrorResponseDetails[]	其他错误详细信息的列表。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。
requestId	string	与错误关联的请求的 ID。

ErrorResponseDetails

Object

错误响应详细信息。

名称	类型	说明
errorCode	string	提供有关错误条件的信息的特定标识符，允许服务与其用户之间的标准化通信。
message	string	错误的人工可读表示形式。
relatedResource	ErrorRelatedResource	与错误相关的资源详细信息。

ExternalDataShareTarget

Object

包含目标外部数据共享的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。

GoogleCloudStorage

Object

包含目标 Google Cloud Storage 数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。
location	string (uri)	指向 GCS 中目标存储桶的 HTTP URL。 URL 的格式应为 https://[bucket-name].storage.googleapis.com，其中 [bucket-name] 是要指向的存储桶的名称。例如：https://my-gcs-bucket.storage.googleapis.com
subpath	string	指定 GCS 存储桶中的目标文件夹或子文件夹。例如：/folder

OneLake

Object

包含目标 OneLake 数据源的属性的对象。

名称	类型	说明
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。若要查找此连接 ID，请先创建一个云连接，以在连接到 Amazon S3 数据位置时由快捷方式使用。打开云连接的“设置”视图并复制连接 ID;这是 GUID。
itemId	string (uuid)	OneLake 中目标的 ID。目标可以是 Lakehouse、KQLDatabase 或 Warehouse 的项。
path	string	一个字符串，表示项中目标文件夹的完整路径。此路径应相对于 OneLake 目录结构的根目录。例如：“Tables/myTablesFolder/someTableSubFolder”。
workspaceId	string (uuid)	目标工作区的 ID。

S3Compatible

Object

包含目标 S3 兼容数据源的属性的对象。

名称	类型	说明
bucket	string	指定 S3 兼容位置中的目标存储桶。
connectionId	string (uuid)	一个字符串，表示与快捷方式绑定的连接。 connectionId 是用于在快捷方式与目标数据源之间建立连接的唯一标识符。
location	string (uri)	S3 兼容终结点的 HTTP URL。此终结点必须能够接收 ListBuckets S3 API 调用。 URL 必须采用非存储桶特定格式;此处不应指定存储桶。例如：`https://s3endpoint.contoso.com`
subpath	string	指定 S3 兼容存储桶中的目标文件夹或子文件夹。例如：/folder

Shortcuts

Object

名称	类型	说明
continuationToken	string	下一个结果集批处理的令牌。如果没有更多记录，则会从响应中删除该记录。
continuationUri	string	下一个结果集批处理的 URI。如果没有更多记录，则会从响应中删除该记录。
value	ShortcutTransformFlagged[]	快捷方式列表。

ShortcutTransformFlagged

Object

表示指向其他存储位置（可以是 OneLake 内部或外部）的引用的对象。快捷方式由名称、创建快捷方式的路径以及指定目标存储位置的目标定义。

名称	类型	说明
isShortcutTransform	boolean	确定此快捷方式是否为转换快捷方式。 True - 快捷转换，False - 常规快捷方式。可以使用 “获取快捷方式”获取快捷转换属性。
name	string	快捷方式的名称。
path	string	一个字符串，表示在其中创建快捷方式的完整路径，包括“文件”或“表”。
target	Target	一个包含目标数据源的对象，必须完全指定一个受支持的目标。
transform	Transform: CsvToDeltaTransform	一个对象，该对象包含要应用于目标数据的转换名称及其相应的属性，并且必须指定支持的转换之一。

Target

Object

一个包含目标数据源的对象，必须指定一个受支持的目标，如下表所述。

名称	类型	说明
adlsGen2	AdlsGen2	包含目标 ADLS Gen2 数据源的属性的对象。
amazonS3	AmazonS3	包含目标 Amazon S3 数据源的属性的对象。
azureBlobStorage	AzureBlobStorage	包含目标 Azure Blob 存储数据源的属性的对象。
dataverse	Dataverse	包含目标 Dataverse 数据源的属性的对象。
externalDataShare	ExternalDataShareTarget	包含目标外部数据共享的属性的对象。
googleCloudStorage	GoogleCloudStorage	包含目标 Google Cloud Storage 数据源的属性的对象。
oneLake	OneLake	包含目标 OneLake 数据源的属性的对象。
s3Compatible	S3Compatible	包含目标 S3 兼容数据源的属性的对象。
type	Type	类型对象包含目标快捷方式帐户类型等属性。可能会随着时间的推移添加其他类型。

Type

枚举

类型对象包含目标快捷方式帐户类型等属性。可能会随着时间的推移添加其他类型。

值	说明
OneLake	OneLake
AmazonS3	AmazonS3
AdlsGen2	AdlsGen2
GoogleCloudStorage	Google云存储
S3Compatible	S3Compatible
Dataverse	Dataverse
ExternalDataShare	ExternalDataShare
AzureBlobStorage	AzureBlobStorage

通过

OneLake Shortcuts - List Shortcuts

所需的委派范围

Microsoft Entra 支持的标识

接口

URI 参数

响应

示例

List shortcuts example

示例请求

示例响应

List shortcuts with continuation example

示例请求

示例响应

List shortcuts with shortcut transforms example

示例请求

示例响应

定义

AdlsGen2

AmazonS3

AzureBlobStorage

CsvToDeltaTransform

CsvToDeltaTransformProperties

Dataverse

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ExternalDataShareTarget

GoogleCloudStorage

OneLake

S3Compatible

Shortcuts

ShortcutTransformFlagged

Target

Type