Este documento explica como gerenciar as políticas de posicionamento. Especificamente:
Atualize as propriedades de uma instância de máquina virtual (VM) que especifica uma política de posicionamento para executar um dos seguintes procedimentos:
Substitua a política de posicionamento por outra existente.
Remova a política.
Exclua uma política de posicionamento de que você não precisa mais.
Antes de começar
- Analise as restrições das políticas de posicionamento.
Funções exigidas
Para receber as permissões necessárias para substituir, remover ou excluir políticas de posicionamento,
peça ao administrador para conceder a você
Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1
) papel do IAM no projeto.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Esse papel predefinido contém as permissões necessárias para substituir, remover ou excluir políticas de posicionamento. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para substituir, remover ou excluir políticas de posicionamento:
-
Para atualizar as propriedades de uma VM:
compute.instances.update
no projeto -
Para excluir uma política de posicionamento:
compute.resourcePolicies.delete
no projeto
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Para exportar as propriedades de uma VM atual, use o comando
gcloud compute instances export
.gcloud compute instances export VM_NAME \ --destination=FILE_PATH \ --project=PROJECT_ID \ --zone=ZONE
Substitua:
VM_NAME
: o nome de uma VM atual que especifica uma política de posicionamento.FILE_PATH
: o caminho em que você quer salvar o arquivo de configuração da VM.PROJECT_ID
: o ID do projeto em que a política de posicionamento e a VM estão localizadas.ZONE
: é a zona em que a VM está localizada
Em um editor de texto de sua escolha, abra o arquivo de configuração da VM.
Para substituir a política de posicionamento por outra, substitua o valor no campo
resourcePolicies
por outra.... resourcePolicies: - https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy ...
Também é possível modificar outras propriedades da VM. Para mais informações, consulte Propriedades que podem ser atualizadas.
Siga as etapas restantes em Atualizar propriedades da VM.
Para exportar as propriedades de uma VM atual, faça uma solicitação
GET
para o métodoinstances.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
Substitua:
PROJECT_ID
: o ID do projeto em que a VM está localizada.ZONE
: é a zona em que a VM está localizadaVM_NAME
: o nome de uma VM atual que especifica uma política de posicionamento.
Para substituir a política de posicionamento por outra, substitua o valor no campo
resourcePolicies
por outra.{ ... "resourcePolicies": [ "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/another-example-policy" ], ... }
Também é possível modificar outras propriedades da VM. Para mais informações, consulte Propriedades que podem ser atualizadas.
Siga as etapas restantes em Atualizar propriedades da VM.
VM_NAME
: o nome de uma VM atual que especifica uma política de posicionamento.PROJECT_ID
: o ID do projeto em que a VM e a política de posicionamento aplicada a ela estão localizadas.POLICY_NAME
: o nome da política de posicionamento aplicada à VM. Para verificar o nome da política de posicionamento, visualize os detalhes da VM e veja o camporesourcePolicies
.ZONE
: a zona em que a VM está localizada.PROJECT_ID
: o ID do projeto em que a VM e a política de posicionamento aplicada a ela estão localizadas.ZONE
: é a zona em que a VM está localizadaVM_NAME
: o nome de uma VM atual que especifica uma política de posicionamento.REGION
: a região em que a política de posicionamento está localizada.POLICY_NAME
: o nome da política de posicionamento aplicada à VM. Para verificar o nome da política de posicionamento, visualize os detalhes da VM e veja o camporesourcePolicies
.Se a política for aplicada apenas às VMs e você quiser mantê-las, faça o seguinte:
Exclua a política de posicionamento.
Caso contrário, faça o seguinte:
Opcional: remova a política de posicionamento de qualquer VM que queira manter.
Exclua todos os outros recursos do Compute Engine aos quais a política de posicionamento é aplicada na seguinte ordem:
VMs
Reservas
Modelos de instância
Exclua a política de posicionamento.
POLICY_NAME
: o nome de uma política de posicionamento existente.PROJECT_ID
: o ID do projeto em que a política de posicionamento está localizada.REGION
: a região em que a política de posicionamento está localizada.PROJECT_ID
: o ID do projeto em que a política de posicionamento está localizada.REGION
: a região em que a política de posicionamento está localizada.POLICY_NAME
: o nome de uma política de posicionamento existente.Saiba como consultar as políticas de posicionamento.
Aprenda a fazer o seguinte com uma VM que especifica uma política de posicionamento:
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Substituir uma política de posicionamento em uma VM:
É possível substituir a política de posicionamento especificada em uma VM por outra usando a CLI gcloud e a API Compute Engine.
gcloud
Para substituir uma política de posicionamento em uma VM por outra, siga estas etapas:
REST
Para substituir uma política de posicionamento em uma VM por outra, siga estas etapas:
Remover uma política de posicionamento de uma VM
É possível remover a política de posicionamento aplicada a uma VM usando a CLI gcloud e a API Compute Engine.
gcloud
Para remover uma política de posicionamento de uma VM, use o
comando gcloud compute instances remove-resource-policies
.
gcloud compute instances remove-resource-policies VM_NAME \
--project=PROJECT_ID \
--resource-policies=POLICY_NAME \
--zone=ZONE
Substitua:
REST
Para remover uma política de posicionamento de uma VM, faça uma solicitação POST
ao
método instances.removeResourcePolicies
.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
"resourcePolicies": [
"projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME"
]
}
Substitua:
Excluir uma política de posicionamento
Só é possível excluir uma política de posicionamento se ela não for aplicada a nenhum recurso do Compute Engine. Caso contrário, a exclusão da política de posicionamento falhará. Se você quiser excluir uma política de posicionamento aplicada a um recurso do Compute Engine, siga um destes procedimentos:
É possível excluir uma política de posicionamento usando a CLI gcloud e a API Compute Engine.
gcloud
Para excluir uma política de convidado, use o comando gcloud compute resource-policies delete
.
gcloud compute resource-policies delete POLICY_NAME \
--project=PROJECT_ID \
--region=REGION
Substitua:
REST
Para excluir uma política de posicionamento, faça uma solicitação DELETE
ao
método resourcePolicies.delete
.
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Substitua:
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-24 UTC.