Questo documento descrive come sostituire, rimuovere o eliminare i criteri di posizionamento.
Sostituzione, rimozione o eliminazione 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 alle altre VM.
Rimuovi un criterio di posizionamento da una VM quando non ti interessa più il suo rispetto alle altre VM.
Elimina un criterio di posizionamento quando non ti serve più.
Prima di iniziare
- Esamina il per i criteri di posizionamento.
-
Se non l'hai già fatto, configura l'autenticazione.
Autenticazione è
Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione
Compute Engine come segue.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
Per sostituire o rimuovere un criterio di posizionamento da una VM:
compute.instances.update
on the project -
Per eliminare un criterio di posizionamento:
compute.resourcePolicies.delete
on the project Creare un file YAML vuoto.
Per esportare le proprietà di una VM nel file YAML che hai appena creato, utilizza 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 un criterio di posizionamento.FILE_PATH
: il percorso del file YAML creato nel passaggio precedente.ZONE
: la zona in cui si trova la VM.
Nel file di configurazione YAML, modifica il valore dell'attributo
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 criterio di posizionamento. Puoi specificare solo un criterio di posizionamento nello stesso progetto della VM.REGION
: la regione in cui si trova il criterio di posizionamento individuarlo.POLICY_NAME
: il nome del criterio di posizionamento.
Per aggiornare la VM e riavviarla, utilizza 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 di configurazione modificati nel passaggio precedente.ZONE
: la zona in cui si trova la VM.
Crea un file JSON vuoto.
Per visualizzare le proprietà di una VM esistente, effettua una richiesta
GET
alla 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 individuarlo.ZONE
: la zona in cui si trova la VM.VM_NAME
: il nome di una VM esistente che specifica un criterio di posizionamento.
Nel file JSON vuoto creato nei passaggi precedenti, procedi come segue. seguenti:
Inserisci le proprietà della VM dall'output della richiesta
GET
.Individua il campo
resourcePolicies
e modificane il valore in 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 criterio di posizionamento. Puoi specificare solo un posizionamento che si trova nello stesso progetto della VM.REGION
: la regione in cui il criterio di posizionamento in cui viene localizzato.POLICY_NAME
: il nome del posizionamento .
Per aggiornare la VM e riavviarla, invia una richiesta
PUT
alla Metodoinstances.update
. Nella richiesta, segui questi passaggi:Nell'URL della richiesta, includi
most_disruptive_allowed_action
parametro di query impostato suRESTART
.Per il corpo della richiesta, utilizza i dettagli della 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" ], ... }
VM_NAME
: il nome di una VM esistente che specifica un criterio di posizionamento.POLICY_NAME
: nome del criterio di posizionamento applicato alla VM. Per verificare il nome del criterio di posizionamento, visualizza i dettagli della VM e verifica il valore del camporesourcePolicies
.ZONE
: la zona in cui si trova la VM.PROJECT_ID
: l'ID del progetto in cui si trova la VM individuarlo.ZONE
: la zona in cui si trova la VM.VM_NAME
: il nome di una VM esistente che specifica un criterio di posizionamento.REGION
: la regione in cui si trova il criterio di posizionamento individuarlo.POLICY_NAME
: nome del criterio di posizionamento applicato alla VM. Per verificare il nome del criterio di posizionamento, visualizza i dettagli della VM e verifica il valore del camporesourcePolicies
.Se il criterio viene applicato solo alle VM e vuoi conservarle, seguenti:
Rimuovi il criterio di posizionamento dalle VM come descritto in questo documento.
Elimina il criterio di posizionamento come descritto in questa sezione.
In caso contrario, procedi nel seguente modo:
(Facoltativo) Rimuovi il criterio di posizionamento da tutte le VM che vuoi mantenere come descritto in questo documento.
Elimina ogni altra risorsa Compute Engine nel posizionamento norma viene applicata nel seguente ordine:
VM
Prenotazioni
Modelli di istanza
Elimina il criterio di posizionamento come descritto in questa sezione.
POLICY_NAME
: il nome di un posizionamento esistente .REGION
: la regione in cui si trova il criterio di posizionamento individuarlo.PROJECT_ID
: l'ID del progetto in cui è stato inserito il posizionamento .REGION
: la regione in cui si trova il criterio di posizionamento individuarlo.POLICY_NAME
: il nome di un posizionamento esistente .Scopri come visualizza criteri di posizionamento.
Scopri come eseguire queste operazioni con una VM che specifica un criterio di posizionamento:
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.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Per ulteriori informazioni, vedi Esegui l'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 Ruolo IAM Amministratore istanze Compute (v1) (
roles/compute.instanceAdmin.v1
) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire 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 le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per sostituire, rimuovere o eliminare i criteri di posizionamento sono necessarie le seguenti autorizzazioni:
Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.
Sostituisci un criterio di posizionamento in una VM
Prima di sostituire un criterio di posizionamento distribuito in una VM con un posizionamento compatto assicurati che la VM utilizzi un criterio il tipo di macchina e i criteri di manutenzione dell'host supportati. Se devi aggiornare la VM prima di sostituire il criterio di posizionamento, esegui una o entrambe le seguenti opzioni:
Dopo aver sostituito il criterio di posizionamento in una VM, devi riavviare la VM per effettuare il criterio di posizionamento appena applicato.
Per sostituire un criterio di posizionamento in una VM, seleziona una delle seguenti opzioni:
gcloud
REST
Per saperne di più sull'aggiornamento delle proprietà di una VM, consulta Aggiorna le proprietà della VM.
Rimuovi un criterio di posizionamento da una VM
Se vuoi rimuovere un criterio di posizionamento distribuito con due o più disponibilità domini da una VM, puoi farlo senza arrestare la VM. Se vuoi per rimuovere un criterio di posizionamento compatto o un criterio di posizionamento distribuito con un solo la disponibilità del dominio, devi prima interrompere la VM prima rimuovendo 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 la migrazione in tempo reale, Compute Engine potrebbe spostarla località fisica diversa.
Per rimuovere un criterio di posizionamento da una VM, seleziona una delle seguenti opzioni:
gcloud
Per rimuovere un criterio di posizionamento da una VM, utilizza Comando
gcloud compute instances remove-resource-policies
.gcloud compute instances remove-resource-policies VM_NAME \ --resource-policies=POLICY_NAME \ --zone=ZONE
Sostituisci quanto segue:
REST
Per rimuovere un criterio di posizionamento da una VM, invia una richiesta
POST
alla 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:
Elimina un criterio di posizionamento
Puoi eliminare un criterio di posizionamento solo se non è applicato ad nessuno della risorsa Compute Engine. In caso contrario, l'eliminazione del criterio di posizionamento non riuscirà. Se vuoi eliminare un criterio di posizionamento applicato a uno o più per le risorse Compute Engine, quindi esegui una di queste operazioni:
Per eliminare un criterio di posizionamento, seleziona una delle seguenti opzioni:
gcloud
Per eliminare un criterio di posizionamento, utilizza la classe Comando
gcloud compute resource-policies delete
.gcloud compute resource-policies delete POLICY_NAME \ --region=REGION
Sostituisci quanto segue:
REST
Per eliminare un criterio di posizionamento, invia una richiesta
DELETE
a MetodoresourcePolicies.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Sostituisci quanto segue:
Passaggi successivi
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 2024-09-09 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -