Ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG

Este documento describe cómo hacer lo siguiente después de crear una solicitud de cambio de tamaño en un grupo de instancias administrado (MIG):

Después de crear solicitudes de cambio de tamaño en un MIG, puede realizar una o más de las siguientes acciones:

  • Vea solicitudes de cambio de tamaño para monitorear sus estados o solucionar problemas.

  • Cancele las solicitudes de cambio de tamaño para evitar que MIG cree la cantidad solicitada de instancias de máquina virtual (VM).

  • Elimine las solicitudes de cambio de tamaño cuando ya no las necesite.

Antes de comenzar

  • Si aún no lo ha hecho, vea cómo funcionan las solicitudes de cambio de tamaño .
  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

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

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Roles requeridos

Para obtener los permisos que necesita para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG, solicite a su administrador que le otorgue el rol de IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene los permisos necesarios para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para ver, cancelar o eliminar solicitudes de cambio de tamaño en un MIG:

  • Para cancelar o eliminar solicitudes de cambio de tamaño en un MIG: compute.instanceGroupManagers.update
  • Para ver una lista de solicitudes de cambio de tamaño en un MIG: compute.instanceGroupManagers.list
  • Para ver los detalles de una solicitud de cambio de tamaño: compute.instanceGroupManagers.get

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Ver sus solicitudes de cambio de tamaño

Para ver información sobre las solicitudes de cambio de tamaño en un MIG, utilice uno de los siguientes métodos:

Ver una lista de solicitudes de cambio de tamaño en un MIG

Para ver una lista de todas las solicitudes de cambio de tamaño en un MIG, seleccione una de las siguientes opciones:

Para ver una lista de todas las solicitudes de cambio de tamaño en un MIG regional, usa la CLI de gcloud o la API REST. De lo contrario, para ver una lista de todas las solicitudes de cambio de tamaño en un MIG zonal, seleccione cualquiera de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

    Ir a grupos de instancias

  2. En la columna Nombre , haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

    Se abre la página de descripción general del MIG.

  3. En la fila Solicitudes de cambio de tamaño , haga clic Editar solicitudes de cambio de tamaño .

    Aparece el panel de solicitudes de cambio de tamaño . Si la columna Detalles de una solicitud de cambio de tamaño muestra la Cuota excedida o ETA: valor indefinido , entonces su solicitud ha encontrado un error. Puede hacer clic en estos valores para obtener más información.

    Para obtener más información sobre la solución de errores, consulte Ver los detalles de una solicitud de cambio de tamaño en este documento.

nube de gcloud

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de un MIG con solicitudes de cambio de tamaño aceptadas, exitosas, canceladas o fallidas.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

El resultado es similar al siguiente para un MIG zonal:

NAME: rr-01
LOCATION: us-central1-a
SCOPE: zone
RESIZE_BY: 5
STATE: SUCCEEDED
REQUESTED_RUN_DURATION: P1D

NAME: rr-02
LOCATION: us-central1-a
SCOPE: zone
RESIZE_BY: 10
STATE: ACCEPTED
REQUESTED_RUN_DURATION: P3D

DESCANSAR

  • Para ver una lista de solicitudes de cambio de tamaño en un MIG zonal, envíe una solicitud GET utilizando el método instanceGroupManagerResizeRequests.list .

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

  • Para ver una lista de solicitudes de cambio de tamaño en un MIG regional, envíe una solicitud GET utilizando el método beta.regionInstanceGroupManagerResizeRequests.list .

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra un MIG con solicitudes de cambio de tamaño aceptadas, exitosas, canceladas o fallidas.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

  • INSTANCE_GROUP_NAME : el nombre de un MIG existente con solicitudes de cambio de tamaño aceptadas, exitosas, canceladas o fallidas.

El resultado de un MIG zonal es similar al siguiente:

