Questa pagina è stata tradotta dall'API Cloud Translation.

Pianificazione dell'avvio e dell'arresto di un'istanza VM

Le pianificazioni delle istanze consentono di avviare e arrestare le istanze di macchine virtuali (VM) automaticamente. L'uso delle pianificazioni delle istanze per automatizzare il deployment delle istanze VM può aiutarti a ottimizzare i costi e gestire le istanze VM in modo più efficiente. Puoi usare le pianificazioni delle istanze per carichi di lavoro ricorrenti e una tantum. Ad esempio, utilizza le pianificazioni delle istanze per eseguire le istanze VM solo durante l'orario di lavoro o per fornire capacità per un evento una tantum.

Per utilizzare le pianificazioni delle istanze, crea un criterio delle risorse che descriva in dettaglio il comportamento di avvio e arresto, quindi collega il criterio a una o più istanze VM.

Prima di iniziare

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.

Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
```
gcloud init
```
  Nota: se hai già installato gcloud CLI in precedenza, assicurati di disporre della versione più recente eseguendo gcloud components update.
2. Imposta una regione e una zona predefinite.
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.

Ruoli obbligatori

Per utilizzare le pianificazioni delle istanze, devi concedere i ruoli Identity and Access Management (IAM) richiesti alle seguenti entità:

L'agente di servizio Compute Engine per il tuo progetto. Questo è necessario per eseguire la pianificazione dell'istanza su una VM.

Se revochi queste autorizzazioni dopo aver creato le pianificazioni delle istanze, le pianificazioni delle istanze potrebbero smettere di funzionare senza preavviso. Per verificare se le pianificazioni delle istanze vengono eseguite correttamente, devi controllare regolarmente gli audit log.
L'account utente o l'account di servizio che crea, gestisce o utilizza la pianificazione dell'istanza.

Ruoli richiesti dall'agente di servizio Compute Engine

Per assicurarti che l'agente di servizio Compute Engine disponga delle autorizzazioni necessarie per eseguire la pianificazione delle istanze, chiedi all'amministratore di concedere all'agente di servizio Compute Engine il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eseguire la pianificazione delle istanze. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per eseguire la pianificazione delle istanze sono necessarie le seguenti autorizzazioni:

compute.instances.start
compute.instances.stop

L'amministratore potrebbe anche essere in grado di concedere all'agente di servizio Compute Engine queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Ruoli richiesti per l'account di servizio o utente

Per assicurarti che tu o il tuo account di servizio disponete delle autorizzazioni necessarie per creare e gestire le pianificazioni delle istanze, chiedi all'amministratore di concedere a te o al tuo account di servizio il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il tuo progetto o la tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le pianificazioni delle istanze. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare e gestire le pianificazioni delle istanze sono necessarie le seguenti autorizzazioni:

Crea una pianificazione dell'istanza: compute.resourcePolicies.create
Elenca una pianificazione dell'istanza: compute.resourcePolicies.list
Descrivi una pianificazione dell'istanza: compute.resourcePolicies.get
Elimina una pianificazione dell'istanza: compute.resourcePolicies.delete
Collega una pianificazione dell'istanza a una nuova VM:
- compute.instances.create
- compute.resourcePolicies.use
- compute.instances.addResourcePolicies
Collega una pianificazione delle istanze a una VM esistente:
- compute.resourcePolicies.use
- compute.instances.addResourcePolicies
Rimuovi una pianificazione dell'istanza da una VM:
- compute.resourcePolicies.use
- compute.instances.removeResourcePolicies

