Skip to main content
PUT
Standardplattform der Organisation festlegen
Legt die organisationsweite Standardplatzierung für neue Sitzungen fest. Dies entspricht der Einstellung Settings > Devin > Default platform in der Webapp. Für Sitzungen, die ohne explizite platform erstellt werden, gilt zunächst der persönliche Standard des Erstellers und danach diese Einstellung.

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageOrgSettings auf Organisationsebene.

Request-Felder

Senden Sie höchstens eines der folgenden Felder:
  • platform: ein für die Organisation konfiguriertes Label einer gehosteten Plattform (zum Beispiel linux, windows oder macos) oder der Name eines gemeinsam genutzten Outpost-Pools; Groß-/Kleinschreibung wird nicht beachtet. Wenn ein Name auf beides zutrifft, haben Plattformen Vorrang.
  • outpost_pool_id: die ID eines gemeinsam genutzten Outpost-Pools, der für die Organisation verfügbar ist.
Senden Sie ein leeres JSON-Objekt ({}) oder beide Felder als null, um den Standard zurückzusetzen. Der Request-Body ist erforderlich. Nur gemeinsam genutzte Outpost-Pools sind zulässig. Persönliche Outposts können nicht als Organisationsstandard festgelegt werden, da nur ihr Eigentümer darauf Sitzungen starten kann.

Organisationen im Nur-Outposts-Modus

Wenn sich das Enterprise im Nur-Outposts-Modus befindet, werden ausschließlich Outpost-Pools akzeptiert. Labels gehosteter Plattformen führen zu einem 400-Fehler.

Fehler

  • 400, wenn platform keiner konfigurierten Plattform und keinem gemeinsam genutzten Outpost-Pool entspricht, auf mehrere Outpost-Pools zutrifft oder in einer Organisation, die ausschließlich Outposts nutzt, eine gehostete Plattform angibt; oder wenn outpost_pool_id kein gemeinsam genutzter Pool ist, der der Organisation zur Verfügung steht. Der Fehler-Body listet die verfügbaren Plattformen und Outpost-Pools auf.
  • 403, wenn dem Aufrufer die Berechtigung ManageOrgSettings fehlt.
  • 422, wenn sowohl platform als auch outpost_pool_id gesetzt sind.

Beispiel

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

Body

application/json

Legen Sie den Standardausführungsort der Organisation für neue Sitzungen fest.

Übergeben Sie höchstens einen der Parameter platform und outpost_pool_id; übergeben Sie beide als null (zum Beispiel {}), um den Standard zurückzusetzen.

outpost_pool_id
string | null

ID eines gemeinsam genutzten Outpost-Pools, der der Organisation zur Verfügung steht.

Maximum string length: 128
platform
string | null

Eine für die Organisation konfigurierte Bezeichnung einer gehosteten Plattform (z. B. 'linux', 'windows', 'macos') oder der Name eines gemeinsam genutzten Outpost-Pools. Groß- und Kleinschreibung werden nicht berücksichtigt; bei gleichnamigen Plattformen und Pools haben Plattformen Vorrang. Unbekannte Werte werden mit dem HTTP-Statuscode 400 abgelehnt; die Antwort listet die verfügbaren Plattformen und Outpost-Pools auf.

Maximum string length: 128

Antwort

Erfolgreiche Antwort

Der Standardausführungsort der Organisation für neue Sitzungen.

outpost_pool_id
string | null
erforderlich

Outpost-Pool, in dem neue Sitzungen standardmäßig ausgeführt werden. Null, wenn als Standard eine gehostete Plattform festgelegt ist oder kein Standard festgelegt wurde.

outpost_pool_name
string | null
erforderlich

Name des Standard-Outpost-Pools. Null, wenn als Standard kein Outpost-Pool festgelegt ist oder der Pool der Organisation nicht mehr zur Verfügung steht.

platform
string | null
erforderlich

Bezeichnung der gehosteten Plattform (z. B. 'linux', 'windows'), auf der neue Sitzungen standardmäßig ausgeführt werden. Null, wenn als Standard ein Outpost-Pool festgelegt ist oder kein Standard festgelegt wurde.