uip 为资源

“uip 是资源”的语法和选项，用于列出、描述连接器数据平面对象并对其运行操作。

uip is resources适用于连接器处理的运行时对象 - 工单、联系人、记录、文件。list枚举连接器的对象， describe返回一个对象的字段架构和操作， run针对连接调用连接器的数据平面（创建/列出/获取/更新/替换/删除）。每个run动词都需要--connection-id ；缓存的元数据读取（ list 、 describe ）时，请选择是否接受它以显示自定义对象/字段。

重要提示：

数据平面动词组为uip is resources run ，而不是execute — uip is resources execute ...不存在，并且失败，并显示“未知命令”。

大纲

uip is resources <verb> [options]

动词

动词	用途
list	列出连接器上的可用对象；可选择按操作筛选。
describe	描述一个对象的操作和字段架构。
run	调用连接器的数据平面（创建/列出/获取/更新/替换/删除）。

uip 是资源列表

列出连接器上的可用对象。结果取决于是否提供--connection-id — 连接作用域列表包括自定义对象；无作用域列表则不需要（在这种情况下，CLI 显示Warning ）。

参数

名称	必填	用途
<connector-key>	是	连接器键，例如uipath-zoho-desk 。

选项

短	长	值	默认	描述
—	--operation	枚举	—	按操作筛选： List 、 Retrieve 、 Create 、 Update 、 Delete 、 Replace 。
—	--connection-id	id	—	作用域到特定连接（启用自定义对象）。
—	--refresh	标记	关闭	强制从 API 重新获取，忽略缓存。

示例

uip is resources list uipath-zoho-desk

# Only objects that support a Create operation
uip is resources list uipath-zoho-desk --operation Create

# Connection-scoped listing — includes custom objects
uip is resources list uipath-zoho-desk \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

数据形状（--输出 json）

{
  "Code": "ResourceList",
  "Data": [
    {
      "Name": "tickets",
      "DisplayName": "Tickets",
      "Path": "/tickets",
      "Type": "standard",
      "SubType": "standard",
      "Custom": "no",
      "ElementKey": "uipath-zoho-desk"
    }
  ]
}

uip 是资源描述

描述对象的字段和操作。如果没有--operation ，则返回可用操作的列表和提示。使用--operation ，可以缩小到一个操作，并返回其参数、请求字段和响应字段。

参数

名称	必填	用途
<connector-key>	是	连接器密钥。
<object-name>	是	对象名称 — 活动配置 JSON 中的 objectName（例如 tickets）。查找带有 resources list 的名称。在两个 --activity-version 值下以相同的方式对对象进行编址（见下文）。

选项

短	长	值	默认	描述
—	--connection-id	id	—	连接的作用域（启用自定义字段；与 --field 一起完成为必填项）。
—	--operation	枚举	—	List、Retrieve、Create、Update、Delete 或 Replace。与 --field 一起需要。
—	--activity-version	1.0.0 | 4.0.0	1.0.0	要查询哪些活动元数据端点 — 请参阅下方的活动元数据版本。
-f	--field	name=value	—	父字段值。可重复。运行连接器的 API 类型 ObjectAction（例如 Jira 的 GenerateSchema、Salesforce 的 GenerateQuerySchema），并将其自定义字段响应合并到 requestFields。同时需要 --connection-id 和 --operation。不支持 --activity-version 4.0.0。
—	--action	name	已推断	显式 API 类型 ObjectAction 名称（例如 GenerateSchema）。可选 — 如果省略，则从 --field 名称推断；当多个操作可能匹配时，传递它以消除歧义。
—	--refresh	标记	关闭	强制从 API 重新获取，忽略缓存。每当提供 --field 时，系统也会自动绕过缓存，因为每个父字段组合的设计操作响应都不同。

活动元数据版本

--activity-version 切换 Integration Service 元数据端点 describe 查询：

• 1.0.0 （默认）— v3 元素端点，连接范围。支持 -f/--field 设计操作查找。
• 4.0.0 — v4 元素端点，不是连接作用域。接受同时传递 --connection-id，但会被忽略（并显示警告），因为 v4 提取本身不需要它。使用 -f/--field 直接拒绝 --activity-version 4.0.0 — 设计时 ObjectAction 是仅限 v3 的实例作用域功能。

在这两种情况下，<object-name> 位置含义相同，都是对象的名称，因此两个版本之间在地址方面没有区别，区别仅在于哪个后端端点响应调用。

示例

# List operations available on this object (v3, default)
uip is resources describe uipath-zoho-desk tickets

# Field schema for the Create operation
uip is resources describe uipath-zoho-desk tickets --operation Create

# Required request fields, scripting-friendly
uip is resources describe uipath-zoho-desk tickets --operation Create \
    --output-filter 'Data.requestFields[?required].name'

