Se usó la API de Cloud Translation para traducir esta página.

Visualizar cancela o borra solicitudes de cambio de tamaño en un MIG

En este documento, se 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, puedes realizar una o más de las siguientes acciones:

Visualiza las solicitudes de cambio de tamaño para supervisar sus estados o solucionar problemas.
Cancela las solicitudes de cambio de tamaño para evitar que el MIG cree la cantidad solicitada de instancias de máquina virtual (VM).
Borra las solicitudes de cambio de tamaño cuando ya no las necesites.

Antes de comenzar

Si aún no lo hiciste, consulta cómo funcionan las solicitudes de cambio de tamaño.
Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API 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:

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. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Roles obligatorios

A fin de obtener los permisos que necesitas para ver, cancelar o borrar solicitudes de cambio de tamaño en un MIG, pídele a tu administrador que te otorgue el permiso Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) rol de IAM en el 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 ver, cancelar o borrar las solicitudes de cambio de tamaño en un MIG. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

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

Para cancelar o borrar solicitudes de cambio de tamaño en un MIG, haz lo siguiente: compute.instanceGroupManagers.update
Para ver una lista de las solicitudes de cambio de tamaño en un MIG, sigue estos pasos: compute.instanceGroupManagers.list
Para ver los detalles de una solicitud de cambio de tamaño, haz lo siguiente: compute.instanceGroupManagers.get

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

Consulta tus solicitudes de cambio de tamaño

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

Para obtener una descripción general de todas las solicitudes en un MIG, consulta una lista de solicitudes de cambio de tamaño en un MIG.
Para obtener todos los detalles de una solicitud específica, consulta los detalles de una solicitud de cambio de tamaño.

Visualiza 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, selecciona una de las siguientes opciones:

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

Console

En la consola de Google Cloud, ve a la página Grupos de instancias.

Ir a Grupos de instancias
En la columna Nombre, haz clic en el nombre del MIG que contiene las solicitudes de cambio de tamaño.

Se abrirá la página de resumen del MIG.
En la fila Solicitud de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño. Si la columna Detalles de una solicitud de cambio de tamaño muestra el valor Cuota excedida o ETA: indefinido, significa que tu solicitud encontró un error. Puedes hacer clic en estos valores para obtener más información.

Para obtener más información sobre la solución de problemas, consulta Cómo ver los detalles de una solicitud de cambio de tamaño en este documento.

gcloud

Para ver una lista de solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests list.
```
gcloud compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --zone=ZONE
```
Para ver una lista de solicitudes de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests list.
```
gcloud beta compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --region=REGION
```

Reemplaza lo siguiente:

INSTANCE_GROUP_NAME: El nombre de un MIG con solicitudes de cambio de tamaño aceptadas, correctas, canceladas o con errores.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que 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

REST

Para ver una lista de solicitudes de cambio de tamaño en un MIG zonal, envía una solicitud GET con 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ía una solicitud GET con el método beta.regionInstanceGroupManagerResizeRequests.list.
```
GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/regionInstanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
```

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto en el que se encuentra un MIG con solicitudes de cambio de tamaño aceptadas, correctas, canceladas o con errores.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: El nombre de un MIG zonal existente con solicitudes de cambio de tamaño aceptadas, correctas, canceladas o con errores.

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"
}

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

Puedes ver los detalles de una solicitud de cambio de tamaño para revisar su configuración y, de manera opcional, solucionar problemas si la solicitud aún no se realizó de forma correcta.

Si una solicitud de cambio de tamaño aceptada no se realiza correctamente, puedes solucionar el problema verificando 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 no tiene la cuota de los recursos solicitados. Para aumentar la cuota de tu proyecto, consulta Solicita una cuota más alta.
ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS: Los recursos solicitados no están disponibles por el momento. Compute Engine programó 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:
- Crea una nueva solicitud de cambio de tamaño con una cantidad menor de VMs solicitadas.
- Usa un tipo de máquina diferente en el MIG y, luego, crea una solicitud de cambio de tamaño nueva. Para usar un tipo de máquina diferente, crea una plantilla de instancias nueva y, luego, usa esa plantilla para crear o actualizar un MIG.
- Crea 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, selecciona una de las siguientes opciones:

gcloud

Para ver los detalles de una solicitud de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests describe.

gcloud compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --zone=ZONE

Para ver los detalles de una solicitud de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests describe.

gcloud beta compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --region=REGION

Reemplaza lo siguiente:

INSTANCE_GROUP_NAME: Es el nombre de un MIG.
RESIZE_REQUEST_NAME: Es el nombre de una solicitud de cambio de tamaño cuyos detalles deseas ver.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que 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

REST

Para ver los detalles de una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud GET con 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ía una solicitud GET con 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

Reemplaza lo siguiente:

PROJECT_ID: el ID del proyecto en el que se encuentra el MIG zonal.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: Es el nombre de un MIG en el que se encuentra la solicitud de cambio de tamaño.
RESIZE_REQUEST_NAME: Es el nombre de una solicitud de cambio de tamaño existente de la que deseas ver los detalles.

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"
}