L'amministratore potrebbe anche essere in grado di concedere queste autorizzazioni a te o al tuo account di servizio con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Puoi collegare una pianificazione delle istanze solo alle istanze VM che si trovano nella stessa regione della pianificazione delle istanze.
Ogni istanza VM può seguire una sola pianificazione delle istanze, ma puoi collegare ogni pianificazione delle istanze a un massimo di 1000 istanze VM.
Le pianificazioni delle istanze non forniscono garanzie di capacità, quindi se le risorse necessarie per un'istanza VM pianificata non sono disponibili al momento pianificato, l'istanza VM potrebbe non essere avviata quando pianificata. Anche se puoi prenotare le istanze VM prima di avviarle per fornire garanzie di capacità, le prenotazioni non possono essere pianificate automaticamente.
Le istanze pianificano l'avvio e l'arresto delle istanze VM solo in orari specificati, ma possono essere avviati e arrestati manualmente in qualsiasi momento. Ad esempio, supponi di avere una pianificazione che inizia ogni giorno alle 8:00 e termina ogni giorno alle 17:00. Se colleghi la pianificazione a un'istanza VM arrestata alle 16:00, l'istanza VM verrà avviata solo alle 8:00 del giorno successivo, a meno che non avvii manualmente l'istanza VM prima di allora.
L'avvio o l'arresto dell'operazione delle istanze VM pianificate possono richiedere fino a 15 minuti oltre l'orario pianificato. Se hai bisogno che le istanze VM vengano avviate o arrestate a un orario specifico, pianifica l'operazione 15 minuti prima del necessario e pianifica ogni operazione a distanza di almeno 15 minuti.
Lo scheduler potrebbe non funzionare se è presente un divario inferiore a 15 minuti tra le operazioni di avvio e arresto. Questo perché l'operazione di arresto potrebbe avvenire prima dell'avvio, impedendone l'esecuzione.
Ogni pianificazione delle istanze consente di avere fino a un'operazione di avvio e fino a un'operazione di arresto all'ora.
Non puoi modificare le pianificazioni delle istanze. Per modificare la pianificazione di un'istanza esistente per una o più istanze VM, rimuovi ed elimina la pianificazione delle istanze esistente, quindi crea e collega una nuova pianificazione delle istanze.

Gestione delle pianificazioni delle istanze

Creare, elencare, descrivere ed eliminare le pianificazioni delle istanze utilizzando la console Google Cloud, Google Cloud CLI o l'API Compute Engine.

Creazione di una pianificazione dell'istanza

Crea una pianificazione delle istanze che descriva quando avviare o arrestare automaticamente le istanze VM. La pianificazione delle istanze che crei è un criterio delle risorse, che puoi utilizzare collegandolo o rimuovendolo dalle istanze VM.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina.

Nota: se non vedi questa opzione, crea prima un'istanza VM.
Fai clic su Crea pianificazione. Viene visualizzato il riquadro Crea una pianificazione.
Inserisci un Nome.
(Facoltativo) Inserisci una descrizione.
Nel menu a discesa Regione, seleziona la località per questa pianificazione dell'istanza.
Definisci l'avvio e l'arresto della pianificazione delle istanze per le istanze VM collegate. Se hai bisogno che le istanze VM vengano avviate o arrestate a un'ora specifica, pianifica l'operazione 15 minuti prima del necessario. Assicurati che l'operazione di avvio e di arresto avvenga a distanza di almeno 15 minuti.

Utilizza i campi predefiniti Ora di inizio, Ora di arresto e Frequenza oppure, se vuoi configurare una pianificazione più complessa, utilizza espressioni cron.
- Campi predefiniti:
  1. Inserisci un'ora di inizio, un'ora di interruzione o entrambe.
    - Nel campo Ora di inizio, digita o fai clic su per selezionare l'ora di avvio delle istanze VM.
    - Nel campo Ora di arresto, digita o fai clic su per selezionare l'ora di arresto delle istanze VM.
  2. Nel menu a discesa Frequenza nella parte inferiore del riquadro, seleziona la frequenza di ripetizione dell'Ora di inizio e dell'Ora di interruzione.
- Espressioni cron:
  1. Per abilitare le espressioni CRON, fai clic sul pulsante di attivazione/disattivazione Utilizza espressione CRON nella parte superiore del riquadro.
  2. Inserisci un'espressione CRON di avvio, un'espressione CRON di interruzione o entrambe.
    - Nel campo Avvia espressione CRON, inserisci un'espressione CRON che descrive quando avviare le istanze VM.
    - Nel campo Arresta espressione CRON, inserisci un'espressione CRON che descrive quando arrestare le istanze VM.
