Gerenciando Sandboxes

Exibindo Sandboxes na Console

1. Abra o serviço Generative AI, selecione Projects e selecione seu projeto.
2. Selecione a guia Caixa de Areia para exibir ativação, configurações de rede e a lista de sandbox. Você também pode usar Sandboxes na navegação do Projects.
3. Selecione um nome de sandbox para abrir seus detalhes.

Os detalhes incluem a forma, o ID do sandbox, o ID do projeto, o tempo de execução, o estado, os timestamps e as portas publicadas. A página também mostra informações de expiração e tempo de execução. Use a guia Monitoramento para métricas de recurso e comando.

Um ID de sandbox identifica um espaço de trabalho de execução. Ele é distinto do OCID do projeto. Consulte Monitorando Sandboxes.

Preparando Variáveis da CLI

Os seguintes comandos usam autenticação de sessão do OCI:

profile_name="DEFAULT"
region="us-chicago-1"
sandbox_id="SANDBOX_ID"

Listar sandboxes em um projeto:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox list \
  --project-id "PROJECT_OCID"

Obter uma sandbox:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox get \
  --sandbox-id "$sandbox_id"

Atualizando o Nome de Exibição

Altere o nome de exibição com o comando update:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox update \
  --sandbox-id "$sandbox_id" \
  --display-name my-sandbox-updated

Estendendo um Sandbox em Execução

Antes de o sandbox expirar, abra sua página de detalhes e selecione Ações e Estender. Use os controles de duração disponíveis para adicionar horas. A ação pode estar indisponível para uma sandbox interrompida.

Para adicionar 30 minutos com a CLI:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox extend \
  --sandbox-id "$sandbox_id" \
  --additional-duration PT30M

Verifique o tempo de expiração retornado. Estender o sandbox não altera o timeout dos comandos já em execução. Consulte Runtimes e Limites de Recursos do Sandbox.

Interrompendo um Sandbox

Faça download dos arquivos de saída necessários ou crie um instantâneo antes de interromper o sandbox. Na página de detalhes, selecione Ações, Interromper e conclua a confirmação.

Para solicitar uma interrupção com a CLI:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox stop \
  --sandbox-id "$sandbox_id" \
  --is-force false

Verifique o sandbox até que ele alcance STOPPED. A interrupção encerra a execução sem excluir o registro de sandbox. Para continuar com os arquivos salvos, crie um novo sandbox com base em um instantâneo e inicie os processos necessários novamente.

Excluindo um Sandbox

Quando o sandbox não for mais necessário, selecione Excluir em sua página de detalhes e conclua a confirmação. Faça download dos arquivos necessários ou salve um instantâneo primeiro.

Com a CLI:

oci --profile "$profile_name" --auth security_token --region "$region" \
  generative-ai-sandbox sandbox delete \
  --sandbox-id "$sandbox_id"

Revise e confirme o prompt de exclusão de CLI.