Cancela las solicitudes de cambio de tamaño en un MIG

Puedes cancelar las solicitudes de cambio de tamaño en un MIG para evitar que este intente crear la cantidad solicitada de VMs. Solo puedes cancelar las solicitudes de cambio de tamaño aceptadas (ACCEPTED). Después de cancelar una solicitud de cambio de tamaño, puedes borrarla o permitir que Compute Engine la borre de forma automática después de 14 días.

Para cancelar varias solicitudes de cambio de tamaño de forma simultánea, usa la console de Google Cloud o Google Cloud CLI. De lo contrario, para cancelar una sola solicitud de cambio de tamaño, selecciona una de las siguientes opciones:

Console

En la consola de Google Cloud, ve a la página Grupos de instancias.

Ir a Grupos de instancias
En la columna Nombre, haz clic en el nombre del MIG que contiene las solicitudes de cambio de tamaño.

Se abrirá la página de resumen del MIG.
En la fila Solicitud de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño.
Selecciona las solicitudes de cambio de tamaño que quieres cancelar.
Haz clic en Cancelar y, luego, en Confirmar.

gcloud

Para cancelar las solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests cancel.

gcloud compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Para cancelar las solicitudes de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests cancel.

gcloud beta compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --region=REGION

Reemplaza 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 los nombres de las solicitudes de cambio de tamaño aceptadas en el MIG zonal especificado. Por ejemplo, especifica request-1,request-2.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

REST

Para cancelar una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud POST con 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ía una solicitud POST con 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

Reemplaza lo siguiente:

PROJECT_ID: el ID del proyecto en el que se encuentra un MIG zonal existente con una solicitud de cambio de tamaño aceptada.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: Es el nombre del MIG.
RESIZE_REQUEST_NAME: el nombre de la solicitud de cambio de tamaño que se cancelará.

Borra las solicitudes de cambio de tamaño en un MIG

De forma predeterminada, Compute Engine borra de forma automática una solicitud de cambio de tamaño 14 días después de configurar el estado de la solicitud en una de las siguientes opciones:

Correcta (SUCCEEDED)
Con errores (FAILED)
Cancelados (CANCELLED)

Sin embargo, puedes borrar de inmediato una solicitud de cambio de tamaño antes de esa fecha, como se describe en esta sección.

Borrar una solicitud de cambio de tamaño correcta no borra las VMs creadas a través de la solicitud. El MIG borra de forma automática esas VMs al final de la duración de ejecución solicitada. Sin embargo, si tu trabajo terminó de ejecutarse y ya no necesitas las VMs, borra las VMs.

Para borrar varias solicitudes de cambio de tamaño de forma simultánea, usa la consola de Google Cloud o gcloud CLI. De lo contrario, para borrar una sola solicitud de cambio de tamaño, selecciona cualquiera de las siguientes opciones:

Console

En la consola de Google Cloud, ve a la página Grupos de instancias.

Ir a Grupos de instancias
En la columna Nombre, haz clic en el nombre del MIG que contiene las solicitudes de cambio de tamaño.

Se abrirá la página de resumen del MIG.
En la fila Solicitud de cambio de tamaño, haz clic en Editar solicitudes de cambio de tamaño.

Aparecerá el panel Solicitudes de cambio de tamaño.
Selecciona las solicitudes de cambio de tamaño que quieres borrar.
Haz clic en Borrar y, luego, en Confirmar.

gcloud

Para borrar las solicitudes de cambio de tamaño en un MIG zonal, usa el comando instance-groups managed resize-requests delete.

gcloud compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Para borrar las solicitudes de cambio de tamaño en un MIG regional, usa el comando beta instance-groups managed resize-requests delete.

gcloud beta compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --region=REGION

Reemplaza lo siguiente:

INSTANCE_GROUP_NAME: El nombre de un MIG con solicitudes de cambio de tamaño correctas, con errores o canceladas.
RESIZE_REQUEST_NAMES: una lista separada por comas de los nombres de las solicitudes de cambio de tamaño que se borrarán en el MIG. Por ejemplo, especifica request-1,request-2.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.

REST

Para borrar una solicitud de cambio de tamaño en un MIG zonal, envía una solicitud DELETE con 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 borrar una solicitud de cambio de tamaño en un MIG regional, envía una solicitud DELETE con 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

Reemplaza lo siguiente:

PROJECT_ID: el ID del proyecto en el que se encuentra un MIG zonal existente con solicitudes de cambio de tamaño correctas, con errores o canceladas.
ZONE: La zona en la que se encuentra el MIG.
REGION: la región en la que se encuentra el MIG.
INSTANCE_GROUP_NAME: Es el nombre del MIG.
RESIZE_REQUEST_NAME: el nombre de la solicitud de cambio de tamaño que se borrará.

¿Qué sigue?

Obtén información para ver información sobre las VMs administradas dentro de un MIG.