Nel menu a discesa Fuso orario, seleziona il fuso orario per l'Ora di inizio e l'Ora di interruzione.
(Facoltativo) Nel campo Data di avvio, digita o fai clic su per selezionare la data e l'ora di inizio della pianificazione dell'istanza. Se omessa, la pianificazione viene applicata immediatamente.
(Facoltativo) Nel campo Data di fine, digita o fai clic su per selezionare la data e l'ora di fine della pianificazione dell'istanza. Se omessa, la pianificazione viene applicata a tempo indeterminato.
Fai clic su Invia.

gcloud

Per creare una pianificazione delle istanze utilizzando gcloud CLI, utilizza il comando gcloud compute resource-policies create instance-schedule:

gcloud compute resource-policies create instance-schedule SCHEDULE_NAME \
    [--description='SCHEDULE_DESCRIPTION'] \
    [--region=REGION] \
    [--vm-start-schedule='START-OPERATION_SCHEDULE'] \
    [--vm-stop-schedule='STOP-OPERATION_SCHEDULE'] \
    [--timezone=TIME_ZONE] \
    [--initiation-date=INITIATION_DATE] \
    [--end-date=END_DATE]

Sostituisci quanto segue:

SCHEDULE_NAME: il nome della nuova pianificazione dell'istanza.
SCHEDULE_DESCRIPTION: facoltativo: una descrizione della nuova pianificazione dell'istanza.
REGION: facoltativo: la regione in cui si trovano le istanze VM che vuoi collegare a questa pianificazione delle istanze.
Specifica almeno una delle seguenti opzioni:
- START-OPERATION_SCHEDULE: una pianificazione che descrive quando vengono avviate le istanze VM collegate, formattata come espressione CRON. Se hai bisogno che le istanze VM vengano avviate a un orario specifico, pianifica l'operazione 15 minuti prima del necessario. Per maggiori informazioni, consulta la programmazione dell'avvio dell'operazione.
- STOP-OPERATION_SCHEDULE: una pianificazione che descrive quando le istanze VM collegate vengono arrestate, formattata come espressione CRON. Se vuoi che le istanze VM si arrestino in un momento specifico, pianifica l'operazione 15 minuti prima del necessario. Per maggiori informazioni, consulta la programmazione dell'arresto operativo.
TIME_ZONE: facoltativo: il fuso orario IANA basato sulla località per questa pianificazione dell'istanza. Se omesso, viene utilizzato il valore predefinito UTC. Per ulteriori informazioni, consulta la pagina relativa al fuso orario.
INITIATION_DATE: facoltativo: la prima data in cui viene applicata la pianificazione dell'istanza, con il formato di un timestamp RFC 3339. Se omessa, la pianificazione viene applicata immediatamente. Per ulteriori informazioni, consulta la sezione Data di avvio.
END_DATE: facoltativo: l'ultima data di validità della pianificazione dell'istanza, con il formato di un timestamp RFC 3339. Se omessa, la pianificazione viene applicata a tempo indeterminato. Per ulteriori informazioni, consulta la sezione sulla data di fine.

REST

Per creare una pianificazione delle istanze utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo resourcePolicies.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
  "name": "SCHEDULE_NAME",
  "description": "SCHEDULE_DESCRIPTION",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "START-OPERATION_SCHEDULE"
    },
    "vmStopSchedule": {
      "schedule": "STOP-OPERATION_SCHEDULE"
    },
    "timeZone": "TIME_ZONE",
    "startTime":"INITIATION_DATE",
    "expirationTime":"END_DATE"
  }
}

Sostituisci quanto segue:

