創建設備池 API

設備池是設備或類似設備的邏輯分組 Bot Runner 您可以在其上運行工作負載管理自動化或計劃自動化的機器。使用具有唯一名稱的 API 創建設備池並添加無人值守 Bot Runners 到設備池。

先決條件

註: 您可以查看 Control Room APIs 在裡面 Community Edition，但 API 功能有限。你需要一個許可 Automation 360 版本以訪問 API 的全部功能。

確保您具備以下條件：

AAE_Pool_Admin 角色和查看和管理所有設備權限
所有 API 調用都必須包含來自驗證 API （生成 JSON Web 令牌）或來自 OAuth 服務的不記名令牌。您不能在 API 中同時使用兩者。
端點 URL：
- <your_control_room_url>/v2/devices/pools
- <your_control_room_url>/v2/devices/list

程序

將身份驗證令牌或承載令牌添加到請求標頭。您不能在同一 API 中同時使用兩者。
使用 POST 方法和端點 URL：<your_control_room_url>/v2/devices/pools.
如果要搜索或獲取所有可用 deviceIds，請使用以下端點 URL： https://<your_control_room_url>/v2/devices/list
請求設備詳細信息
例如：
```
POST https://192.0.2.0/v2/devices/pools
```
此示例請求正文使您能夠添加自動化方案，無人值守 Bot Runners，設備池中的所有者和消費者。
請求正文：
```
{
  "name": "Finance-device-pool",
  "description": "Pool for Finance RPA",
  "deviceIds": [
    "1",
    "10"
  ],
  "automationScheme": "ROUND_ROBIN",
  "ownerIds": [
    "1",
    "24",
    "26"
  ],
  "consumerIds": [
    "21",
    "22"
  ]
}
```

發送請求。

當請求成功時，響應正文中會返回一個唯一的設備池id還提供了與設備池關聯的設備、所有者和消費者的詳細信息。

在此示例中，響應正文將唯一設備池 id 為 4。

回復正文：

{
  "id": "4",
  "name": "Finance-device-pool",
  "description": "Pool for Finance RPA",
  "automationScheme": "ROUND_ROBIN",
  "status": "CONNECTED",
  "timeSlice": "5",
  "timeSliceUnit": "MINUTES",
  "deviceIds": [
    "1",
    "10"
  ],
  "ownerIds": [
    "1",
    "24",
    "26"
  ],
  "consumerIds": [
    
  ],
  "detailedStatus": "SOME_CONNECTED",
  "updatedBy": "24",
  "updatedOn": "2020-05-26T09:26:54.556280800Z",
  "createdBy": "24",
  "createdOn": "2020-05-26T09:26:54.556280800Z",
  "tenantUuid": "4db5b32c-5c4b-4aee-8ca0-f53ec241563c",
  "tenantId": "4"
}

REST API 使用 HTTP 響應代碼響應每個請求。有關響應代碼，請參閱 API響應代碼.

後續步驟

如果您正在執行以下步驟創建工作負載自動化，下一個跑步 bot 使用隊列 API.

如果您正在執行以下步驟部署一個 bot，下一個機器人部署 - V3.