通过 API 唤醒 Cloud 机器

Azure 和 AWS 等云托管平台通常需要几分钟时间来启动新的云虚拟机。不过,如果您已知悉您将要运行构建(例如 CLI 工具),则可以使用我们的 API 在执行之前手动启动虚拟机,以加速构建过程。

如果池中有任何虚拟机已启动但仍处于非活动状态,那么 Incredibuild 将会使用这些机器。已启动的虚拟机数量受限于池中虚拟机数量。任务执行完成后,Incredibuild Cloud 将自动停止为此任务启动的正在运行的虚拟机。

API 基于 coreReq 参数调用本身,该参数应包含您要启动的核心数量。根据您正在使用的虚拟机类型,相应数量的虚拟机将启动。例如,如果您正在使用的是具有 2 个核心的虚拟机类型,且您正在请求 8 个核心,那么将会启动 4 个虚拟机。

请求语法

POST https://incredicloudapim-prod.azure-api.net/provision/setWakeupMachines/ HTTP/1.1
Content-type: application/json
X-IBC-SECRET: <”customer secret”> {
"coordId": "string",
"coreReq": "number"
}

其中:

  • 客户密码:如需查找您的客户密码:

    • 如果您在登录和激活 Incredibuild Cloud 集成时使用了完全权限,则可以从注册表获取您的客户密码:

      HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Xoreax\Incredibuild\Coordinator\IncrediCloudSubscriptionKey

    • 如果您在登录和激活 Incredibuild Cloud 集成时使用了低权限

    • CoordId – 您的 Coordinator ID。您可以通过转到 Incredibuild taskbar icon > HelpAbout 并复制 License ID 来找到此 ID。这会因 Incredibuild 版本而异。

  • CoreReq – 您想要启动的核心数量。值为 0 将启动池中所有正处于停止状态的虚拟机。值大于 0 将启动特定的核心数。如果您请求的核心数量低于您正在使用的单一虚拟机类型中所含的核心数量,则核心数量将四舍五入。例如,如果您想请求 24 个核心,但您正在使用的是具有 32 个核心的虚拟机类型,那么将会启动一个具有 32 个核心的虚拟机。

响应语法

成功
HTTP/1.1 200
Content-type: application/json
{
machinesToWakeUp : []
}

响应元素

如果操作成功,服务将发回 HTTP 200 响应,其中包含 machinesToWakeUp - 在您的请求之后启动的虚拟机名称列表。