PROJECT: il tuo ID progetto.
REGION: la regione in cui si trovano le istanze VM che vuoi collegare a questa pianificazione delle istanze.
SCHEDULE_NAME: il nome della nuova pianificazione dell'istanza.
SCHEDULE_DESCRIPTION: facoltativo: una descrizione della nuova pianificazione dell'istanza.
START-OPERATION_SCHEDULE o STOP-OPERATION_SCHEDULE: specifica almeno una delle seguenti opzioni:
- START-OPERATION_SCHEDULE: una pianificazione che descrive quando vengono avviate le istanze VM collegate, formattata come espressione CRON. Se hai bisogno che le istanze VM vengano avviate a un orario specifico, pianifica l'operazione 15 minuti prima del necessario. Per maggiori informazioni, consulta la programmazione dell'avvio dell'operazione.
- STOP-OPERATION_SCHEDULE: una pianificazione che descrive quando le istanze VM collegate vengono arrestate, formattata come espressione CRON. Se vuoi che le istanze VM si arrestino in un momento specifico, pianifica l'operazione 15 minuti prima del necessario. Per maggiori informazioni, consulta la programmazione dell'arresto operativo.
TIME_ZONE: il fuso orario IANA basato sulla località per la pianificazione di questa istanza. Per ulteriori informazioni, consulta la pagina relativa al fuso orario.
INITIATION_DATE: facoltativo: la prima data in cui viene applicata la pianificazione dell'istanza, con il formato di un timestamp RFC 3339. Se omessa, la pianificazione viene applicata immediatamente. Per ulteriori informazioni, consulta la sezione Data di avvio.
END_DATE: facoltativo: l'ultima data di validità della pianificazione dell'istanza, con il formato di un timestamp RFC 3339. Se omessa, la pianificazione viene applicata a tempo indeterminato. Per ulteriori informazioni, consulta la sezione sulla data di fine.

Ogni pianificazione dell'istanza ha le seguenti impostazioni:

pianificazione avvio operazione, pianificazione arresto operazione

Pianificazioni che descrivono l'avvio e l'arresto di eventuali istanze VM collegate. Una pianificazione delle istanze può avere una di queste pianificazioni o entrambe.

Quando crei pianificazioni delle istanze utilizzando la console Google Cloud, puoi selezionare Ora di inizio, Ora di arresto e Frequenza oppure formattare ogni pianificazione come espressione cron. Quando crei pianificazioni delle istanze utilizzando gcloud CLI o l'API Compute Engine, devi formattare ogni pianificazione come espressione CRON.

La seguente tabella definisce i campi di un'espressione CRON e i valori supportati per ogni campo.

Minuto	Ora	Giorno del mese	Mese	Giorno della settimana
0-59	0-23	1-31 dove 29-31 sono validi solo per i mesi pertinenti	1-12	0-6 o `SUN-SAT` (domenica-sabato) dove 0=`SUN`, 1=`MON`, ... 6=`SAT`

Oltre a questi valori, ogni campo di un'espressione CRON può utilizzare anche i seguenti caratteri speciali.

Carattere speciale	Significato	Esempio
`*`	tutte	Se il campo Giorno del mese, Mese e Giorno della settimana sono tutti impostati su `*`, la pianificazione si ripete ogni giorno.
`-`	intervallo	Se il campo del giorno della settimana è impostato su `MON-FRI` (o `1-5`), la pianificazione si ripete ogni settimana dal lunedì al venerdì.
`,`	list	Se il campo del mese è impostato su `1-6,8-12`, la pianificazione si ripete ogni mese, tranne a luglio.

Quando scrivi un'espressione CRON, considera quanto segue:

Lo spazio vuoto viene utilizzato per separare i campi di un'espressione CRON. Ricorda di non aggiungere spazi vuoti aggiuntivi in un campo che utilizza caratteri speciali.
Quando specifichi sia un giorno della settimana sia un giorno del mese (quando nessuno dei due campi è impostato su *), la pianificazione utilizza l'unione di questi valori, non l'intersezione. Ad esempio, la pianificazione 0 8 1 * MON inizia alle 8:00 di ogni lunedì e il primo giorno di ogni mese. La programmazione non inizia alle 08:00 solo di lunedì, che è anche il primo giorno del mese.

fuso orario

Il fuso orario IANA basato sulla posizione per la programmazione dell'avvio e dell'arresto. Il database dei fusi orari IANA definisce un elenco di valori disponibili. Questo fuso orario viene utilizzato come riferimento solo per le pianificazioni di avvio e arresto dell'operazione e non viene utilizzato per le date di avvio e di fine. Il fuso orario è facoltativo quando si utilizza gcloud CLI o l'API Compute Engine. Se omesso, viene utilizzato il valore predefinito UTC.

Alcuni fusi orari IANA rispettano l'ora legale (DST), che può influire sulle pianificazioni delle istanze. I dettagli dell'ora legale, come l'inizio e la fine dell'ora legale, e l'intervallo di tempo saltato e ripetuto, variano a seconda del fuso orario.

