Saltar al contenido principal
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 el destino de ejecución predeterminado de la organización para las nuevas sesiones.

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

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 cuando un nombre coincide con ambas opciones. Los valores no reconocidos se rechazan con un error 400 que enumera las plataformas y los pools de outposts disponibles.

Maximum string length: 128
outpost_pool_id
string | null

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

Maximum string length: 128

Respuesta

Respuesta satisfactoria

El destino de ejecución predeterminado de la organización para las nuevas sesiones.

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 destino predeterminado es un pool de outposts o no está establecido.

outpost_pool_id
string | null
requerido

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

outpost_pool_name
string | null
requerido

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