通过

Staging - Upload Custom Library (preview)

服务:
Environment
API 版本:
v1

将 Spark 库上传到环境中。

注释

此 API 是预览版的一部分，仅用于评估和开发目的。 它可能会根据反馈进行更改，不建议将其用于生产。 此预览版 API 将于 2026 年 3 月 1 日弃用，并替换为 此处提供的稳定版本。 新版本引入了中断性变更，并且不向后兼容。**

弃用通知

建议迁移集成以使用发布版本。

发布版本中引入了以下不兼容的更改：

  • 请求 URL 结构已更改：要添加的库名称现在直接在 URL 路径中指定。
  • 请求现在支持 application/octet-stream ， Content-Type 而不是 multipart/form-data。

此 API 允许一次上传一个文件。 支持的文件格式为.jar、.py、.whl、.tar.gz或environment.yml。

局限性

允许的最大请求大小为 100MB。

网络问题可能会影响上传大小，并可能导致超时。

Content-Type

库文件需要使用 Content-Type . multipart/form-data.

Permissions

环境项的写入权限。

所需的委派范围

Environment.ReadWrite.All

Microsoft Entra 支持的标识

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

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

接口

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/staging/libraries

URI 参数

名称 在 必需 类型 说明
environmentId
 path True

string (uuid)

环境 ID。
workspaceId
 path True

string (uuid)

工作区 ID。

响应

名称 类型 说明
200 OK

请求成功完成。
Other Status Codes

ErrorResponse

常见错误代码：

  • EnvironmentValidationFailed - 提供具有有效格式的库，例如.jar、.py、.whl、.tar.gz或environment.yml。

示例

Upload environment staging libraries example

示例请求

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/environments/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/staging/libraries

示例响应

状态代码:
200

定义

名称 说明
ErrorRelatedResource

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

错误响应。
ErrorResponseDetails

错误响应详细信息。

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

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