Sostituire, rimuovere o eliminare le policy del workload

Questo documento spiega come sostituire, rimuovere o eliminare le policy dei workload dai gruppi di istanze gestite (MIG). Queste azioni sono utili nei seguenti scenari:

Sostituisci una policy del workload: puoi modificare la posizione delle istanze Compute Engine all'interno del tuo gruppo di istanze gestite o passare a una policy del workload diversa che si adatta meglio ai requisiti del tuo workload.
Rimuovi una policy del workload: puoi smettere di utilizzare regole di posizionamento specifiche se il tuo workload non ne ha più bisogno, ripristinando il comportamento di posizionamento predefinito delle istanze di Compute del MIG.
Elimina una policy del workload: puoi eliminare definitivamente le policy del workload di cui non hai più bisogno.

Per scoprire come creare una policy del workload, vedi Crea policy del workload per i MIG.

Limitazioni

Puoi sostituire o rimuovere una policy del workload da un MIG solo se non sono presenti istanze di Compute nel MIG.

Prima di iniziare

Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
Seleziona la scheda relativa a come intendi utilizzare i campioni in questa pagina:
gcloud
1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
  gcloud init
  Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
  
  Nota:se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
Imposta una regione e una zona predefinite.

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.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per sostituire, rimuovere o eliminare le policy dei carichi di lavoro, 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 dei carichi di lavoro. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per sostituire, rimuovere o eliminare le policy del workload sono necessarie le seguenti autorizzazioni:

Per sostituire o rimuovere una policy del workload da un MIG: compute.instances.update on the project
Per eliminare una policy del workload: compute.resourcePolicies.delete on the project

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

Sostituisci una policy del workload in un MIG

Per sostituire una policy del workload in un MIG con una policy del workload diversa ed esistente, seleziona una delle seguenti opzioni:

gcloud

Imposta manualmente le dimensioni del MIG su 0.
Per sostituire la policy del workload nel MIG, utilizza il comando gcloud compute instance-groups managed update con il flag --workload-policy. In base al tipo di MIG, includi uno dei seguenti flag:
- Per sostituire la policy del workload in un MIG a livello di zona, includi il flag --zone:
```
gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --zone=ZONE
```
- Per sostituire la policy del workload in un MIG regionale, includi il flag --region:
```
gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --region=REGION
```
Sostituisci quanto segue:
- MIG_NAME: il nome del MIG.
- WORKLOAD_POLICY: il nome del criterio del workload che vuoi applicare al tuo MIG.
- ZONE: la zona in cui esiste il gruppo di istanze gestite a livello di zona.
- REGION: la regione in cui esistono il MIG regionale e il criterio del workload.

REST

Imposta manualmente le dimensioni del MIG su 0.
Per sostituire la policy del workload nel MIG, invia una richiesta PATCH a uno dei seguenti metodi:
- Per sostituire la policy del workload in un MIG a livello di zona, invia una richiesta PATCH al metodo compute.instanceGroupManagers.patch:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}
```
- Per sostituire la policy del workload in un MIG a livello di regione, invia una richiesta PATCH al metodo compute.regionInstanceGroupManagers.patch:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": "projects/PROJECT_ID/regions/REGION/resourcePolicies/WORKLOAD_POLICY"
}
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto in cui esistono il MIG e la policy del workload.
- ZONE: la zona in cui esiste il gruppo di istanze gestite a livello di zona.
- REGION: la regione in cui esistono il MIG regionale e il criterio del workload.
- MIG_NAME: il nome del MIG.
- WORKLOAD_POLICY: il nome del criterio del workload che vuoi applicare al tuo MIG.

Rimuovi una policy del workload da un gruppo di istanze gestite

Per rimuovere una policy del workload da un MIG, seleziona una delle seguenti opzioni:

gcloud

Imposta manualmente le dimensioni del MIG su 0.
Per rimuovere una policy del workload da un MIG, utilizza il comando gcloud compute instance-groups managed update con il flag --remove-workload-policy. In base al tipo di MIG, includi uno dei seguenti flag:
- Per rimuovere una policy del workload da un gruppo di istanze gestite a livello di zona, includi il flag --zone:
```
gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --zone=ZONE
```
- Per rimuovere una policy del workload da un gruppo di istanze gestite regionale, includi il flag --region:
```
gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --region=REGION
```
Sostituisci quanto segue:
- MIG_NAME: il nome del MIG.
- WORKLOAD_POLICY: il nome del criterio del workload applicato al tuo MIG.
- ZONE: la zona in cui esiste il gruppo di istanze gestite a livello di zona.
- REGION: la regione in cui esiste il MIG regionale.

REST

Imposta manualmente le dimensioni del MIG su 0.
Per rimuovere una policy del workload da un MIG, invia una richiesta PATCH a uno dei seguenti metodi:
- Per rimuovere una policy del workload da un MIG a livello di zona, invia una richiesta al metodo compute.instanceGroupManagers.patch:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}
```
- Per rimuovere una policy del workload da un MIG a livello di regione, invia una richiesta al metodo compute.regionInstanceGroupManagers.patch:
```
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID del progetto in cui esistono il MIG e la policy del workload.
- ZONE: la zona in cui esiste il gruppo di istanze gestite a livello di zona.
- REGION: la regione in cui esistono il MIG regionale e il criterio del workload.
- MIG_NAME: il nome del MIG.

Elimina una policy del workload

Non puoi eliminare una policy del workload applicata a un MIG. Prima di eliminare la policy, devi rimuoverla dal MIG.

Per eliminare una policy del workload, seleziona una delle seguenti opzioni:

gcloud

Per eliminare una policy del workload, utilizza il comando gcloud compute resource-policies delete:

gcloud compute resource-policies delete WORKLOAD_POLICY \
    --region=REGION

Sostituisci quanto segue:

WORKLOAD_POLICY: il nome di una policy del workload esistente
REGION: la regione in cui esiste la policy del workload.

REST

Per eliminare una policy del workload, invia una richiesta DELETE al metodo resourcePolicies.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 esiste la policy del workload.
REGION: la regione in cui esiste la policy del workload.
POLICY_NAME: il nome di una policy del workload esistente

Passaggi successivi

Scopri come visualizzare le policy del workload.
Scopri come creare policy del workload per i MIG.

Sostituire, rimuovere o eliminare le policy del workload Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Limitazioni

Prima di iniziare

gcloud

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Sostituisci una policy del workload in un MIG

gcloud

REST

Rimuovi una policy del workload da un gruppo di istanze gestite

gcloud

REST

Elimina una policy del workload

gcloud

REST

Passaggi successivi

Sostituire, rimuovere o eliminare le policy del workload