# Describe a 4.0.0 activity by object name (v4 elements endpoints)
uip is resources describe uipath-salesforce-slack add_users_to_usergroup \
    --activity-version 4.0.0

# Parent-field values (Jira: project + issue type → custom fields for that combination)
uip is resources describe uipath-atlassian-jira curated_create_issue \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --operation Create \
    -f fields.project.key=ENGCE -f fields.issuetype.id=3

# Body-token parent field (Salesforce SOQL: query → response columns)
uip is resources describe uipath-salesforce-sfdc query_records \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --operation Create \
    -f query="SELECT Id, Name FROM Account WHERE Status = 'Active'"

备注：

如果 -f/--field 调用返回时仅包含您提供的字段（均不是连接自己的自定义字段），则响应还会包含 Warning：您传递的其中一个值在该连接上可能不存在。请与该字段的查找词进行检查。

数据形状（--输出 json）

没有--operation ：

{
  "Code": "ResourceMetadata",
  "Data": {
    "name": "tickets",
    "displayName": "Tickets",
    "elementKey": "uipath-zoho-desk",
    "availableOperations": [
      { "method": "GET", "name": "List", "description": "Search for Tickets", "path": "/tickets" },
      { "method": "POST", "name": "Create", "description": "Create a Tickets", "path": "/tickets" }
    ],
    "hint": "Use --operation <Create|List|Retrieve|Update|Delete|Replace> to see fields for a specific operation."
  }
}

使用--operation Create时，系统会返回相同的Code: "ResourceMetadata" ，但有效负载不是availableOperations ，而是带有operation 、 parameters 、 requestFields和responseFields 。

使用 -f/--field（父字段/设计操作查找）时，requestFields 会反映合并后的特定于连接的架构：

{
  "Code": "ResourceMetadata",
  "Data": {
    "name": "curated_create_issue",
    "operation": { "method": "POST", "name": "Create" },
    "requestFields": [
      { "name": "fields.project.key", "required": true, "displayName": "Project" },
      { "name": "fields.issuetype.id", "required": true, "displayName": "Issue type" },
      { "name": "fields.summary", "required": true, "displayName": "Summary" },
      { "name": "fields.description", "required": false, "displayName": "Description" }
    ]
  }
}

uip 是资源运行

调用连接器的数据平面。run 本身是一个组；实际上的动词为 create、list、get、update、replace 和 delete。每个动词都需要 --connection-id； create、update 和 replace 还需要 --body 具有 JSON 请求正文。delete具有破坏性，需要-y, --yes — CLI 从不提示。

uip is resources run create   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources run list     <connector-key> <object-name> --connection-id <id>
uip is resources run get      <connector-key> <object-name> --connection-id <id> [--query <params>]
uip is resources run update   <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources run replace  <connector-key> <object-name> --connection-id <id> --body <json>
uip is resources run delete   <connector-key> <object-name> --connection-id <id> -y, --yes [--query <params>]

HTTP 方法映射： create → POST， list → GET（集合）， get → 按 ID GET， update → PATCH， replace → PUT， delete → DELETE。

参数

名称	必填	用途
<connector-key>	是	连接器密钥。
<object-name>	是	对象名称（例如tickets ）。

共享选项

短	长	值	默认	描述
—	--connection-id	id	必填	用于授权数据平面调用的连接。
—	--query	参数	—	查询参数。接受key=value&key=value或 JSON 对象。
—	--body	JSON	—	请求正文。对于create 、 update 、 replace为必要项。
-y	--yes	标记	—	仅在delete上需要。确认此不可撤销的操作 — CLI 从不提示。

示例

# Create a ticket
uip is resources run create uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --body '{"subject":"New issue","departmentId":"DEP-1"}'

# List tickets — first page
uip is resources run list uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001

# Delete a ticket by ID — destructive, requires --yes
uip is resources run delete uipath-zoho-desk tickets \
    --connection-id a1b2c3d4-0000-0000-0000-000000000001 \
    --query 'id=TK-1001' \
    --yes

数据形状（--输出 json）

{
  "Code": "ExecuteOperation",
  "Data": { "id": "TK-1001", "subject": "New issue", "status": "Open" }
}

list操作返回{ "items": [...] } ，当后端通过Elements-Has-More / Elements-Next-Page-Token标头发出更多页面信号时，请在其中包含具有HasMore和NextPageToken Pagination对象。

失败的调用会显示为Failure ，HTTP 状态为Message ，服务器正文为Instructions 。

相关内容

• uip is connections — --connection-id值来自connections list / connections create 。
• uip is connectors — 首先发现连接器密钥。
• uip is activities — 查看连接器公开的命名操作。
• uip is triggers — 此处数据平面动词的事件驱动对应项。

另请参阅

• Integration Service 工具概述
• 全局选项
• 退出代码