UIP 或附件

uip or attachments管理作业附件 — 作为输入或输出附加到作业的文件（屏幕截图、报告、数据文件）。附件是租户范围内的，因此download不需要文件夹上下文。如需上传，请使用jobs start --attachment或--attachment-id 。

大纲

uip or attachments <verb> [options]

动词

动词	用途
list	列出特定作业的附件。
download	按 ID 下载单个附件。

UIP 或附件列表

列出作业附件。返回附件 ID、名称、类别（ Input或Output ）和创建时间戳。该动词在内部解析作业的文件夹上下文，并直接调用（非批处理） JobAttachments/GetByJobKey端点。

选项

短	长	值	默认	描述
—	--job-key	GUID	必填	要列出其附件的作业键。
-t	--tenant	name	会话默认值	覆盖租户。

示例

uip or attachments list --job-key b2c3d4e5-0000-0000-0000-000000000001

uip or attachments list --job-key b2c3d4e5-0000-0000-0000-000000000001 \
    --output-filter "Data[?Category=='Output'].AttachmentId"

uip or attachments list --job-key b2c3d4e5-0000-0000-0000-000000000001 --output table

数据形状（--输出 json）

{
  "Code": "AttachmentList",
  "Data": [
    {
      "AttachmentId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Name": "screenshot.png",
      "Category": "Output",
      "Created": "2025-04-15T10:32:00Z"
    }
  ]
}

uip 或附件下载

将作业附件下载到本地磁盘。CLI 使用DownloadAttachmentFile ，它将 302 重定向返回到 Blob 存储；动词遵循重定向并将文件写入磁盘。

参数

名称	必填	用途
<attachment-id>	是	附件 ID (GUID)。通过使用attachments list或从jobs get输出中查找。

选项

短	长	值	默认	描述
-t	--tenant	name	会话默认值	覆盖租户。
-o	--output	路径	attachment-<id>	输出文件路径。

示例

uip or attachments download a1b2c3d4-0000-0000-0000-000000000001 \
    --output ./report.pdf

uip or attachments download a1b2c3d4-0000-0000-0000-000000000001 \
    -o /tmp/screenshot.png

uip or attachments download a1b2c3d4-0000-0000-0000-000000000001 \
    --output ./report.pdf --output-filter 'Data.Size'

数据形状（--输出 json）

{
  "Code": "AttachmentDownloaded",
  "Data": {
    "AttachmentId": "a1b2c3d4-0000-0000-0000-000000000001",
    "FileName": "./report.pdf",
    "Size": 204812
  }
}

退出代码

请参阅退出代码。没有动词特定的覆盖。

相关命令

• uip or jobs — jobs start --attachment / --attachment-id ，可在启动作业时附加文件； jobs get在其输出中显示附件引用。

另请参阅

• 全局选项。