Skip to main content
PUT
设置组织默认平台
设置新会话的组织级默认运行位置。该设置与 webapp 中 Settings > Devin > Default platform 的设置相同。创建会话时若未显式指定 platform,将优先使用创建者的个人默认设置,其次使用此设置。

权限

需要使用在组织级别具有 ManageOrgSettings 权限的服务用户或个人访问令牌。

请求字段

以下字段最多只能发送其中一个:
  • platform:为该组织配置的托管平台标签 (例如 linux、windows 或 macos) ,或共享 outpost pool 的名称,不区分大小写。如果某个名称同时匹配两者,则优先匹配平台。
  • outpost_pool_id:该组织可用的共享 outpost pool 的 ID。
如需清除默认设置,请发送空 JSON 对象 ({}) ,或将两个字段都设为 null。请求体为必填项。 只有共享 outpost pool 才能设为组织默认设置。个人 outpost 不能作为组织默认设置,因为只有其所有者才能在上面启动会话。

仅限 Outposts 的组织

当企业处于仅限 Outposts 模式时,只接受 outpost pool;使用托管平台标签将返回 400。

错误

  • 返回 400 的情况:platform 未匹配任何已配置的平台或共享 outpost pool、匹配到多个 outpost pool,或在仅限 Outposts 的组织中指定了托管平台;或者 outpost_pool_id 并非该组织可用的共享 pool。错误响应体中会列出可用的平台和 outpost pool。
  • 返回 403 的情况:调用方不具备 ManageOrgSettings 权限。
  • 返回 422 的情况:同时设置了 platform 和 outpost_pool_id。

示例

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

路径参数

org_id
string
必填

组织 ID(前缀:org-)

示例:

"org-abc123def456"

请求体

application/json

设置组织中新会话的默认运行位置。

platform 和 outpost_pool_id 最多提供一个;将两者均设为 null(例如 {})即可清除默认设置。

outpost_pool_id
string | null

组织可用的共享 outpost 资源池的 ID。

Maximum string length: 128
platform
string | null

为组织配置的托管平台标签(例如 'linux'、'windows'、'macos')或共享 outpost 资源池的名称,不区分大小写;当名称同时匹配两者时,平台优先。无法识别的值会被拒绝,并返回 400,响应中会列出可用的平台和 outpost 资源池。

Maximum string length: 128

响应

成功响应

组织中新会话的默认运行位置。

outpost_pool_id
string | null
必填

新会话默认使用的 outpost 资源池。默认运行位置为托管平台或未设置时,为 Null。

outpost_pool_name
string | null
必填

默认 outpost 资源池的名称。默认运行位置不是 outpost 资源池,或该资源池已不再对组织可用时,为 Null。

platform
string | null
必填

新会话默认使用的托管平台标签(例如 'linux'、'windows')。默认运行位置为 outpost 资源池或未设置时,为 Null。