Skip to main content
PUT
Definir plataforma padrão da organização
Define o destino padrão para novas sessões em toda a organização. É a mesma configuração de Configurações > Devin > Plataforma padrão no webapp. As sessões criadas sem um valor explícito para platform usam primeiro o padrão pessoal de quem as criou e, na ausência dele, o padrão da organização.

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ManageOrgSettings no nível da organização.

Campos da requisição

Envie no máximo um dos seguintes campos:
  • platform: um rótulo de plataforma hospedada configurado para a organização (por exemplo, linux, windows ou macos) ou o nome de um pool do outpost compartilhado, sem distinção entre maiúsculas e minúsculas. As plataformas têm prioridade quando um nome corresponde tanto a uma plataforma quanto a um pool.
  • outpost_pool_id: o ID de um pool do outpost compartilhado disponível para a organização.
Envie um objeto JSON vazio ({}) ou ambos os campos como null para remover a configuração padrão. O corpo da requisição é obrigatório. Somente pools do outpost compartilhados podem ser usados. Outposts pessoais não podem ser definidos como padrão da organização, pois apenas seu proprietário pode iniciar sessões neles.

Organizações exclusivas para Outposts

Quando a conta Enterprise está no modo exclusivo para Outposts, apenas pools do outpost são aceitos. Rótulos da plataforma hospedada retornam 400.

Erros

  • 400 quando platform não corresponde a nenhuma plataforma configurada nem a nenhum pool do outpost compartilhado, corresponde a vários pools do outpost ou indica uma plataforma hospedada em uma organização que usa apenas Outposts; ou quando outpost_pool_id não identifica um pool compartilhado disponível para a organização. O corpo da resposta de erro lista as plataformas e os pools do outpost disponíveis.
  • 403 quando o solicitante não tem a permissão ManageOrgSettings.
  • 422 quando tanto platform quanto outpost_pool_id estão definidos.

Exemplo

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id
string
obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Corpo

application/json

Defina o local de execução padrão da organização para novas sessões.

Envie no máximo um dos campos platform e outpost_pool_id; envie ambos como null (por exemplo, {}) para remover o padrão.

outpost_pool_id
string | null

ID de um pool do outpost compartilhado disponível para a organização.

Maximum string length: 128
platform
string | null

Um rótulo de plataforma hospedada configurado para a organização (por exemplo, 'linux', 'windows', 'macos') ou o nome de um pool do outpost compartilhado, sem distinção entre maiúsculas e minúsculas; as plataformas têm prioridade quando um nome corresponde a ambos. Valores não reconhecidos são rejeitados com um erro 400 que lista as plataformas e os pools do outpost disponíveis.

Maximum string length: 128

Resposta

Resposta bem-sucedida

O local de execução padrão da organização para novas sessões.

outpost_pool_id
string | null
obrigatório

Pool do outpost em que novas sessões são executadas por padrão. Null quando o padrão é uma plataforma hospedada ou não está definido.

outpost_pool_name
string | null
obrigatório

Nome do pool do outpost padrão. Null quando o padrão não é um pool do outpost ou o pool não está mais disponível para a organização.

platform
string | null
obrigatório

Rótulo da plataforma hospedada (por exemplo, 'linux', 'windows') em que novas sessões são executadas por padrão. Null quando o padrão é um pool do outpost ou não está definido.