{
  "kind": "compute#instanceGroupManagerResizeRequestList",
  "id": "projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests",
  "items": [
    {
      "kind": "compute#instanceGroupManagerResizeRequest",
      "id": "4247139565532196982",
      "creationTimestamp": "2024-01-08T07:51:53.034-08:00",
      "name": "rr-01",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "count": 5,
      "resizeBy": 5,
      "requestedRunDuration": {
        "seconds": "86400",
        "nanos": 0
      },
      "state": "SUCCEEDED",
      "status": {},
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-01",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982"
    },
    {
      "kind": "compute#instanceGroupManagerResizeRequest",
      "id": "8095866098849525652",
      "creationTimestamp": "2024-01-11T08:04:11.851-08:00",
      "name": "rr-02",
      "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
      "count": 10,
      "resizeBy": 10,
      "requestedRunDuration": {
        "seconds": "259200",
        "nanos": 0
      },
      "state": "ACCEPTED",
      "status": {},
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-02",
      "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/8095866098849525652"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests"
}

Ver los detalles de una solicitud de cambio de tamaño

Puede ver los detalles de una solicitud de cambio de tamaño para revisar su configuración y, opcionalmente, solucionar el problema si la solicitud aún no se ha realizado correctamente.

Si una solicitud de cambio de tamaño aceptada no tiene éxito, puede solucionar el problema marcando el campo status.lastAttempt.error.errors.code en los detalles de la solicitud. Los posibles códigos de error son los siguientes:

  • QUOTA_EXCEEDED : tu proyecto carece de cuota para los recursos solicitados. Para aumentar la cuota de su proyecto, consulte Solicitar una cuota más alta .

  • ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS : los recursos solicitados no están disponibles temporalmente. Compute Engine ha programado la creación de los recursos solicitados y planea crearlos cuando estén disponibles. Si el campo message contiene Expected time is indefinite , Google recomienda cancelar la solicitud y probar una o más de las siguientes opciones:

    • Cree una nueva solicitud de cambio de tamaño con una cantidad menor de máquinas virtuales solicitadas.

    • Utilice un tipo de máquina diferente en el MIG y luego cree una nueva solicitud de cambio de tamaño. Para usar un tipo de máquina diferente, cree una nueva plantilla de instancia y luego use esa plantilla para crear o actualizar un MIG .

    • Cree una solicitud de cambio de tamaño en un MIG ubicado en una región o zona diferente.

Para ver los detalles de una solicitud de cambio de tamaño, seleccione una de las siguientes opciones:

nube de gcloud

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de un MIG.

  • RESIZE_REQUEST_NAME : el nombre de una solicitud de cambio de tamaño cuyos detalles desea ver.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

El resultado es similar al siguiente para un MIG zonal:

creationTimestamp: '2024-09-23T02:27:09.575-07:00'
id: '6386622402379156098'
kind: compute#instanceGroupManagerResizeRequest
name: example-request
requestedRunDuration:
  nanos: 0
  seconds: '86400'
resizeBy: 10
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request
selfLinkWithId: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098
state: ACCEPTED
status:
  lastAttempt:
    error:
      errors:
      - code: QUOTA_EXCEEDED
        message: Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1.
      - code: ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
        message: There are currently not enough resources available to fulfill the request. Expected time is indefinite.
        - errorDetails:
          - errorInfo:
            - metadatas:
              - estimatedAvailabilityTime: '9999-12-31T23:59:59.999999999Z'
zone: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a

DESCANSAR

  • Para ver los detalles de una solicitud de cambio de tamaño en un MIG zonal, envíe una solicitud GET mediante el método instanceGroupManagerResizeRequests.get . 

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

  • Para ver los detalles de una solicitud de cambio de tamaño en un MIG regional, envíe una solicitud GET utilizando el método beta.regionInstanceGroupManagerResizeRequests.get . 

    GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra el MIG zonal.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

  • INSTANCE_GROUP_NAME : el nombre de un MIG donde se encuentra la solicitud de cambio de tamaño.

  • RESIZE_REQUEST_NAME : el nombre de una solicitud de cambio de tamaño existente cuyos detalles desea ver.

El resultado es similar al siguiente: 

{
  "kind": "compute#instanceGroupManagerResizeRequest",
  "id": "6386622402379156098",
  "creationTimestamp": "2024-09-23T02:27:09.575-07:00",
  "name": "example-request",
  "zone": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a",
  "resizeBy": 10,
  "requestedRunDuration": {
    "seconds": "86400",
    "nanos": 0
  },
  "state": "SUCCEEDED",
  "status": {
    "lastAttempt": {
      "error": {
        "errors": [
          {
            "code": "QUOTA_EXCEEDED",
            "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1."
          },
          {
            "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS",
            "message": "There are currently not enough resources available to fulfill the request. Expected time is indefinite.",
            "errorDetails": [
              {
                "errorInfo":{
                  "metadatas":{
                    "estimatedAvailabilityTime": "9999-12-31T23:59:59.999999999Z"
                  }
                }
              }
            ]
          }
        ]
      }
    }
  },
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request",
  "selfLinkWithId": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/6386622402379156098"
}

Cancelar solicitudes de cambio de tamaño en un MIG

Puede cancelar las solicitudes de cambio de tamaño en un MIG para evitar que el MIG intente crear la cantidad solicitada de VM. Solo puede cancelar las solicitudes de cambio de tamaño aceptadas ( ACCEPTED ). Después de cancelar una solicitud de cambio de tamaño, puedes eliminarla o dejar que Compute Engine la elimine automáticamente después de 14 días.

Para cancelar varias solicitudes de cambio de tamaño simultáneamente, use la consola de Google Cloud o la CLI de Google Cloud. De lo contrario, para cancelar una única solicitud de cambio de tamaño, seleccione cualquiera de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

    Ir a grupos de instancias

  2. En la columna Nombre , haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

    Se abre la página de descripción general del MIG.

  3. En la fila Solicitudes de cambio de tamaño , haga clic Editar solicitudes de cambio de tamaño .

    Aparece el panel de solicitudes de cambio de tamaño .

  4. Seleccione las solicitudes de cambio de tamaño para cancelar.

  5. Haga clic en Cancelar y luego haga clic en Confirmar .

nube de gcloud

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de un MIG con solicitudes de cambio de tamaño aceptadas.

  • RESIZE_REQUEST_NAMES : una lista separada por comas de nombres de solicitudes de cambio de tamaño aceptadas en el MIG zonal especificado. Por ejemplo, especifique request-1,request-2 .

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

DESCANSAR

  • Para cancelar una solicitud de cambio de tamaño en un MIG zonal, envíe una solicitud POST utilizando el método instanceGroupManagerResizeRequests.cancel . 

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

  • Para cancelar una solicitud de cambio de tamaño en un MIG regional, envíe una solicitud POST utilizando el método beta.regionInstanceGroupManagerResizeRequests.cancel . 

    POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra un MIG zonal existente con una solicitud de cambio de tamaño aceptada.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

  • INSTANCE_GROUP_NAME : el nombre del MIG.

  • RESIZE_REQUEST_NAME : el nombre de la solicitud de cambio de tamaño a cancelar.

Eliminar solicitudes de cambio de tamaño en un MIG

De forma predeterminada, Compute Engine elimina automáticamente una solicitud de cambio de tamaño 14 días después de configurar el estado de la solicitud en uno de los siguientes:

  • Exitoso ( SUCCEEDED )

  • Fallido ( FAILED )

  • Cancelado ( CANCELLED )

Sin embargo, puede eliminar inmediatamente una solicitud de cambio de tamaño antes de esa fecha, como se describe en esta sección.

Eliminar una solicitud de cambio de tamaño exitosa no elimina las máquinas virtuales creadas a través de la solicitud. El MIG elimina automáticamente esas máquinas virtuales al final de la duración de ejecución solicitada. Sin embargo, si su trabajo terminó de ejecutarse y ya no necesita las máquinas virtuales, elimínelas .

Para eliminar varias solicitudes de cambio de tamaño simultáneamente, use la consola de Google Cloud o la CLI de gcloud. De lo contrario, para eliminar una única solicitud de cambio de tamaño, seleccione cualquiera de las siguientes opciones:

Consola

  1. En la consola de Google Cloud, vaya a la página de grupos de instancias .

    Ir a grupos de instancias

  2. En la columna Nombre , haga clic en el nombre del MIG que contiene solicitudes de cambio de tamaño.

    Se abre la página de descripción general del MIG.

  3. En la fila Solicitudes de cambio de tamaño , haga clic Editar solicitudes de cambio de tamaño .

    Aparece el panel de solicitudes de cambio de tamaño .

  4. Seleccione las solicitudes de cambio de tamaño para eliminar.

  5. Haga clic en Eliminar y luego haga clic en Confirmar .

nube de gcloud

Reemplace lo siguiente:

  • INSTANCE_GROUP_NAME : el nombre de un MIG con solicitudes de cambio de tamaño exitosas, fallidas o canceladas.

  • RESIZE_REQUEST_NAMES : una lista separada por comas de nombres de solicitudes de cambio de tamaño para eliminar en el MIG. Por ejemplo, especifique request-1,request-2 .

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

DESCANSAR

  • Para eliminar una solicitud de cambio de tamaño en un MIG zonal, envíe una solicitud DELETE utilizando el método instanceGroupManagerResizeRequests.delete . 

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

  • Para eliminar una solicitud de cambio de tamaño en un MIG regional, envíe una solicitud DELETE utilizando el método beta.regionInstanceGroupManagerResizeRequests.delete . 

    DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto donde se encuentra un MIG zonal existente con solicitudes de cambio de tamaño exitosas, fallidas o canceladas.

  • ZONE : la zona donde se encuentra el MIG.

  • REGION : la región donde se encuentra el MIG.

  • INSTANCE_GROUP_NAME : el nombre del MIG.

  • RESIZE_REQUEST_NAME : el nombre de la solicitud de cambio de tamaño que se va a eliminar.

¿Qué sigue?