Skip to main content
PUT
Définir la plateforme par défaut de l’organisation
Définit l’emplacement par défaut des nouvelles sessions pour l’ensemble de l’organisation. Ce paramètre est identique à Settings > Devin > Default platform dans la webapp. Les sessions créées sans platform explicite utilisent en priorité la valeur par défaut personnelle de leur créateur, puis celle-ci.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant de l’autorisation ManageOrgSettings au niveau de l’organisation.

Champs de la requête

Envoyez au plus l’un des champs suivants :
  • platform : un libellé de plateforme hébergée configuré pour l’organisation (par exemple linux, windows ou macos) ou le nom d’un pool Outposts partagé, sans distinction de casse. Si un nom correspond aux deux, la plateforme est prioritaire.
  • outpost_pool_id : l’ID d’un pool Outposts partagé disponible pour l’organisation.
Pour supprimer la valeur par défaut, envoyez un objet JSON vide ({}) ou définissez les deux champs sur null. Le corps de la requête est obligatoire. Seuls les pools Outposts partagés sont éligibles. Un outpost personnel ne peut pas servir de valeur par défaut pour l’organisation, car seul son propriétaire peut y lancer des sessions.

Organisations en mode Outposts uniquement

Lorsque l’Enterprise est en mode Outposts uniquement, seuls les pools Outposts sont acceptés. Les libellés de plateforme hébergée renvoient une erreur 400.

Erreurs

  • 400 lorsque platform ne correspond à aucune plateforme configurée ni à aucun pool Outposts partagé, correspond à plusieurs pools Outposts, ou désigne une plateforme hébergée dans une organisation qui utilise exclusivement Outposts ; ou lorsque outpost_pool_id ne correspond pas à un pool partagé disponible pour l’organisation. Le corps de l’erreur liste les plateformes et les pools Outposts disponibles.
  • 403 lorsque l’appelant ne dispose pas de l’autorisation ManageOrgSettings.
  • 422 lorsque platform et outpost_pool_id sont tous deux définis.

Exemple

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

org_id
string
requis

ID de l’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Corps

application/json

Définissez l’environnement d’exécution par défaut de l’organisation pour les nouvelles sessions.

Envoyez au plus un des deux paramètres platform et outpost_pool_id ; envoyez les deux avec la valeur null (par exemple {}) pour supprimer la valeur par défaut.

outpost_pool_id
string | null

ID d’un pool Outposts partagé disponible pour l’organisation.

Maximum string length: 128
platform
string | null

Un libellé de plateforme hébergée configuré pour l’organisation (p. ex. 'linux', 'windows', 'macos') ou le nom d’un pool Outposts partagé, sans distinction de casse ; les plateformes sont prioritaires lorsqu’un nom correspond aux deux. Les valeurs non reconnues sont rejetées avec une réponse 400 qui répertorie les plateformes et les pools Outposts disponibles.

Maximum string length: 128

Réponse

Réponse réussie

Environnement d’exécution par défaut de l’organisation pour les nouvelles sessions.

outpost_pool_id
string | null
requis

Pool Outposts sur lequel les nouvelles sessions s’exécutent par défaut. Vaut null si l’environnement par défaut est une plateforme hébergée ou n’est pas défini.

outpost_pool_name
string | null
requis

Nom du pool Outposts par défaut. Vaut null si l’environnement par défaut n’est pas un pool Outposts ou si le pool n’est plus disponible pour l’organisation.

platform
string | null
requis

Libellé de la plateforme hébergée (p. ex. 'linux', 'windows') sur laquelle les nouvelles sessions s’exécutent par défaut. Vaut null si l’environnement par défaut est un pool Outposts ou n’est pas défini.