Skip to main content

Listar os codespaces na sua organização

Você pode listar todos os codespaces atualmente ativos ou interrompidos para sua organização.

Who can use this feature

To list all of the current codespaces for your organization, you must be an organization owner.

Visão geral

Como proprietário de uma organização, você pode listar todos os codespaces atualmente ativos ou interrompidos para sua organização. Talvez você queira fazer isso para verificar quantos codespaces os usuários estão criando, para garantir que eles não estejam incorrendo em custos desnecessários. Para ver mais informações sobre preços, confira "Sobre a cobrança dos GitHub Codespaces".

A maneira mais fácil de listar os codespaces para uma organização é usando GitHub CLI. Você também pode usar a API REST, que fornece mais informações sobre cada codespace.

Para obter informações de como ver o uso total atual dos Codespaces na organização ou empresa e gerar um relatório detalhado, confira "Como ver o uso dos GitHub Codespaces".

Usar GitHub CLI para listar codespaces

Para listar todos os codespaces atuais de uma organização especificada, use o comando a seguir.

Shell
gh codespace list --org ORGANIZATION 

Este comando retorna uma lista que inclui as seguintes informações para cada codespace:

- O nome e o nome de exibição 
- O usuário que criou o codespace
- O repositório e o branch
- O estado atual do codespace

Para listar todos os codespaces atuais de uma organização que foram criados por um usuário específico, use o comando a seguir.

Shell
gh codespace list --org ORGANIZATION --user USER

Observação: nos comandos acima, substitua ORGANIZATION pelo nome da organização que você está consultando. Você precisa ser proprietário da organização.

Usar a API REST para listar codespaces

Você pode usar o ponto de extremidade da API /orgs/{org}/codespaces como um método alternativo para listar os codespaces atuais de uma organização. Isso retorna mais informações que GitHub CLI; por exemplo, os detalhes do tipo de computador.

Para obter mais informações sobre esse ponto de extremidade, confira "Organizações de codespaces".