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 ad 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 di verifica dell'identità per poter accedere a Trusted Cloud by S3NS servizi e 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
-
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
- Set a default region and zone.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il seguente comando:
gcloud init
Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Trusted Cloud .
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per sostituire, rimuovere o eliminare le policy 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 le policy di posizionamento. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per sostituire, rimuovere o eliminare le policy di posizionamento sono necessarie le seguenti autorizzazioni:
-
Per sostituire o rimuovere una policy di posizionamento da una VM:
compute.instances.update
on the project -
Per eliminare una policy di posizionamento:
compute.resourcePolicies.delete
on the project
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 sostituirne la policy di posizionamento, esegui una o entrambe le seguenti operazioni:
Dopo aver sostituito la policy di posizionamento in una VM, devi riavviarla affinché la policy di posizionamento appena applicata diventi effettiva.
Per sostituire una policy di posizionamento in una VM, seleziona una delle seguenti opzioni:
gcloud
Crea un file YAML vuoto.
Per esportare le proprietà di una VM nel file YAML appena creato, utilizza il comando
gcloud compute instances export
.gcloud compute instances export VM_NAME \ --destination=FILE_PATH \ --zone=ZONE
Sostituisci quanto segue:
VM_NAME
: il nome di una VM esistente che specifica una policy di posizionamento.FILE_PATH
: il percorso del file YAML che hai creato nel passaggio precedente.ZONE
: la zona in cui si trova la VM.
Nel file di configurazione YAML, modifica il valore del campo
resourcePolicies
per specificare un criterio di posizionamento diverso.resourcePolicies: - https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la policy di posizionamento. Puoi specificare solo una policy di posizionamento che si trova nello stesso progetto della VM.REGION
: la regione in cui si trova la policy di posizionamento.POLICY_NAME
: il nome della policy di posizionamento.
Per aggiornare la VM e riavviarla, utilizza il comando
gcloud compute instances update-from-file
con il flag--most-disruptive-allowed-action
impostato suRESTART
.gcloud compute instances update-from-file VM_NAME \ --most-disruptive-allowed-action=RESTART \ --source=YAML_FILE \ --zone=ZONE
Sostituisci quanto segue:
VM_NAME
: il nome della VM.YAML_FILE
: il percorso del file YAML con i dati di configurazione modificati nel passaggio precedenteZONE
: la zona in cui si trova la VM.
REST
Crea un file JSON vuoto.
Per visualizzare le proprietà di una VM esistente, invia una richiesta
GET
al metodoinstances.get
.GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la VM.ZONE
: la zona in cui si trova la VM.VM_NAME
: il nome di una VM esistente che specifica una policy di posizionamento.
Nel file JSON vuoto che hai creato nei passaggi precedenti, procedi in questo modo:
Inserisci le proprietà della VM dall'output della richiesta
GET
.Individua il campo
resourcePolicies
e modifica il valore per specificare un criterio di posizionamento diverso."resourcePolicies": [ "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ]
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la policy di posizionamento. Puoi specificare solo una policy di posizionamento che si trova nello stesso progetto della VM.REGION
: la regione in cui si trova la policy di posizionamento.POLICY_NAME
: il nome della policy di posizionamento.
Per aggiornare la VM e riavviarla, invia una richiesta
PUT
al metodoinstances.update
. Nella richiesta, segui questi passaggi:Nell'URL della richiesta, includi il parametro di query
most_disruptive_allowed_action
impostato suRESTART
.Per il corpo della richiesta, utilizza i dettagli di configurazione della VM dal file JSON che hai creato e aggiornato nei passaggi precedenti.
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?most_disruptive_allowed_action=RESTART { ... "resourcePolicies": [ "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME" ], ... }
Per ulteriori informazioni sull'aggiornamento delle proprietà di una VM, consulta Aggiorna le proprietà delle VM.
Rimuovi una policy di posizionamento da una VM
Se vuoi rimuovere da una VM una policy di posizionamento distribuito con due o più domini di disponibilità, puoi farlo senza arrestare la VM. Se vuoi rimuovere una policy di posizionamento compatto o una policy di posizionamento distribuito 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 una policy di posizionamento da una VM, seleziona una delle seguenti opzioni:
gcloud
Per rimuovere una policy di posizionamento da una VM, utilizza il comando
gcloud compute instances remove-resource-policies
.gcloud compute instances remove-resource-policies VM_NAME \ --resource-policies=POLICY_NAME \ --zone=ZONE
Sostituisci quanto segue:
VM_NAME
: il nome di una VM esistente che specifica una policy di posizionamento.POLICY_NAME
: il nome della policy di posizionamento applicata alla VM. Per verificare il nome della policy di posizionamento, visualizza i dettagli della VM e controlla il valore del camporesourcePolicies
.ZONE
: la zona in cui si trova la VM.
REST
Per rimuovere una policy di posizionamento da una VM, invia una richiesta
POST
al metodoinstances.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" ] }
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la VM.ZONE
: la zona in cui si trova la VM.VM_NAME
: il nome di una VM esistente che specifica una policy di posizionamento.REGION
: la regione in cui si trova la policy di posizionamento.POLICY_NAME
: il nome della policy di posizionamento applicata alla VM. Per verificare il nome della policy di posizionamento, visualizza i dettagli della VM e controlla il valore del camporesourcePolicies
.
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 va a buon fine. Se vuoi eliminare una policy di posizionamento applicata a una o più risorse Compute Engine, esegui una delle seguenti operazioni:
Se la policy viene applicata solo alle VM e vuoi conservarle, procedi nel seguente modo:
Rimuovi la policy di posizionamento dalle VM come descritto in questo documento.
Elimina la policy di posizionamento come descritto in questa sezione.
In caso contrario, procedi come segue:
(Facoltativo) Rimuovi la policy di posizionamento da qualsiasi VM che vuoi conservare come descritto in questo documento.
Elimina ogni altra risorsa Compute Engine a cui viene applicata la policy di posizionamento nel seguente ordine:
VM
Prenotazioni
Modelli di istanza
Elimina la policy di posizionamento come descritto in questa sezione.
Per eliminare una policy di posizionamento, seleziona una delle seguenti opzioni:
gcloud
Per eliminare una policy di posizionamento, utilizza il comando
gcloud compute resource-policies delete
.gcloud compute resource-policies delete POLICY_NAME \ --region=REGION
Sostituisci quanto segue:
POLICY_NAME
: il nome di una policy di posizionamento esistente.REGION
: la regione in cui si trova la policy di posizionamento.
REST
Per eliminare una policy di posizionamento, invia una richiesta
DELETE
al metodoresourcePolicies.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Sostituisci quanto segue:
PROJECT_ID
: l'ID del progetto in cui si trova la policy di posizionamento.REGION
: la regione in cui si trova la policy di posizionamento.POLICY_NAME
: il nome di una policy di posizionamento esistente.
Passaggi successivi
Scopri come visualizzare le policy di posizionamento.
Scopri come eseguire le seguenti operazioni con una VM che specifica una policy di posizionamento:
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-19 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-08-19 UTC."],[[["This guide details the procedures for replacing, removing, and deleting placement policies for virtual machines (VMs) in Google Cloud."],["Replacing a placement policy involves updating the VM's configuration file and then restarting it to implement the new policy."],["Removing a placement policy from a VM can be done without stopping the VM for certain spread policies, but other policies require the VM to be stopped first."],["Deleting a placement policy requires ensuring that it is not applied to any Compute Engine resources, which may involve first removing it from associated VMs, reservations, or instance templates."],["The document also describes the necessary authentication steps, required roles, and permissions to make these changes, along with gcloud and REST examples for each operation."]]],[]] -