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 macchina virtuale (VM) per spostare la VM in una posizione diversa rispetto alle altre VM.
Rimuovere un criterio di posizionamento da una VM quando non sei più interessato alla sua posizione rispetto ad altre VM.
Elimina un criterio di posizionamento quando non ti serve più.
Prima di iniziare
- Consulta le limitazioni per i criteri di posizionamento.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
Select the tab for how you plan to use the samples on this page:
gcloud
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
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 Per esportare le proprietà di una VM esistente, 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 un criterio di posizionamento.FILE_PATH
: il percorso in cui vuoi salvare il file di configurazione della VM.ZONE
: la zona in cui si trova la VM.
In un editor di testo a tua scelta, apri il file di configurazione della VM.
Per sostituire il criterio di posizionamento con un altro criterio esistente, sostituisci il valore nel campo
resourcePolicies
con un altro criterio di posizionamento.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 il criterio di posizionamento.REGION
: la regione in cui si trova il criterio di posizionamento.POLICY_NAME
: il nome del criterio di posizionamento.
Puoi anche modificare altre proprietà della VM. Per ulteriori informazioni, consulta la sezione Proprietà che puoi aggiornare.
Segui i passaggi rimanenti in Aggiornare le proprietà della VM.
Per esportare le proprietà di una VM esistente, effettua una richiesta
GET
utilizzando il 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 un criterio di posizionamento.
La richiesta restituisce i dettagli di configurazione della VM.
Per sostituire il criterio di posizionamento con un altro criterio esistente, sostituisci il valore nel campo
resourcePolicies
con un altro criterio di posizionamento."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 il criterio di posizionamento.REGION
: la regione in cui si trova il criterio di posizionamento.POLICY_NAME
: il nome del criterio di posizionamento.
Puoi anche modificare altre proprietà della VM. Per ulteriori informazioni, consulta la sezione Proprietà che puoi aggiornare.
Segui i passaggi rimanenti in Aggiornare le proprietà della VM.
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 controlla 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.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.POLICY_NAME
: nome del criterio di posizionamento applicato alla VM. Per verificare il nome del criterio di posizionamento, visualizza i dettagli della VM e controlla il valore del camporesourcePolicies
.Se il criterio viene applicato solo alle VM e vuoi conservare le VM:
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:
(Facoltativo) Rimuovi il criterio di posizionamento da qualsiasi VM che vuoi conservare, come descritto in questo documento.
Elimina ogni altra risorsa Compute Engine a cui è applicato il criterio di posizionamento nel seguente ordine:
VM
Prenotazioni
Modelli di istanza
Elimina il criterio di posizionamento come descritto in questa sezione.
POLICY_NAME
: il nome di un criterio di posizionamento esistente.REGION
: la regione in cui si trova il criterio di posizionamento.PROJECT_ID
: l'ID del progetto in cui si trova il criterio di posizionamento.REGION
: la regione in cui si trova il criterio di posizionamento.POLICY_NAME
: il nome di un criterio di posizionamento esistente.Scopri come visualizzare i criteri di posizionamento.
Scopri come effettuare le seguenti 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, devi utilizzare le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per 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 le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per sostituire, rimuovere o eliminare i criteri di posizionamento sono necessarie le seguenti autorizzazioni:
Potresti anche essere in grado di 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 supportato e un criterio di manutenzione dell'host. Se devi aggiornare la VM prima di sostituire il relativo criterio di posizionamento, esegui una o entrambe le seguenti operazioni:
Dopo aver sostituito il criterio di posizionamento in una VM, è necessario riavviare la VM per applicare il criterio di posizionamento appena applicato.
Per sostituire un criterio di posizionamento in una VM, seleziona una delle seguenti opzioni:
gcloud
REST
Rimuovere 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 prima 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 viene sottoposta a migrazione in tempo reale, Compute Engine potrebbe spostarla in una posizione 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 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:
REST
Per rimuovere un criterio di posizionamento da una VM, effettua 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:
Elimina un criterio di posizionamento
Puoi eliminare un criterio di posizionamento solo se non è applicato ad alcuna risorsa di Compute Engine. In caso contrario, l'eliminazione del criterio di posizionamento non va a buon fine. Se vuoi eliminare un criterio di posizionamento applicato a una o più risorse Compute Engine, procedi in uno dei seguenti modi:
Per eliminare un criterio di posizionamento, seleziona una delle seguenti opzioni:
gcloud
Per eliminare un criterio di posizionamento, utilizza il 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, effettua una richiesta
DELETE
al metodoresourcePolicies.delete
.DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME
Sostituisci quanto segue:
Che cosa succede dopo?
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-06-14 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" }] -