Sostituisci, rimuovi o elimina i criteri di posizionamento

Questo documento descrive come sostituire, rimuovere o eliminare i criteri di posizionamento.

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

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

• Rimuovi un criterio di posizionamento da una VM se non ti interessa più la sua posizione rispetto ad altre VM.

• Elimina un criterio di posizionamento quando non ti serve più.

Prima di iniziare

• Consulta le limitazioni relative ai criteri di posizionamento.
• Se non l'hai già fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in Compute Engine come segue.
  

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

  gcloud

  1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

     gcloud init

  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.

  Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

  gcloud init

  Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per sostituire, rimuovere o eliminare i criteri di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

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

Sostituisci un criterio di posizionamento in una VM

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

• Modifica il criterio di manutenzione dell'host della VM.

• Cambia il tipo di macchina della VM.

Dopo aver sostituito il criterio di posizionamento in una VM, devi riavviare la VM per rendere effettivo il criterio di posizionamento appena applicato.

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

Rimuovi un criterio di posizionamento da una VM

Se vuoi rimuovere da una VM un criterio di posizionamento distribuito con due o più domini di disponibilità, puoi farlo senza arrestare la VM. Se vuoi rimuovere un criterio di posizionamento compatto o un criterio di posizionamento distribuito con un solo dominio di disponibilità, devi arrestare la VM prima di rimuovere il criterio di posizionamento associato.

La rimozione di un criterio di posizionamento da una VM non influisce sulla sua posizione fisica. Tuttavia, se la VM esegue una migrazione in tempo reale, Compute Engine potrebbe spostarla in un'altra posizione fisica.

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 un criterio di posizionamento

Puoi eliminare un criterio di posizionamento solo se non è applicato ad nessuna risorsa Compute Engine. In caso contrario, l'eliminazione del criterio di posizionamento non riuscirà. Se vuoi eliminare un criterio di posizionamento applicato a una o più risorse Compute Engine, procedi in uno dei seguenti modi:

• Se il criterio viene applicato solo alle VM e vuoi mantenerle, procedi nel seguente modo:

  1. Rimuovi il criterio di posizionamento dalle VM come descritto in questo documento.

  2. Elimina il criterio di posizionamento come descritto in questa sezione.

• In caso contrario, procedi nel seguente modo:

  1. (Facoltativo) Rimuovi il criterio di posizionamento da tutte le VM che vuoi conservare, come descritto in questo documento.

  2. Elimina ogni altra risorsa Compute Engine a cui viene applicato il criterio di posizionamento nel seguente ordine:

     1. VM

     2. Prenotazioni

     3. Modelli di istanza

  3. Elimina il criterio 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

Che cosa succede dopo?

• Scopri come visualizzare i criteri di posizionamento.

• Scopri come eseguire queste operazioni con una VM che specifica un criterio di posizionamento:

  • Visualizza lo stato della VM.

  • Connettiti alla VM.