Skip to main content
PUT
Imposta la piattaforma predefinita dell'organizzazione
Imposta la destinazione predefinita a livello di organizzazione per le nuove sessioni. È la stessa impostazione disponibile in Settings > Devin > Default platform nella webapp. Le sessioni create senza specificare platform usano innanzitutto l’impostazione predefinita personale di chi le crea e, in mancanza di questa, quella dell’organizzazione.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageOrgSettings a livello di organizzazione.

Campi della richiesta

Invia al massimo uno dei seguenti campi:
  • platform: un’etichetta di piattaforma ospitata configurata per l’organizzazione (ad esempio linux, windows o macos) oppure il nome di un pool outpost condiviso, senza distinzione tra maiuscole e minuscole. Se un nome corrisponde a entrambi, prevale la piattaforma.
  • outpost_pool_id: l’ID di un pool outpost condiviso disponibile per l’organizzazione.
Per rimuovere il valore predefinito, invia un oggetto JSON vuoto ({}) oppure entrambi i campi impostati su null. Il corpo della richiesta è obbligatorio. Sono ammessi solo i pool outpost condivisi. Gli outpost personali non possono essere impostati come valore predefinito dell’organizzazione, perché solo il proprietario può avviarvi sessioni.

Organizzazioni solo Outposts

Quando l’enterprise è in modalità solo Outposts, vengono accettati soltanto i pool outpost. Le etichette della piattaforma ospitata restituiscono l’errore 400.

Errori

  • 400 quando platform non corrisponde ad alcuna piattaforma configurata né ad alcun pool outpost condiviso, corrisponde a più pool outpost oppure indica una piattaforma ospitata in un’organizzazione che usa esclusivamente outpost; oppure quando outpost_pool_id non è un pool condiviso disponibile per l’organizzazione. Il corpo dell’errore elenca le piattaforme e i pool outpost disponibili.
  • 403 quando il chiamante non dispone dell’autorizzazione ManageOrgSettings.
  • 422 quando sono impostati sia platform sia outpost_pool_id.

Esempio

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

Corpo

application/json

Imposta la destinazione predefinita dell'organizzazione per le nuove sessioni.

Invia al massimo uno dei due parametri platform e outpost_pool_id; inviali entrambi come null (ad esempio {}) per rimuovere l'impostazione predefinita.

outpost_pool_id
string | null

ID di un pool outpost condiviso disponibile per l'organizzazione.

Maximum string length: 128
platform
string | null

Un'etichetta di piattaforma ospitata configurata per l'organizzazione (ad es. 'linux', 'windows', 'macos') o il nome di un pool outpost condiviso, senza distinzione tra maiuscole e minuscole; se un nome corrisponde sia a una piattaforma sia a un pool, la piattaforma ha la priorità. I valori non riconosciuti vengono rifiutati con un errore 400 che elenca le piattaforme e i pool outpost disponibili.

Maximum string length: 128

Risposta

Risposta riuscita

Destinazione predefinita dell'organizzazione per le nuove sessioni.

outpost_pool_id
string | null
obbligatorio

Pool outpost in cui vengono eseguite le nuove sessioni per impostazione predefinita. Null quando la destinazione predefinita è una piattaforma ospitata o non è impostata.

outpost_pool_name
string | null
obbligatorio

Nome del pool outpost predefinito. Null quando la destinazione predefinita non è un pool outpost o il pool non è più disponibile per l'organizzazione.

platform
string | null
obbligatorio

Etichetta della piattaforma ospitata (ad es. 'linux', 'windows') su cui vengono eseguite le nuove sessioni per impostazione predefinita. Null quando la destinazione predefinita è un pool outpost o non è impostata.