Nota: all'inizio e alla fine dell'ora legale, le pianificazioni delle istanze si comportano nel seguente modo:

Le operazioni pianificate durante il periodo in cui l'ora legale inizia, e l'ora viene saltata, vengono comunque eseguite, ma con un offset. Ad esempio, se un'operazione è pianificata per le 2:15, ma l'ora legale ignora le 2:00, l'operazione per quel giorno inizia alle 03:15. Questo periodo di tempo ignorato potrebbe causare un'esecuzione delle istanze VM per un tempo inferiore a quello che avrebbe altrimenti. Se l'orario ignorato fa sì che un'operazione di avvio e di arresto vengano programmate contemporaneamente, l'operazione di arresto ha la priorità e l'operazione di avvio viene ignorata.
Le operazioni pianificate durante il periodo in cui termina l'ora legale e l'orario ripetuto vengono eseguite alla prima occorrenza di quel momento. Questo periodo di tempo ripetuto potrebbe causare un'esecuzione delle istanze VM per un tempo maggiore di quello che sarebbe altrimenti.

data di inizio, data di fine

Il periodo di tempo in cui viene applicata la pianificazione dell'istanza. Entrambi i valori sono facoltativi. Le operazioni si ripetono ogni anno, a meno che non specifichi questi valori per limitare la pianificazione a un solo anno.

Quando crei pianificazioni delle istanze utilizzando la console Google Cloud, seleziona una data, un'ora e un fuso orario utilizzando i campi Data di avvio e Data di fine.

Quando crei pianificazioni delle istanze utilizzando gcloud CLI o l'API Compute Engine, questi valori sono formattati come timestamp RFC 3339:

  YYYY-MM-DDTHH:MM:SSOFFSET

Sostituisci quanto segue:

YYYY-MM-DD: una data formattata secondo il formato a 4 cifre, il mese a 2 cifre e il giorno del mese a 2 cifre separate da trattini.
HH:MM:SS: un'ora formattata come ora a due cifre con formato a 24 ore, minuti a due cifre e secondi a due cifre separati da due punti.
OFFSET: il fuso orario formattato come offset rispetto al fuso orario UTC (Coordinated Universal Time). Ad esempio, il fuso orario PST (Pacific Standard Time), che è 8 ore prima del fuso orario UTC, è scritto come -08:00. In alternativa, per non utilizzare offset (il fuso orario UTC), scrivi Z.

Elenco delle pianificazioni delle istanze

Elenca le pianificazioni delle istanze per visualizzare tutte le pianificazioni delle istanze esistenti per il tuo progetto.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina. Viene visualizzato un elenco di tutte le pianificazioni delle istanze per questo progetto.

gcloud

Per visualizzare un elenco di tutti i criteri delle risorse, incluse le pianificazioni delle istanze, utilizzando l'interfaccia a riga di comando gcloud, utilizza il comando gcloud compute resource-policies list. Se vuoi, per limitare i risultati a una regione specifica, includi il flag --filter.

gcloud compute resource-policies list \
    [--filter="region:(REGION)"]

Sostituisci quanto segue:

REGION: facoltativo: la regione in cui si trovano le pianificazioni dell'istanza che vuoi elencare.

REST

Per visualizzare un elenco di tutti i criteri delle risorse, incluse le pianificazioni delle istanze, in una regione specifica utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo resourcePolicies.list:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies

Sostituisci quanto segue:

PROJECT: il tuo ID progetto.
REGION: la regione in cui si trovano le pianificazioni dell'istanza che vuoi elencare.

Descrizione di una pianificazione delle istanze

Descrivere una pianificazione di un'istanza per visualizzarne la descrizione, i tempi, le operazioni e un elenco di tutte le istanze VM a cui è collegata.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina. Viene visualizzato un elenco di tutte le pianificazioni delle istanze per questo progetto.
Fai clic sul nome della pianificazione dell'istanza da descrivere. Viene visualizzata la pagina Dettagli pianificazioni istanza per quella pianificazione.

gcloud

Per descrivere una pianificazione delle istanze utilizzando gcloud CLI, utilizza il comando gcloud compute resource-policies describe:

