Gerenciar o acesso às zonas de IA

Esta página explica como verificar se as zonas de IA estão ativadas para seu projeto Google Cloud e como ativar ou desativar essas zonas. As zonas de IA são especializadas e usadas para treinamento de inteligência artificial e machine learning (IA e ML) e cargas de trabalho de inferência. Para usar as zonas de IA, ative-as no seu projeto doGoogle Cloud . Isso ativa as zonas de IA para todos os serviços do Google Cloud.

Nesta página, explicamos como verificar se as zonas de IA estão ativadas para seu projeto Google Cloude como ativar ou desativar esse recurso.

Para saber mais sobre as zonas de IA, leia a documentação Zonas de IA.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. Com isso, você confirma sua identidade para acesso a serviços e APIs do Google Cloud . Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine selecionando uma das seguintes opções:

    Selecione a guia para como planeja usar as amostras nesta página:

    Console

    Quando você usa o console Google Cloud para acessar serviços Google Cloud e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  • Defina uma região e uma zona padrão.

    • REST

    Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para CLI gcloud.

      Instale a CLI do Google Cloud.

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

Funções exigidas

Para receber as permissões necessárias para ativar ou desativar zonas de IA, peça ao administrador para conceder a você o papel do IAM de Administrador do Compute (roles/compute.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Verificar se as zonas de IA estão ativadas em um projeto

Para verificar se as zonas de IA estão ativadas no seu projeto Google Cloud , confira se o recurso ai-zones-visibility (prévia) está ativado no seu projeto Google Cloud . Para novos projetos Google Cloud , as zonas de IA ficam desativadas por padrão.

CLI do Google Cloud

Use o comando gcloud compute preview-features list. A resposta indica se o recurso ai-zones-visibility está ativado ou desativado.

gcloud compute preview-features list --filter="name=ai-zones-visibility"

REST

Faça a seguinte solicitação GET ao método previewFeatures.list.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/previewFeatures/ai-zones-visibility

Substitua PROJECT_ID pelo ID do projeto.

Ativar zonas de IA

Para ter acesso às zonas de IA, ative-as no seu projeto Google Cloud .

CLI do Google Cloud

Use o comando gcloud compute preview-features, definindo o status de ativação como enabled e o plano de lançamento como fast-rollout.

gcloud compute preview-features update ai-zones-visibility \
    --activation-status=enabled \
    --rollout-plan=fast-rollout

REST

Faça a seguinte solicitação PATCH ao método previewFeatures.update. No corpo da solicitação, inclua estes campos:

  • O campo activation_status, definido como ENABLED.
  • O campo rollout_operation.predefined_rollout_plan definido como ROLLOUT_PLAN_FAST_ROLLOUT.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/previewFeatures/ai-zones-visibility
{
  "activation_status": "ENABLED",
  "rollout_operation": {
    "rollout_input": {
      "predefined_rollout_plan": "ROLLOUT_PLAN_FAST_ROLLOUT"
    }
  }
}

Substitua PROJECT_ID pelo ID do projeto.

Desativar zonas de IA

Para remover o acesso às zonas de IA, desative-as no seu projeto Google Cloud . Quando você desativa as zonas de IA, perde o acesso a todos os recursos implantados nelas.

CLI do Google Cloud

Use o comando gcloud compute preview-features, definindo o status de ativação como unspecified e o plano de lançamento como fast-rollout.

gcloud compute preview-features update ai-zones-visibility \
    --activation-status=unspecified \
    --rollout-plan=fast-rollout

REST

Faça a seguinte solicitação PATCH ao método previewFeatures.update. No corpo da solicitação, inclua estes campos:

  • O campo activation_status, definido como ACTIVATION_STATE_UNSPECIFIED.
  • O campo rollout_operation.predefined_rollout_plan definido como ROLLOUT_PLAN_FAST_ROLLOUT.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/previewFeatures/ai-zones-visibility
{
  "activation_status": "ACTIVATION_STATE_UNSPECIFIED",
  "rollout_operation": {
    "rollout_input": {
      "predefined_rollout_plan": "ROLLOUT_PLAN_FAST_ROLLOUT"
    }
  }
}

Substitua PROJECT_ID pelo ID do projeto.

A seguir