Faça a gestão dos tempos de execução

Esta página descreve como gerir um tempo de execução do Colab Enterprise, incluindo as seguintes tarefas:

  • Inicie um tempo de execução.
  • Pare um tempo de execução.
  • Desligue-se de um tempo de execução.
  • Volte a ligar-se a um tempo de execução.
  • Altere o tempo de execução ao qual está ligado.
  • Elimine um tempo de execução.

Funções necessárias

Para receber as autorizações de que precisa para gerir um tempo de execução do Colab Enterprise, peça ao seu administrador para lhe conceder a função de IAM Utilizador do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Inicie um tempo de execução

Para iniciar um tempo de execução, pode usar a Google Cloud consola, a CLI gcloud ou a API REST.

Consola

Para iniciar um tempo de execução:

  1. Na Google Cloud consola, aceda à página Ambientes de execução do Colab Enterprise.

    Aceda a Runtimes

  2. No menu Região, selecione a região que contém o seu tempo de execução.

  3. Selecione o tempo de execução que quer iniciar.

  4. Clique em Iniciar.

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • RUNTIME_ID: o ID do seu ambiente de execução.
  • PROJECT_ID: o ID do seu projeto.
  • REGION: a região onde o seu tempo de execução está localizado.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para mais informações sobre o comando para criar um modelo de tempo de execução a partir da linha de comandos, consulte a documentação da CLI gcloud.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGION: a região onde o seu tempo de execução está localizado.
  • PROJECT_ID: o ID do seu projeto.
  • RUNTIME_ID: o ID do seu ambiente de execução.

Método HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Para enviar o seu pedido, escolha uma destas opções:

curl

Execute o seguinte comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Para mais informações, consulte a notebookRuntimes.start documentação da API REST.

Pare um tempo de execução

Para parar um tempo de execução, pode usar a CLI gcloud ou a API REST.

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • RUNTIME_ID: o ID do seu ambiente de execução.
  • PROJECT_ID: o ID do seu projeto.
  • REGION: a região onde o seu tempo de execução está localizado.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud colab runtimes stop RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes stop RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes stop RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para mais informações sobre o comando para parar um tempo de execução a partir da linha de comandos, consulte a documentação da CLI gcloud.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGION: a região onde o seu tempo de execução está localizado.
  • PROJECT_ID: o ID do seu projeto.
  • RUNTIME_ID: o ID do seu ambiente de execução.

Método HTTP e URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Para enviar o seu pedido, escolha uma destas opções:

curl

Execute o seguinte comando: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Para mais informações, consulte a notebookRuntimes.stop documentação da API REST.

Desligue-se de um tempo de execução

Para desassociar de um tempo de execução:

  1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

    Aceda a Os meus notebooks

  2. No menu Região, selecione a região que contém o seu bloco de notas.

  3. Abra o bloco de notas que quer desassociar do tempo de execução.

  4. Na barra de ferramentas do cabeçalho, clique em Tempo de execução > Gerir sessões. Se não vir a barra de ferramentas do cabeçalho, clique em  Ativar/desativar visibilidade de cabeçalho.

  5. No painel Sessões ativas, clique no botão  Terminar sessão.

  6. Clique em Terminar.

Volte a ligar a um tempo de execução

Para voltar a ligar a um tempo de execução:

  1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

    Aceda a Os meus notebooks

  2. No menu Região, selecione a região que contém o seu bloco de notas.

  3. Abra um notebook que foi recentemente desligado de um tempo de execução.

  4. No canto superior direito do bloco de notas, clique em Voltar a ligar.

    Se o tempo de execução ao qual o bloco de notas estava anteriormente ligado ainda estiver em execução, o Colab Enterprise liga-se a ele. Se esse tempo de execução não estiver em execução, liga-se ao tempo de execução predefinido.

Altere o tempo de execução

Para alterar o tempo de execução ao qual tem ligação:

  1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

    Aceda a Os meus notebooks

  2. No menu Região, selecione a região que contém o seu bloco de notas.

  3. Abra um notebook que esteja ligado a um tempo de execução.

  4. No canto superior direito do bloco de notas, clique em  Opções de ligação adicionais > Alterar tipo de tempo de execução.

  5. Conclua a caixa de diálogo para ligar a um tempo de execução.

Elimine um tempo de execução

Para eliminar um tempo de execução, pode usar a Google Cloud consola, a CLI gcloud ou a API REST.

Consola

Para eliminar um tempo de execução:

  1. Na Google Cloud consola, aceda à página Ambientes de execução do Colab Enterprise.

    Aceda a Runtimes

  2. No menu Região, selecione a região que contém o seu tempo de execução.

  3. Selecione o tempo de execução que quer eliminar.

  4. Clique em  Eliminar.

  5. Clique em Confirm.

gcloud

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • RUNTIME_ID: o ID do seu ambiente de execução.
  • PROJECT_ID: o ID do seu projeto.
  • REGION: a região onde o seu tempo de execução está localizado.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Para mais informações sobre o comando para criar um modelo de tempo de execução a partir da linha de comandos, consulte a documentação da CLI gcloud.

REST

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

  • REGION: a região onde o seu tempo de execução está localizado.
  • PROJECT_ID: o ID do seu projeto.
  • RUNTIME_ID: o ID do seu ambiente de execução.

Método HTTP e URL: 

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Para enviar o seu pedido, escolha uma destas opções:

curl

Execute o seguinte comando: 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Execute o seguinte comando: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Para mais informações, consulte a notebookRuntimes.delete documentação da API REST.

O que se segue?