gcloud compute resource-policies describe SCHEDULE_NAME \
    [--region=REGION]

Sostituisci quanto segue:

SCHEDULE_NAME: il nome della pianificazione dell'istanza da descrivere.
REGION: facoltativo: la regione in cui si trova la pianificazione delle istanze.

L'output è simile al seguente:

...
description: Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.
...
instanceSchedulePolicy:
 expirationTime: '2022-12-31T23:59:59Z'
 startTime: '2022-01-01T00:00:00Z'
 timeZone: UTC
 vmStartSchedule:
   schedule: 0 8 * * MON-FRI
 vmStopSchedule:
   schedule: 0 17 * * MON-FRI
...
name: example-instance-schedule
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-west1
resourceStatus:
 instanceSchedulePolicy:
   nextRunStartTime: '2022-01-03T08:00:00Z'
...
status: READY

REST

Per descrivere una pianificazione delle istanze utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo resourcePolicies.get:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME

Sostituisci quanto segue:

PROJECT: il tuo ID progetto.
REGION: la regione in cui si trova la pianificazione dell'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da descrivere.

L'output è simile al seguente:

{
  ...
  "description": "Every Monday to Friday in 2022, start VMs at 8 AM and stop VMs at 5 PM.",
  "name": "example-instance-schedule",
  "instanceSchedulePolicy": {
    "vmStartSchedule": {
      "schedule": "0 8 * * MON-FRI"
    },
    "vmStopSchedule": {
      "schedule": "0 17 * * MON-FRI"
    },
    "timeZone": "UTC",
    "startTime": "2022-01-01T00:00:00Z",
    "expirationTime": "2022-12-31T23:59:59Z"
  },
  "status": "READY",
  "resourceStatus": {
    "instanceSchedulePolicy": {
      "nextRunStartTime": "2022-01-03T08:00:00Z"
    }
  },
  ...
}

Eliminazione della pianificazione di un'istanza

Elimina una pianificazione delle istanze quando non ne hai più bisogno, rimuovendo eventuali istanze VM collegate ed eliminando il criterio delle risorse.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina. Viene visualizzato un elenco di tutte le pianificazioni delle istanze per questo progetto.
Seleziona le caselle di controllo relative alle pianificazioni delle istanze da eliminare.
Fai clic su Elimina nella parte superiore della pagina. Si apre una nuova finestra di dialogo per confermare l'azione.
Nella finestra di dialogo, fai clic su Elimina.

gcloud

Se questa pianificazione delle istanze è collegata a qualsiasi istanza VM, rimuovila.
1. Per verificare a quali istanze VM è collegata questa pianificazione, descrivi la pianificazione delle istanze.
2. Per ogni istanza VM a cui è collegata questa pianificazione, rimuovi la pianificazione dell'istanza.
Per eliminare una pianificazione delle istanze utilizzando gcloud CLI, utilizza il comando gcloud compute resource-policies delete:
```
gcloud compute resource-policies delete SCHEDULE_NAME \
   [--region=REGION]
```
Sostituisci quanto segue:
- SCHEDULE_NAME: il nome della pianificazione dell'istanza da eliminare.
- REGION: facoltativo: la regione in cui si trova la pianificazione delle istanze.

REST

Se questa pianificazione delle istanze è collegata a qualsiasi istanza VM, rimuovila.
1. Per verificare a quali istanze VM è collegata questa pianificazione, descrivi la pianificazione delle istanze.
2. Per ogni istanza VM a cui è collegata questa pianificazione, rimuovi la pianificazione dell'istanza.
Per eliminare una pianificazione delle istanze utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo resourcePolicies.delete:
```
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME
```
Sostituisci quanto segue:
- PROJECT: il tuo ID progetto.
- REGION: la regione in cui si trova la pianificazione delle istanze.
- SCHEDULE_NAME: il nome della pianificazione dell'istanza da eliminare.

Utilizzo delle pianificazioni delle istanze con le istanze VM

Per utilizzare una pianificazione delle istanze, collegala a una o più istanze VM che vuoi seguire. Puoi collegare una pianificazione delle istanze a un'istanza VM esistente o durante la creazione di una nuova istanza VM. Per impedire a un'istanza VM di seguire la pianificazione di un'istanza collegata, rimuovi la pianificazione da quell'istanza VM.

