Sostituire, rimuovere o eliminare le policy di posizionamento

Questo documento descrive come sostituire, rimuovere o eliminare le policy di posizionamento.

La sostituzione, la rimozione o l'eliminazione delle policy di posizionamento è utile nei seguenti casi:

• Sostituisci una policy di posizionamento in un'istanza di macchina virtuale (VM) per spostare la VM in una posizione diversa rispetto alle altre VM.

• Rimuovi una policy di posizionamento da una VM quando non ti interessa più la sua posizione rispetto alle altre VM.

• Elimina una policy di posizionamento quando non ti serve più.

Prima di iniziare

• Consulta le limitazioni per le norme sul posizionamento.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
  

  Select the tab for how you plan to use the samples on this page:

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per sostituire, rimuovere o eliminare le norme di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per sostituire, rimuovere o eliminare i criteri di posizionamento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Sostituisci una policy di posizionamento in una VM

Prima di sostituire una policy di posizionamento distribuito in una VM con una policy di posizionamento compatto, assicurati che la VM utilizzi un tipo di macchina e una policy di manutenzione dell'host supportati. Se devi aggiornare la VM prima di sostituire le relative norme di posizionamento, esegui una o entrambe le seguenti operazioni:

• Modifica la policy di manutenzione dell'host della VM.

• Modifica il tipo di macchina della VM.

Dopo aver sostituito la policy di posizionamento in una VM, devi riavviarla per rendere effettiva la policy di posizionamento appena applicata.

Per sostituire una policy di posizionamento in una VM, seleziona una delle seguenti opzioni:

Per ulteriori informazioni sull'aggiornamento delle proprietà di una VM, consulta Aggiorna le proprietà della VM.

Rimuovi una policy di posizionamento da una VM

Se vuoi rimuovere una policy di posizionamento spread con due o più domini di disponibilità da una VM, puoi farlo senza arrestare la VM. Se vuoi rimuovere una policy di posizionamento compatta o una policy di posizionamento distribuita con un solo dominio di disponibilità, devi prima arrestare la VM prima di rimuovere la policy di posizionamento collegata.

La rimozione di una policy di posizionamento da una VM non influisce sulla sua posizione fisica. Tuttavia, se la VM è in fase di migrazione live, Compute Engine potrebbe spostarla in una posizione fisica diversa.

Per rimuovere un criterio di posizionamento da una VM, seleziona una delle seguenti opzioni:

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=POLICY_NAME \
    --zone=ZONE

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"
  ]
}

Elimina una policy di posizionamento

Puoi eliminare una policy di posizionamento solo se non è applicata a nessuna risorsa Compute Engine. In caso contrario, l'eliminazione della policy di posizionamento non riesce. Se vuoi eliminare una norma di posizionamento applicata a una o più risorse Compute Engine, esegui una delle seguenti operazioni:

• Se la norma viene applicata solo alle VM e vuoi conservarle, procedi nel seguente modo:

  1. Rimuovi la policy di posizionamento dalle VM come descritto in questo documento.

  2. Elimina la policy di posizionamento come descritto in questa sezione.

• In caso contrario, procedi nel seguente modo:

  1. (Facoltativo) Rimuovi la policy di posizionamento da qualsiasi VM che vuoi conservare come descritto in questo documento.

  2. Elimina ogni altra risorsa Compute Engine a cui viene applicata la policy di posizionamento nel seguente ordine:

     1. VM

     2. Prenotazioni

     3. Modelli di istanza

  3. Elimina la policy di posizionamento come descritto in questa sezione.

Per eliminare un criterio di posizionamento, seleziona una delle seguenti opzioni:

gcloud compute resource-policies delete POLICY_NAME \
    --region=REGION

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Passaggi successivi

• Scopri come visualizzare le norme di posizionamento.

• Scopri come eseguire le seguenti operazioni con una VM che specifica una policy di posizionamento:

  • Visualizza lo stato della VM.

  • Connettiti alla VM.