Reemplaza, quita o borra políticas de cargas de trabajo

En este documento, se explica cómo reemplazar, quitar o borrar políticas de cargas de trabajo de grupos de instancias administrados (MIG). Estas acciones son útiles en las siguientes situaciones:

  • Reemplaza una política de carga de trabajo: Puedes cambiar la forma en que se ubican las instancias de Compute Engine dentro de tu MIG o cambiar a una política de carga de trabajo diferente que se adapte mejor a los requisitos de tu carga de trabajo.

  • Quita una política de carga de trabajo: Puedes dejar de usar reglas de posición específicas si tu carga de trabajo ya no las necesita, lo que revierte el MIG al comportamiento predeterminado de posición de instancias de procesamiento.

  • Borra una política de cargas de trabajo: Puedes borrar de forma permanente las políticas de cargas de trabajo que ya no necesites.

Para obtener información sobre cómo crear una política de cargas de trabajo, consulta Crea políticas de cargas de trabajo para MIG.

Limitaciones

Solo puedes reemplazar o quitar una política de cargas de trabajo de un MIG si no hay instancias de procesamiento en él.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

    • REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Roles obligatorios

Si deseas obtener los permisos que necesitas para reemplazar, quitar o borrar políticas de cargas de trabajo, pídele a tu administrador que te otorgue el rol de IAM Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para reemplazar, quitar o borrar políticas de cargas de trabajo. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para reemplazar, quitar o borrar las políticas de cargas de trabajo:

  • Para reemplazar o quitar una política de cargas de trabajo de un MIG, haz lo siguiente: compute.instances.update on the project
  • Para borrar una política de cargas de trabajo, haz lo siguiente: compute.resourcePolicies.delete on the project

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Reemplaza una política de cargas de trabajo en un MIG

Para reemplazar una política de carga de trabajo en un MIG por otra política de carga de trabajo existente y diferente, selecciona una de las siguientes opciones:

gcloud

  1. Establece manualmente el tamaño del MIG en 0.

  2. Para reemplazar la política de carga de trabajo en tu MIG, usa el comando gcloud compute instance-groups managed update con la marca --workload-policy. Según el tipo de MIG, incluye una de las siguientes marcas:

    • Para reemplazar la política de carga de trabajo en un MIG zonal, incluye la marca --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para reemplazar la política de carga de trabajo en un MIG regional, incluye la marca --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Reemplaza lo siguiente:

    • MIG_NAME: Es el nombre del MIG.

    • WORKLOAD_POLICY: Es el nombre de la política de cargas de trabajo que deseas aplicar a tu MIG.

    • ZONE: Es la zona en la que existe el MIG zonal.

    • REGION: Es la región en la que existen tu MIG regional y la política de carga de trabajo.

REST

  1. Establece manualmente el tamaño del MIG en 0.

  2. Para reemplazar la política de cargas de trabajo en tu MIG, realiza una solicitud PATCH a uno de los siguientes métodos:

    • Para reemplazar la política de carga de trabajo en un MIG zonal, realiza una solicitud PATCH al método 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"
}

    • Para reemplazar la política de carga de trabajo en un MIG regional, realiza una solicitud PATCH al método 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"
}

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que existen tu MIG y la política de carga de trabajo.

    • ZONE: Es la zona en la que existe el MIG zonal.

    • REGION: Es la región en la que existen tu MIG regional y la política de carga de trabajo.

    • MIG_NAME: Es el nombre de tu MIG.

    • WORKLOAD_POLICY: Es el nombre de la política de cargas de trabajo que deseas aplicar a tu MIG.

Quita una política de cargas de trabajo de un MIG

Para quitar una política de carga de trabajo de un MIG, selecciona una de las siguientes opciones:

gcloud

  1. Establece manualmente el tamaño del MIG en 0.

  2. Para quitar una política de carga de trabajo de un MIG, usa el comando gcloud compute instance-groups managed update con la marca --remove-workload-policy. Según el tipo de MIG, incluye una de las siguientes marcas:

    • Para quitar una política de carga de trabajo de un MIG zonal, incluye la marca --zone:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --zone=ZONE

    • Para quitar una política de carga de trabajo de un MIG regional, incluye la marca --region:

      gcloud compute instance-groups managed update MIG_NAME \
    --remove-workload-policy=WORKLOAD_POLICY \
    --region=REGION

    Reemplaza lo siguiente:

    • MIG_NAME: Es el nombre de tu MIG.

    • WORKLOAD_POLICY: Es el nombre de la política de cargas de trabajo que se aplica a tu MIG.

    • ZONE: Es la zona en la que existe el MIG zonal.

    • REGION: Es la región en la que existe tu MIG regional.

REST

  1. Establece manualmente el tamaño del MIG en 0.

  2. Para quitar una política de carga de trabajo de un MIG, realiza una solicitud PATCH a uno de los siguientes métodos:

    • Para quitar una política de cargas de trabajo de un MIG zonal, realiza una solicitud al método compute.instanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    • Para quitar una política de cargas de trabajo de un MIG regional, realiza una solicitud al método compute.regionInstanceGroupManagers.patch:

      PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/MIG_NAME

{
  "workloadPolicy": ""
}

    Reemplaza lo siguiente:

    • PROJECT_ID: Es el ID del proyecto en el que existen tu MIG y la política de carga de trabajo.

    • ZONE: Es la zona en la que existe el MIG zonal.

    • REGION: Es la región en la que existen tu MIG regional y la política de carga de trabajo.

    • MIG_NAME: Es el nombre de tu MIG.

Borra una política de cargas de trabajo

No puedes borrar una política de cargas de trabajo que se aplique a un MIG. Antes de borrar la política, debes quitarla de la MIG.

Para borrar una política de carga de trabajo, selecciona una de las siguientes opciones:

gcloud

Para borrar una política de carga de trabajo, usa el comando gcloud compute resource-policies delete:

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

Reemplaza lo siguiente:

  • WORKLOAD_POLICY: Es el nombre de una política de carga de trabajo existente.

  • REGION: Es la región en la que existe la política de carga de trabajo.

REST

Para borrar una política de carga de trabajo, realiza una solicitud DELETE al método resourcePolicies.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto en el que existe la política de carga de trabajo.

  • REGION: Es la región en la que existe la política de carga de trabajo.

  • POLICY_NAME: Es el nombre de una política de carga de trabajo existente.

¿Qué sigue?