Collegamento di una pianificazione dell'istanza durante la creazione di una nuova istanza VM

Per collegare una pianificazione delle istanze a una nuova istanza VM, devi creare l'istanza VM nella stessa regione della pianificazione delle istanze che utilizzi. Scopri di più sulla creazione di un'istanza VM.

Console

Non puoi collegare una pianificazione delle istanze durante la creazione di un'istanza mediante la console Google Cloud. Per utilizzare la console Google Cloud per collegare una pianificazione delle istanze a una nuova istanza VM, crea un'istanza VM, quindi collega una pianificazione all'istanza VM.

gcloud

Per collegare una pianificazione delle istanze a un'istanza VM utilizzando gcloud CLI, utilizza il comando gcloud compute instances create con il flag --resource-policies. Ad esempio, per creare un'istanza VM da un'immagine pubblica con una pianificazione delle istanze collegata, utilizza il seguente comando:

gcloud compute instances create VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    [--zone=ZONE] \
    [--image IMAGE | --image-family IMAGE_FAMILY] \
    [--image-project IMAGE_PROJECT]

Sostituisci quanto segue:

VM_NAME: il nome dell'istanza VM a cui vuoi collegare la pianificazione di un'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da collegare.
ZONE: facoltativo: la zona in cui si trova l'istanza VM.
(Facoltativo) Crea un'istanza VM da un'immagine pubblica:
- IMAGE o IMAGE_FAMILY: specifica una delle seguenti opzioni:
- IMAGE: la versione richiesta di un'immagine pubblica. Ad esempio, --image debian-10-buster-v20200309.
- IMAGE_FAMILY: una famiglia di immagini. Viene creata la VM dall'immagine del sistema operativo più recente non deprecata. Ad esempio, se specifichi --image-family debian-10, Compute Engine crea una VM dall'ultima versione dell'immagine sistema operativo nella famiglia di immagini Debian 10.
- IMAGE_PROJECT: il progetto contenente l'immagine.

REST

Per collegare una pianificazione delle istanze a un'istanza VM utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo instances.insert e includi l'attributo resourcePolicies. Ad esempio, per creare un'istanza VM da un'immagine pubblica con una pianificazione di istanza collegata, effettua questa richiesta:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances
{
  "machineType": "zones/MACHINE_TYPE_ZONE/machineTypes/MACHINE_TYPE",
  "name": "VM_NAME",
  "disks": [
    {
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      },
      "boot": true
    }
  ],
  "resourcePolicies": [
    "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
  ]
}

Sostituisci quanto segue:

PROJECT_ID: l'ID del progetto in cui creare la VM.
ZONE: la zona in cui creare la VM.
MACHINE_TYPE_ZONE: la zona contenente il tipo di macchina da utilizzare per la nuova VM.
MACHINE_TYPE: il tipo di macchina, predefinita o personalizzata, per la nuova VM.
VM_NAME: il nome della nuova VM.
(Facoltativo) Crea un'istanza VM da un'immagine pubblica:
- IMAGE_PROJECT: il progetto contenente l'immagine. Ad esempio, se specifichi debian-10 come famiglia di immagini, specifica debian-cloud come progetto di immagini.
- IMAGE o IMAGE_FAMILY: specifica una delle seguenti opzioni:
- IMAGE: la versione richiesta di un'immagine pubblica. Ad esempio: "sourceImage": "projects/debian-cloud/global/images/debian-10-buster-v20200309"
- IMAGE_FAMILY: una famiglia di immagini. Viene creata la VM dall'immagine del sistema operativo più recente non deprecata. Ad esempio, se specifichi "sourceImage": "projects/debian-cloud/global/images/family/debian-10", Compute Engine crea una VM dall'ultima versione dell'immagine del sistema operativo nella famiglia di immagini Debian 10.
REGION: la regione in cui si trova la pianificazione dell'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da collegare.

Puoi verificare se la pianificazione delle istanze viene eseguita correttamente controllando gli audit log per il criterio delle risorse di pianificazione delle istanze e l'istanza VM collegata. Potresti dover attendere fino a 15 minuti dopo l'orario pianificato per ogni operazione.

