Skip to main content
PUT
Establecer la plataforma predeterminada de la organización
Establece la ubicación predeterminada de las nuevas sesiones para toda la organización. Es la misma opción que Settings > Devin > Default platform en la webapp. Las sesiones creadas sin un platform explícito usan primero el valor predeterminado personal de quien las crea y, en su defecto, este.

Permisos

Requiere un usuario de servicio o un token de acceso personal con el permiso ManageOrgSettings a nivel de organización.

Campos de la solicitud

Envía como máximo uno de los siguientes:
  • platform: una etiqueta de plataforma alojada configurada para la organización (por ejemplo, linux, windows o macos) o el nombre de un pool de outposts compartido; no distingue entre mayúsculas y minúsculas. Si un nombre coincide con ambos, tiene prioridad la plataforma.
  • outpost_pool_id: el ID de un pool de outposts compartido disponible para la organización.
Envía un objeto JSON vacío ({}), o ambos campos como null, para borrar el valor predeterminado. El cuerpo de la solicitud es obligatorio. Solo se admiten pools de outposts compartidos. Los outposts personales no pueden ser el valor predeterminado de la organización porque solo su propietario puede iniciar sesiones en ellos.

Organizaciones solo con Outposts

Cuando la Enterprise está en modo solo Outposts, únicamente se aceptan pools de Outposts. Las etiquetas de plataforma alojada devuelven un error 400.

Errores

  • 400 cuando platform no coincide con ninguna plataforma configurada ni con ningún pool de Outposts compartido, coincide con varios pools de Outposts o hace referencia a una plataforma alojada en una organización que solo usa Outposts; o cuando outpost_pool_id no corresponde a un pool compartido disponible para la organización. El cuerpo del error indica las plataformas y los pools de Outposts disponibles.
  • 403 cuando el autor de la llamada no tiene el permiso ManageOrgSettings.
  • 422 cuando se especifican a la vez platform y outpost_pool_id.

Ejemplo

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de la organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Cuerpo

application/json

Establece la ubicación de ejecución predeterminada de la organización para las nuevas sesiones.

Envía como máximo uno de los campos platform y outpost_pool_id; envía ambos como null (por ejemplo, {}) para borrar el valor predeterminado.

outpost_pool_id
string | null

ID de un pool de outposts compartido disponible para la organización.

Maximum string length: 128
platform
string | null

Una etiqueta de plataforma alojada configurada para la organización (p. ej., 'linux', 'windows', 'macos') o el nombre de un pool de outposts compartido, sin distinguir entre mayúsculas y minúsculas; las plataformas tienen prioridad si un nombre coincide tanto con una plataforma como con un pool. Los valores no reconocidos se rechazan con un error 400 que enumera las plataformas y los pools de outposts disponibles.

Maximum string length: 128

Respuesta

Respuesta satisfactoria

Ubicación de ejecución predeterminada de la organización para las nuevas sesiones.

outpost_pool_id
string | null
requerido

Pool de outposts en el que se ejecutan las nuevas sesiones de forma predeterminada. Null cuando el valor predeterminado es una plataforma alojada o no está definido.

outpost_pool_name
string | null
requerido

Nombre del pool de outposts predeterminado. Null cuando el valor predeterminado no es un pool de outposts o el pool ya no está disponible para la organización.

platform
string | null
requerido

Etiqueta de la plataforma alojada (p. ej., 'linux', 'windows') en la que se ejecutan las nuevas sesiones de forma predeterminada. Null cuando el valor predeterminado es un pool de outposts o no está definido.