Collegamento di una pianificazione delle istanze a un'istanza VM esistente

Puoi collegare una pianificazione delle istanze a qualsiasi istanza VM esistente che si trova nella stessa regione della pianificazione delle istanze.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina. Viene visualizzato un elenco di tutte le pianificazioni delle istanze per questo progetto.
Fai clic sul nome della pianificazione dell'istanza che vuoi collegare. Viene visualizzata la pagina Dettagli pianificazione istanza.
Fai clic su Aggiungi istanze alla pianificazione. Si apre il riquadro Aggiungi istanze alla pianificazione.
Seleziona la casella di controllo per ogni istanza VM a cui vuoi collegare questa pianificazione.
Fai clic su Aggiungi.

gcloud

Per collegare una pianificazione delle istanze a un'istanza VM utilizzando gcloud CLI, utilizza il comando gcloud compute instances add-resource-policies:

gcloud compute instances add-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    [--zone=ZONE]

Sostituisci quanto segue:

VM_NAME: il nome dell'istanza VM a cui vuoi collegare la pianificazione di un'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da collegare.
ZONE: facoltativo: la zona in cui si trova l'istanza VM.

REST

Per collegare una pianificazione delle istanze a un'istanza VM utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo instances.addResourcePolicies:

POST https://www.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/addResourcePolicies
{
  "resourcePolicies": "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Sostituisci quanto segue:

PROJECT: il tuo ID progetto.
ZONE: la zona in cui si trova l'istanza VM.
VM_NAME: il nome dell'istanza VM a cui vuoi collegare la pianificazione di un'istanza.
REGION: la regione in cui si trova la pianificazione dell'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da collegare.

Rimozione di una pianificazione delle istanze da un'istanza VM

Per impedire a un'istanza VM di seguire una pianificazione delle istanze, rimuovi la pianificazione delle istanze dall'istanza VM.

Console

Nella console Google Cloud, vai alla pagina Istanze VM.

Vai a Istanze VM
Fai clic sulla scheda Pianificazioni istanza nella parte superiore della pagina. Viene visualizzato un elenco di tutte le pianificazioni delle istanze per questo progetto.
Fai clic sul nome della pianificazione dell'istanza che vuoi rimuovere. Viene visualizzata la pagina Dettagli pianificazione istanza.
Nella sezione Istanze collegate, seleziona la casella di controllo in corrispondenza di ogni istanza VM che vuoi rimuovere da questa pianificazione.
Fai clic su Rimuovi istanze dalla pianificazione. Si apre una nuova finestra di dialogo per confermare l'azione.
Nella finestra di dialogo, fai clic su Rimuovi.

gcloud

Per rimuovere una pianificazione delle istanze da un'istanza VM utilizzando gcloud CLI, utilizza il comando gcloud compute instances remove-resource-policies:

gcloud compute instances remove-resource-policies VM_NAME \
    --resource-policies=SCHEDULE_NAME \
    [--zone=ZONE]

Sostituisci quanto segue:

VM_NAME: il nome dell'istanza VM da cui vuoi rimuovere la pianificazione delle istanze.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da rimuovere.
ZONE: facoltativo: la zona in cui si trova l'istanza VM.

REST

Per rimuovere una pianificazione delle istanze da un'istanza VM utilizzando l'API Compute Engine, effettua una richiesta utilizzando il metodo instances.removeResourcePolicies:

POST https://www.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instances/VM_NAME/removeResourcePolicies
{
  "resourcePolicies": "https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/SCHEDULE_NAME"
}

Sostituisci quanto segue:

PROJECT: il tuo ID progetto.
ZONE: la zona in cui si trova l'istanza VM.
VM_NAME: il nome dell'istanza VM da cui vuoi rimuovere la pianificazione delle istanze.
REGION: la regione in cui si trova la pianificazione dell'istanza.
SCHEDULE_NAME: il nome della pianificazione dell'istanza da rimuovere.

Passaggi successivi

Scopri di più su come avviare e arrestare manualmente un'istanza VM.
Scopri altre funzionalità di Compute Engine per la pianificazione delle VM: